home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / TOP / USR / MAN / Smail.man < prev    next >
Text File  |  2009-11-06  |  11KB  |  265 lines
  1.      SMAIL(8)              XENIX System V              SMAIL(8)
  2.  
  3.  
  4.  
  5.      NAME
  6.       smail, rmail - UUCP mailer with routing
  7.  
  8.      SYNOPSIS
  9.       smail    [ options ] address ...
  10.       rmail    [ options ] address ...
  11.  
  12.      DESCRIPTION
  13.       The smail/rmail program replaces /bin/rmail(1) to become the
  14.       UUCP mail transport mechanism.  They are links to the    same
  15.       executable.  rmail receives mail from    UUCP, smail introduces
  16.       mail into UUCP.
  17.  
  18.       smail/rmail can work with or without sendmail(8), or another
  19.       intelligent mail system.  For    hosts with just    /bin/mail(1),
  20.       smail/rmail subsumes some of the functions of    sendmail, and
  21.       hands    only local mail    to /bin/mail. For hosts    with sendmail,
  22.       smail/rmail can act as UUCP front and    back ends to sendmail,
  23.       allowing sendmail to process all mail    through    the host.  As
  24.       distributed, 'bang' mail that    is not bound for a local
  25.       recipient will be passed directly to uux without calling
  26.       sendmail.
  27.  
  28.       To varying degrees, smail/rmail automatically    routes the
  29.       addresses it processes.  smail/rmail most often routes
  30.       domain style addresses (i.e. user@domain), producing a UUCP
  31.       path (i.e. host!address) or a    local address (i.e. user), but
  32.       it can also reroute explicit UUCP paths.
  33.  
  34.      OPTIONS
  35.       -A   Print the resolved addresses.  Don't collect a message
  36.            or invoke a mailer.
  37.  
  38.       -d   Be verbose and don't invoke other mailers.
  39.  
  40.       -v   Be verbose, but still invoke other mailers.
  41.  
  42.       -h hostname
  43.            Set hostname.  The default is configuration dependent,
  44.            but usually provided by a system    call such as
  45.            gethostname(2) or uname(2).
  46.  
  47.       -H hostdomain
  48.            set hostdomain.    The default is configuration
  49.            dependent.
  50.  
  51.       -F address
  52.            use address on the From:    line in    locally    generated
  53.            mail.
  54.  
  55.       -p pathfile
  56.            Set path    database file name if not /usr/lib/uucp/paths.
  57.  
  58.       -a aliasfile
  59.            For sites without sendmail, set alias database file
  60.            name if not in the place    defined    at compile time    (see
  61.            ALIASES in defs.h).  This is usually /usr/lib/aliases
  62.  
  63.       -n namelist
  64.            smail supports another type of aliasing intended    for
  65.            full name resolution using a sorted file, namelist, of
  66.            name/address pairs.  This allows    mail to
  67.            George.P.Burdell@gatech.edu to be delivered
  68.            appropriately.  These aliases are by their nature very
  69.            simple since they are not composed of long lists    of
  70.            recipients for each alias.  They    are also numerous,
  71.            since mail to George.P.Burdell may be addressed to
  72.            Burdell,    G.Burdell, George.Burdell, P.Burdell,
  73.            G.P.Burdell, or George.P.Burdell.  This simpler form of
  74.            aliasing    uses the same fast searching algorithm that is
  75.            used for    the paths file,    so it keeps resolution time
  76.            manageable.
  77.  
  78.       -q number
  79.            Take number as the queueing threshold.  When routing
  80.            mail ( -r, -R, or domain    addressed mail ) to a given
  81.            host, if    the cost listed    in the paths file is less than
  82.            the queueing threshold, then the    mail will be sent
  83.            immediately.  This overrides the    default    threshold (see
  84.            QUEUECOST in defs.h) of DEDICATED+LOW.
  85.  
  86.       -m number
  87.            At most number jobs will    be handed to uux for immediate
  88.            delivery    by a single invocation of smail    (see
  89.            MAXNOQUEUE in defs.h).
  90.  
  91.       -u uuxflags
  92.            Use uuxflags as the flags passed    to uux for remote
  93.            mail.  This overrides any of the    default    values and
  94.            other queueing strategies.
  95.  
  96.       -c   Consult the paths file for the cost of the path even
  97.            when not    routing    the mail.  This    makes it possible to
  98.            use the cost information    when sending pure UUCP path
  99.            mail without rerouting it.
  100.  
  101.       -r   Don't route the first component of a UUCP path (host!address)
  102.            in addition to routing domain addresses (user@domain).
  103.  
  104.       -R   Reroute UUCP paths, trying successively larger
  105.            righthand substrings of a path until a component    is
  106.            recognized.
  107.  
  108.       -l   Instead of routing a domain address, send it to the
  109.            local mailer for    processing.  Normally, only local
  110.            addresses go to the local mailer.
  111.  
  112.       -L   Send all    addresses to the local mailer for processing,
  113.            including UUCP paths.
  114.  
  115.       Most of the flags are    also compile time options, since uux
  116.       does not normally invoke rmail with the desired flags.
  117.       smail    resets any preset -l or    -L flags.  -l flag causes
  118.       rmail    to send    all domain addresses through the local mailer,
  119.       to process addresses for non UUCP domains.  The -L flag
  120.       causes rmail to send even explicit UUCP paths    through    the
  121.       local    mailer,    presumably to make use of other    transport
  122.       mechanisms.  In both cases, rmail defers any routing until
  123.       smail    gets hold it.
  124.  
  125.      ADDRESSES
  126.       smail/rmail understands "user@domain"    to be a    domain
  127.       address, "host!address" to be    a UUCP path, and anything else
  128.       to be    a local    address.
  129.  
  130.       Because hostile rmail's unpredictably    interpret mixed
  131.       UUCP/domain addresses, smail/rmail understands "domain!user"
  132.       to be    a domain address, and generates    "path!domain!user"
  133.       when mailing to a cognate smail/rmail    host.  To distinguish
  134.       domain "domain!user" from UUCP "host!address", "domain"
  135.       contains at least one    (1) period.  Unlike the    old
  136.       /bin/rmail, smail/rmail gives    precedence to @    over ! when
  137.       parsing mixed    addresses, thus    a!b@c is parsed    as (a!b)@c,
  138.       rather than a!(b@c).
  139.  
  140.      ROUTING
  141.       Because smail/rmail is the UUCP transport mechanism, it can
  142.       only effect delivery on UUCP paths and local addresses;
  143.       domain addresses require resolution into UUCP    paths or local
  144.       addresses. To    resolve    a domain address, smail/rmail finds a
  145.       route    to the most specific part of the domain    specification
  146.       listed in the    routing    table.    Two degrees of resolution can
  147.       occur:
  148.  
  149.            Full resolution:    smail/rmail finds a route for the
  150.            entire domain specification, and    tacks the user
  151.            specification onto the end of the UUCP path.  The
  152.            address can also    fully resolve to a local address (the
  153.            UUCP path is null).
  154.  
  155.            Partial resolution: smail/rmail finds a route for only
  156.            righthand part of the domain specification, so it tacks
  157.            the complete address (in    the form domain!user) onto the
  158.            end of the UUCP path.  Since this syntax    is not widely
  159.            understood, UUCP    gateways listed    in the path database
  160.            must install new    UUCP software, either smail/rmail or
  161.            new sendmail configuration files    (or both).
  162.  
  163.       It is    an error if a partially    resolved address routes    to the
  164.       local    host (a    null UUCP path), since according to the
  165.       routing table, the local host    is responsible for resolving
  166.       the address more fully.
  167.  
  168.       The -r flag causes smail/rmail to attempt to route the first
  169.       component of a UUCP path, probably so    it can impress people
  170.       with how many    UUCP hosts it knows.  If this fails, it    passes
  171.       the unrouted address to uux, in case the path    database is
  172.       not complete.     The -R    flag causes smail/rmail    to take    a UUCP
  173.       path and route the rightmost component of the    path (save the
  174.       user name) possible.    This is    mostly for hosts that have
  175.       very up-to-date routing tables.
  176.  
  177.       If a route cannot be discerned from the available routing
  178.       database, then one more attempt to route the mail is made by
  179.       searching for    an entry in the    database for a route to    a
  180.       smart-host. If this entry exists, then the mail will be
  181.       forwarded along that route to    be delivered.  This allows a
  182.       host to depend on another, presumably    better informed, host
  183.       for delivering its mail.  This kind of arrangement should be
  184.       worked out, in advance, with the smart-host's    administrator.
  185.  
  186.       After    smail/rmail resolves an    address, it reparses it    to see
  187.       if it    is now a UUCP path or local address.  If the new
  188.       address turns    out to be another domain address, smail
  189.       complains because we don't like to resolve more than once.
  190.       This error occurs when an address partially resolves the
  191.       local    host.
  192.  
  193.       By default, smail will not alter the explicit    bang path
  194.       routing of any mail message.    If the stated path is
  195.       unuseable, (i.e., the    next hop host is unknown) then smail
  196.       will apply ALWAYS routing, and attempt to deliver the    mail
  197.       to the potentially new address.  If this fails too, then
  198.       REROUTE routing will be applied to the address, and another
  199.       attempt to deliver is    made.  Lastly, an attempt to find a
  200.       path to a better informed host smart-host will be made and
  201.       the mail passed to that host.
  202.  
  203.      FROMMING
  204.       smail/rmail collapses    From_ and >From_ lines to generate a
  205.       simple from argument,    which it can pass to sendmail or use
  206.       to create its    own "From" line.  The rule for fromming    is:
  207.       concatenate each "remote from" host (separating them by
  208.       !'s),    and tack on the    address    on the last From_ line;    if
  209.       that address is in user@domain format, rewrite it as
  210.       domain!user; ignore host or domain if    either is simply the
  211.       local    hostname.  It also removes redundant information from
  212.       the From_ line.  For instance:
  213.  
  214.              ...!myhost!myhost.mydomain!...
  215.  
  216.       becomes
  217.  
  218.                  ...!myhost!...
  219.  
  220.       Leading occurrences of the local host    name are elided    as
  221.       well.
  222.  
  223.       smail/rmail generates    it own From_ line, unless it is
  224.       feeding sendmail, which is happy with    the -ffrom argument.
  225.       For UUCP bound mail, smail/rmail generates a "remote from
  226.       hostname", where hostname is the UUCP    hostname (not the
  227.       domain name),    so that    From_ can indicate a valid UUCP    path,
  228.       leaving the sender's domain address in From:.
  229.  
  230.      HEADERS
  231.       Certain headers, To:,    From:, Date, etc., are required    by
  232.       RFC822.  If these headers are    absent in locally generated
  233.       mail,    they will be inserted by smail.     Also, a line of trace
  234.       information, called a    Received: line,    will be    inserted at
  235.       the top of each message.
  236.  
  237.      UNDELIVERABLE MAIL"
  238.       Although nobody likes    to have    a mail message fail to reach
  239.       its intended destination, it somtimes    happens    that way.
  240.       Mail that is found to    be undeliverable (i.e.,    unknown    user
  241.       or unknown host) will    be returned to the sender.
  242.  
  243.      FILES
  244.       /usr/lib/uucp/paths       ascii path database
  245.       /usr/lib/aliases       ascii alias database
  246.       /usr/spool/uucp/mail.log    log of mail
  247.       /tmp/mail.log           record of mail
  248.  
  249.      SUPPORT
  250.       Enhancements,    enhancement requests, trouble reports, etc.,
  251.       should be sent to
  252.  
  253.                uucp-problem@Stargate.COM.
  254.  
  255.  
  256.      SEE ALSO
  257.       uux(1), paths(8), aliases(8)
  258.       sendmail(8)
  259.       binmail(1) on    BSD systems only
  260.       mail(1) on System V systems
  261.  
  262.      VERSION
  263.       @(#)smail.8     2.5 (smail) 9/15/87
  264.  
  265.