add a simple SMTP client

ok gilles@

1 files changed, 97 insertions, 0 deletions

diff --git a/usr.sbin/smtpd/smtp.1 b/usr.sbin/smtpd/smtp.1
new file mode 100644
index 00000000000..b737b915134
--- /dev/null
+++ b/usr.sbin/smtpd/smtp.1
@@ -0,0 +1,97 @@
+.\"	$OpenBSD: smtp.1,v 1.1 2018/04/26 13:57:13 eric Exp $
+.\"
+.\" Copyright (c) 2018, Eric Faurot <eric@openbsd.org>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: April 26 2018 $
+.Dt SMTP 8
+.Os
+.Sh NAME
+.Nm smtp
+.Nd Simple Mail Transfer Protocol client
+.Sh SYNOPSIS
+.Nm
+.Op Fl Chnv
+.Op Fl F Ar from
+.Op Fl H Ar helo
+.Op Fl s Ar server
+.Op rcpt
+.Ar ...
+.Sh DESCRIPTION
+The
+.Nm
+utility is a Simple Mail Transfer Protocol
+.Pq SMTP
+client which can be used to run a SMTP transaction against a SMTP server.
+.Pp
+By default,
+.Nm
+reads the mail content from the standard input, establishes a SMTP session,
+and runs a SMTP transaction for all the specified recipients.
+The content is sent unaltered as mail data.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl C
+Do not require server certificate to be valid.
+.It Fl F Ar from
+Set the return-path (MAIL FROM) for the SMTP transaction.
+Default to the current username.
+.It Fl H Ar helo
+Define the hostname to advertise (HELO) when establishing the SMTP session.
+.It Fl h
+Display version and usage.
+.It Fl n
+Do not actually execute a transaction,
+just try to establish a SMTP session and quit.
+When this option is given, no message is read from the standard input.
+.It Fl s Ar server
+Specify the server to connect to and connection parameters.
+The format is
+.Sm off
+.Pf
+.Ar proto :// Op Ar user : pass No @
+.Ar host Op : Ar port
+.Sm on .
+The following protocols are available:
+.Pp
+.Bl -tag -width Ds
+.It smtp
+Normal SMTP session, with opportunistic STARTTLS.
+.It smtp+tls
+Normal SMTP session with mandatory STARTTLS.
+.It smtp+notls
+Plain text SMTP session without TLS.
+.It lmtp
+LMTP session with opportunistic STARTTLS.
+.It lmtp+tls
+LMTP session with mandatory STARTTLS.
+.It lmtp+notls
+Plain text LMTP session.
+.It smtps
+SMTP session with forced TLS on connection.
+.El
+.Pp
+Defaults to "smtp://localhost:25".
+.It Fl v
+Be more verbose.
+This option can be specified multiple times.
+.El
+.Sh SEE ALSO
+.Xr smtpd 8
+.Sh HISTORY
+The
+.Nm
+program first appeared in
+.Ox X.X .