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 ] [ -nrx# ] [ -R reply-
       msg ] [ -s subject ] [ -t mime-type ] [ 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
              adds a Cc: header with copyaddr and also adds copyaddr as a  re‐
              cipient.

       -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.

       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

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)