home *** CD-ROM | disk | FTP | other *** search
/ YPA: Your Privacy Assured / YPA.ISO / other_goodies / utilities / iu-14-as225.lha / INetUtils-1.4 / docs / SMTPexpand.man < prev    next >
Text File  |  1994-02-26  |  3KB  |  107 lines
  1. SMTPexpand                                SMTPexpand
  2.  
  3. NAME
  4.  
  5.     SMTPexpand - display expanded aliases/addresses
  6.  
  7.  
  8. SYNOPSIS
  9.  
  10.     SMTPexpand address1 .... addressn
  11.  
  12.  
  13. DESCRIPTION
  14.  
  15.     SMTPexpand takes addresses specified on the command line, and
  16.     expands them based on the contents of INet:DB/Aliases (or
  17.     UULib:Aliases if the first file does not exist).
  18.  
  19.     SMTPexpand will then print out two lists for each address. The
  20.     first consists of what would be placed on the To: header for
  21.     the specified address, and the second is the list of destination
  22.     addresses that email would be shipped to.
  23.  
  24.     Note that the two may not agree. Use of the '::' operator when
  25.     defining an alias indicates that all of its subordinate items
  26.     are not to appear on the header -- the alias itself is. This is
  27.     most often useful for listservers and mailing lists.
  28.  
  29.  
  30. PRAGMATICS
  31.  
  32.     Each line in INet:DB/Aliases may be either blank, have a '#' as the
  33.     first character to indicate a comment, or begin an alias. An alias
  34.     consists of a name, colon, and list of items. For example:
  35.  
  36.            comiclovers:    charlie, ben, lucy, james
  37.  
  38.     Multi-line aliases may be specified by a comma at the end of each line
  39.     to be continued. For example:
  40.  
  41.            comiclovers:    charlie, ben,
  42.                    lucy, james
  43.  
  44.     Note that the last line has no comma.  Each item in an alias may be:
  45.  
  46.         1    user          a local user name
  47.  
  48.         2    \user          forces a local user name in an alias
  49.  
  50.         3    alias          another alias
  51.  
  52.         4    path          some path
  53.  
  54.         5    >file          append the mail item to some file
  55.  
  56.         6    <file          load a further list of destinations from a
  57.                       file (one item per line)
  58.  
  59.         7    |command          pipe mail item to a command with optional args
  60.  
  61.         8    "|command args"
  62.  
  63.     For example, if incoming mail to "pm" should be posted to the mailbox
  64.     for "pm" and automatically appended to an archive file:
  65.  
  66.         pm: \pm,>uumail:mbox
  67.  
  68.     Note the use of the '\' to prevent an alias loop.
  69.  
  70.     Items may point to other aliases ("pm" is already an alias):
  71.  
  72.         comiclovers:    pm, fred
  73.  
  74.     Mail may be piped to a command, such as an automated vacation-response
  75.     program:
  76.  
  77.         pm: \pm, >uumail:archive, |vacation
  78.  
  79.     Aliases are expanded by default on the outgoing header lines. You
  80.     can disable alias expansion by using a double colon, like this:
  81.  
  82.         huge-mailing-list:: fubar@red, d, asdflk
  83.  
  84.     Using the double colon will cause the To: field to only contain the
  85.     name of the alias, 'huge-mailing-list'.  This is extremely useful for
  86.     mailing lists.
  87.  
  88.     A comment is denoted by a '#'.  Also, any text that occurs after the
  89.     first space in a comma delimited field will be ignored.  A line that
  90.     begins with a '#' is ignored (as if it did not exist).  For example:
  91.  
  92.     test:    t1,
  93.         t2 (This is T2),
  94.         t3, # fubar
  95.      #    t4,
  96.         t5
  97.  
  98.     The above alias expands to: t1, t2, t3, t5
  99.  
  100.     If the file INet:DB/Aliases cannot be found, SMTPexpand (as well as
  101.     SMTPpost and SMTPd) will attempt to open UULib:Aliases.
  102.  
  103.  
  104. SEE ALSO
  105.  
  106.     SMTPpost.man
  107.