glenda.party
term% ls -F
term% cat index.txt
MARSHAL(1)                  General Commands Manual                 MARSHAL(1)



NAME
       marshal - formatting and sending mail

SYNOPSIS
       upas/marshal  [  -[aA]  attachment  ] [ -C copyaddr ] [ -B copyaddr ] [
       -Fr#xn ] [ -p[es] ] [ -R reply-msg ] [ -s subject ] [ -t mime-type ]  [
       -8 | mailaddr ...  ]

DESCRIPTION
       Marshal builds a mail message from standard input and passes it, if the
       body is non-empty, for  transmission  or  delivery  to  /mail/box/user‐
       name/pipefrom  if  it exists, otherwise to /bin/upas/send.  The message
       format is both RFC 822 and MIME conformant, so  marshal  adds  any  re‐
       quired  headers not already in the message, prefixed by the contents of
       /mail/box/username/headers.  This allows the addition of personal head‐
       ers  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 recipi‐
       ents.

       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 ex‐
              plicitly 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 di‐
              recting any mail reader to display the attachment  (if  it  can)
              when the mail message is read.

       -Ccopyaddr
              or  -Bcopyaddr  adds a Cc: or Bcc: header with copyaddr and also
              adds copyaddr as a recipient.

       -F     file the message

       -n     intentionally no standard input

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

       -Rreplymsg
              tells marshal what message this one is in reply to.  Replymsg is
              an upasfs(4) 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  re‐
              plymsg  environment variable.  Thus, pipefrom can alter the mes‐
              sage to somehow match the reply to the message  it  is  replying
              to.

       -ssubject
              adds  a  Subject: header line to the message if one does not al‐
              ready exist.

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

       -ps    pgp sign the message

       -pe    pgp encrypt the message

       -8     reads recipients ( To: Cc: and Bcc: ) from RFC 822 header of the
              message

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

       Marshal uses the login name as the reply address.  This can be  overri‐
       den  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

       Marshal interprets file attachment headers Attach: and Include:  as  if
       the -A or -a options would have been given.

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)



                                                                    MARSHAL(1)