NAME

marshal − formatting and sending mail

SYNOPSIS

­upas/marshal [ ­-t ­mime-type ] [ ­-[aA] ­attachment ] [ ­-s ­subject ] [ ­-C ­copyaddr ] [ ­-R ­reply-msg [ ­-nrx# ] [ ­mailaddr ...  ]

DESCRIPTION

­Marshal builds a mail message from standard input and passes it for transmission or delivery to /mail/box/username/pipefrom if it exists, otherwise to /bin/upas/send.  The message format is both RFC 822 and MIME conformant, so ­marshal adds any required headers not already in the message, prefixed by the contents of /mail/box/username/headers.  This allows the addition of personal headers like ­From: lines with a full name or a different return address.  Command line options direct marshal to add a subject line and append attachments.  The arguments to ­marshal are the addresses of the recipients. 

When running in a rio(1) window, ­marshal automatically puts the window into hold mode (see rio(1)); this means that the message can be edited freely, because nothing will be sent to ­marshal until the ESC key is hit to exit hold mode. 

The options are:

-afile directs ­marshal to append ­file as a mime attachment.  Unless explicitly specified by the ­-t option, the type of the attachment is determined by running the file(1) command.

-Afile is like ­-a but the message disposition is marked as ­inline directing any mail reader to display the attachment (if it can) when the mail message is read. 

-ttype sets the content type for the attachments from all subsequent ­-a and ­-A options. 

-ssubject
adds a ­Subject: header line to the message if one does not already exist. 

-Ccopyaddr
adds a ­Cc: header with ­copyaddr and also adds ­copyaddr as a recipient. 

-Rreplymsg
tells marshal what message this one is in reply to. ­Replymsg is an upas/fs(1) directory containing the message. ­Marshal uses any message id in this message in its ­In-Reply-To field.  It also passes the directory to /mail/box/username/pipefrom in the ­replymsg environment variable.  Thus, ­pipefrom can alter the message to somehow match the reply to the message it is replying to. 

-n intentionally no standard input

­-#xr are all passed as command line options to the ­send that ­marshal invokes. 

­Marshal also expands any user mail aliases contained in /mail/box/username/names. The format of the alias file is the same as that for system aliases, see aliasmail(8).

­Marshal uses the login name as the reply address.  This can be overriden using the environment variable upasname.  Its value will become both the envelope and ­From: mailbox name.  For example:

upasname=natasha@kremvax.com upas/mail boris@squirrel.com

FILES

­/mail/box/∗/dead.letter

SOURCE

­/sys/src/cmd/upas/marshal

SEE ALSO

aliasmail(8), faces(1), filter(1), mail(1), mlmgr(1), nedmail(1), qer(8), rewrite(6), send(8), smtp(8), upasfs(4)
 

Plan 9  —  March 22, 2004