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