Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
POST(8)			    System Manager's Manual		       POST(8)

       post - deliver a	message

       /usr/local/libexec/nmh/post [-alias aliasfile] [-filter filterfile]
	    [-nofilter]	[-format | -noformat] [-mime | -nomime]	[-msgid	|
	    -nomsgid] [-messageid localname | random] [-verbose	| -noverbose]
	    [-watch | -nowatch]	[-width	columns] [-mts smtp | sendmail/smtp |
	    sendmail/pipe] [-server servername]	[-port portname/number]
	    [-sasl] [-nosasl] [-saslmaxssf ssf]	[-saslmech mechanism] [-user
	    username] [-tls] [-initialtls] [-notls] file [-version] [-help]

       Post  is	 the  default program called by	send to	deliver	the message in
       file to local and remote	users.	In fact, most of the features  attrib-
       uted to send in its manual page are performed by	post, with send	acting
       as a relatively simple preprocessor.  Thus, it is post which parses the
       various	header	fields,	appends	a "Date:" line,	and interacts with the
       mail transport system.  Post will not normally be  called  directly  by
       the user.

       Post  searches  the  "To:",  "cc:",  "Bcc:",  "Fcc:", and "Resent-xxx:"
       header lines of the specified message for destination addresses,	checks
       these  addresses	 for  validity,	 and  formats them so as to conform to
       ARPAnet Internet	Message	Format protocol, unless	the -noformat flag  is
       set.   This  will  normally  cause "@local-site"	to be appended to each
       local destination address, as well as any local return addresses.   The
       -width  columns	switch can be used to indicate the preferred length of
       the header components that contain addresses.

       If a "Bcc:" field is encountered, its addresses will be used for	deliv-
       ery,  and  the  "Bcc:"  field  will be removed from the message sent to
       sighted recipients.  The	blind recipients will receive an entirely  new
       message	with  a	 minimal  set of headers.  Included in the body	of the
       message will be a copy of the message sent to the  sighted  recipients.
       If -filter filterfile is	specified, then	this copy is filtered (re-for-
       matted) by mhl prior to being sent to  the  blind  recipients.	Alter-
       nately, if the -mime switch is given, then post will use	the MIME rules
       for encapsulation.

       The -alias aliasfile switch can be used to specify  a  file  that  post
       should  take  aliases  from.  More than one file	can be specified, each
       being preceded with -alias.  In any event, the primary  alias  file  is
       read first.

       The  -msgid  switch  indicates  that  a	"Message-ID:"  or "Resent-Mes-
       sage-ID:" field should be added to the header.

       The -messageid switch selects the style used  for  the  part  appearing
       after  the  @ in	"Message-ID:", "Resent-Message-ID:", and "Content-ID:"
       header fields.  The two acceptable options are localname	(which is  the
       default),  and  random.	 With  localname,  the local hostname is used.
       With random, a random sequence of characters  is	 used  instead.	  Note
       that  the  -msgid  switch  must	be enabled for this switch to have any

       The -verbose switch indicates that the user should be informed of  each
       step of the posting/filing process.

       The  -watch  switch  indicates  that  the  user would like to watch the
       transport system's handling of the  message  (e.g.,  local  and	"fast"

       Under  normal  circumstances, post uses the "From:" line	in the message
       draft as	the identity of	the originating	mailbox.  A  "From:"  line  is
       required	 in  all  message  draft.   By default the message composition
       utilities such as comp, repl and	 mhmail	 will  automatically  place  a
       "From:" line in the message draft.  There are two ways to override this
       behavior, however.  Note	that  they  apply  equally  to	"Resent-From:"
       lines in	messages sent with dist.

       The  first  way is to supply a "Sender:"	line.  The value of this field
       will be used as the originating mailbox identity	 when  submitting  the
       message	to the mail transport system.  If multiple addresses are given
       in the "From:" line, a "Sender:"	line is	required.   If	an  "Envelope-
       From:"  line  is	 supplied  when	 multiple  addresses  are given	in the
       "From:" line, a "Sender:" header	will be	generated using	the  value  of
       the "Envelope-From:" line, if the "Envelope-From:" line is not blank.

       The second way is to supply a "Envelope-From:" line.  The value of this
       field will be used as the originating mailbox identity when  submitting
       the  message to the mail	transport system.  This	will override both the
       value of	the "From:" line and a "Sender:" line (if  one	is  supplied).
       The  "Envelope-From:"  line  is	allowed	 to have a blank value;	if the
       value is	blank, then the	mail transport system will  be	instructed  to
       not  send  any bounces in response to the message.  Not all mail	trans-
       port systems support this feature.

       The    mail    transport	   system    default	is     provided	    in
       /usr/local/etc/nmh/mts.conf  but	 can  be overriiden here with the -mts

       If nmh is using the SMTP	MTA, the -server and the -port switches	can be
       used  to	override the default mail server (defined by the servers entry
       in /usr/local/etc/nmh/mts.conf ).

       If nmh has been compiled	with  SASL  support,  the  -sasl  and  -nosasl
       switches	 will  enable  and disable the use of SASL authentication with
       the SMTP	MTA.  Depending	on the SASL mechanism used, this  may  require
       an  additional password prompt from the user (but the netrc file	can be
       used to store this password, as	described  in  the  mh-profile(5)  man
       page).	The  -saslmech	switch can be used to select a particular SASL
       mechanism, and the -user	switch can be used to select  a	 authorization
       userid to provide to SASL other than the	default.  The credentials pro-
       file entry in the mh-profile(5) man page	describes the ways to supply a
       username	and password.

       If  SASL	 authentication	is successful, nmh will	attempt	to negotiate a
       security	layer for session encryption.  Encrypted data is labelled with
       `(sasl-encrypted)'  and `(sasl-decrypted)' when viewing the SMTP	trans-
       action with the -snoop switch.  The -saslmaxssf switch can be  used  to
       select  the  maximum value of the Security Strength Factor.  This is an
       integer value and the exact meaning of this value depends on the	under-
       lying SASL mechanism.  A	value of 0 disables encryption.

       If  nmh	has  been  compiled with TLS support, the -tls and -initialtls
       switches	will require the negotiation of	TLS  when  connecting  to  the
       SMTP  MTA.   The	 -tls  switch will negotiate TLS as part of the	normal
       SMTP protocol using the STARTTLS	command.  The -initialtls will negoti-
       ate  TLS	 immediately  after the	connection has taken place, before any
       SMTP commands are sent or received.  Encrypted data  is	labelled  with
       `(tls-encrypted)'  and  `(tls-decrypted)' when viewing the SMTP transc-
       tion with the -snoop  switch.   The  -notls  switch  will  disable  all
       attempts	to negotiate TLS.

       /usr/local/etc/nmh/mts.conf	    nmh	mts configuration file
       /usr/local/etc/nmh/MailAliases	    global nmh alias file
       /usr/local/bin/refile		    Program to process Fcc:s
       /usr/local/libexec/nmh/mhl	    Program to process Bcc:s

       post does NOT consult the user's	.mh_profile

       mhmail(1),  send(1),  mh-mail(5),  mh-alias(5),	mh-profile(5), mh-tai-

       Standard	for the	Format of ARPA Internet	Text Messages (RFC 822)

       `-alias'	defaults to /usr/local/etc/nmh/MailAliases
       `-messageid localname'
       `-width 72'


       "Reply-To:" fields are allowed to have groups in	them according to  the
       RFC 822 specification, but post won't let you use them.

nmh-1.6				April 14, 2013			       POST(8)


Want to link to this manual page? Use this URL:

home | help