home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SMAILBIN.ZIP / DOC.ZIP / ALIASES.MAN next >
Encoding:
Text File  |  1990-04-03  |  5.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4.                                                        ALIASES(8)
  5.  
  6.  
  7.  
  8. NAME
  9.      aliases - alias file for smail
  10.  
  11. DESCRIPTION
  12.      This file is used by _s_m_a_i_l only if _S_E_N_D_M_A_I_L is _n_o_t _d_e_f_i_n_e_d.
  13.      If _S_E_N_D_M_A_I_L is defined, then _s_e_n_d_m_a_i_l does all of the alias-
  14.      ing for the host.
  15.  
  16.      This file contains a list of aliases for local users or
  17.      mailing lists.  The format of each alias is
  18.  
  19.                 alias_name recip_name1 recip_name2 ...
  20.  
  21.      An attempt has been made to remain compatible with _s_e_n_d_m_a_i_l
  22.      alias file format, though the syntax is much more format
  23.      free than _s_e_n_d_m_a_i_l. As distributed, _c_a_s_e _d_i_f_f_e_r_e_n_c_e_s _a_r_e
  24.      _i_g_n_o_r_e_d when comparing names to aliases.  Only alias names
  25.      which resolve to the local host are recognized, and are
  26.      stored in their local form.  Lines which start with a
  27.      white space are continuation lines.  Parenthesised strings
  28.      are taken as comments (no nesting), as is anything after a
  29.      '#' (as in /_b_i_n/_s_h).  Here are some examples:
  30.  
  31.      # this whole line is a comment
  32.      #
  33.      # These are equivalent definitions
  34.  
  35.      alias_name      recip1 recip2 recip3
  36.  
  37.      alias_name:     recip1, recip2 , recip3
  38.  
  39.      alias_name      recip1 recip2
  40.                      recip3
  41.  
  42.      alias_name      recip1  # Recip1's name
  43.                      recip2  # Recip2's name
  44.                      recip3  # Recip3's name
  45.  
  46.      alias_name      recip1 (Recp1's name) recip2 (Recp2's name)
  47.                      recip3 (Recp3's name)
  48.  
  49.      alias_name@thishost     recip1 recip2 recip3
  50.  
  51.      alias_name@thisdomain   recip1 recip2 recip3
  52.  
  53.      thishost!alias_name     recip1 recip2 recip3
  54.  
  55.      thisdomain!alias_name   recip1 recip2 recip3
  56.  
  57.      Mailing lists are easily handled by two forms of file inclu-
  58.      sion.  The first form is the same as is supported by _s_e_n_d_-
  59.      _m_a_i_l
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ALIASES(8)
  71.  
  72.  
  73.  
  74.                 mylist    :include:/usr/lib/ml/mylist
  75.  
  76.      In this example, each entry in /_u_s_r/_l_i_b/_m_l/_m_y_l_i_s_t would be
  77.      added to the alias for _m_y_l_i_s_t. The second form is unique to
  78.      _s_m_a_i_l. It allows the _a_l_i_a_s_e_s file to include other _a_l_i_a_s_e_s
  79.      files.
  80.  
  81.                   :include:/usr/lib/ml/more-aliases
  82.  
  83.      This would include the file /_u_s_r/_l_i_b/_m_l/_m_o_r_e-_a_l_i_a_s_e_s as a
  84.      regular alias file.  This makes it easier to maintain groups
  85.      of aliases that change frequently, such as the list of net-
  86.      news moderators.
  87.  
  88.      All aliases are recursive, so care must be taken in their
  89.      definition.  _s_m_a_i_l aliasing attempts to prevent infinite
  90.      loops, and to do what was intended by the user.  For exam-
  91.      ple, the alias:
  92.  
  93.                      mylogin mypc!mylogin mylogin
  94.  
  95.      Expands to
  96.  
  97.                          mypc!mylogin mylogin
  98.  
  99.      even though the second occurrence of _m_y_l_o_g_i_n matches the
  100.      alias name.
  101.  
  102.      Both forms of file inclusion are recursive, too, so watch
  103.      out for nesting include files.  They may lead to infinite
  104.      loops.
  105.  
  106.      While the cost of parsing an alias file is usually negligi-
  107.      ble, it's wise to take savings anywhere savings can be
  108.      found.  Therefore, it's worth mentioning _s_m_a_i_l's parsing
  109.      strategy.  _s_m_a_i_l will try to get by with doing as little
  110.      work as possible when aliasing.  If on a particular invoca-
  111.      tion of _s_m_a_i_l, none of the recipent addresses are local,
  112.      (i.e., not potential aliases) then the _a_l_i_a_s_e_s file won't
  113.      even be read.  Similarly, when an _a_l_i_a_s_e_s file is read, it
  114.      does not expand any of the :include: files until they are
  115.      referenced.  Thus, in the alias (above) for _m_y_l_i_s_t, the file
  116.      :_i_n_c_l_u_d_e:/_u_s_r/_l_i_b/_m_l/_m_y_l_i_s_t would not be opened and read
  117.      (parsed) unless mail was sent to _m_y_l_i_s_t. Wise use of
  118.      :include: files can greatly increase the efficiency of the
  119.      alias utility.  It's not clear exactly where the _b_r_e_a_k-_e_v_e_n
  120.      point is when deciding to use an  :include: file in an
  121.      alias, versus having all of the recipents listed on the
  122.      line; but if a mailing list is large (whatever that means)
  123.      it is wise to use the :include: feature to save on parsing
  124.      costs.  Note that this discussion only applies to the first
  125.      form of file inclusion, since reading an _a_l_i_a_s_e_s file
  126.  
  127.  
  128.  
  129. 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                        ALIASES(8)
  137.  
  138.  
  139.  
  140.      constitutes a reference to :include: files of the second
  141.      form.
  142.  
  143.      There is another form of aliasing which works with the alias
  144.      capability.  This is called _p_e_r _u_s_e_r _f_o_r_w_a_r_d_i_n_g. For a given
  145.      user name, if there is no alias for the user then, if the
  146.      file  _u_s_e_r/._f_o_r_w_a_r_d exists, then its contents will be
  147.      treated as an alias for the user.  The syntax is the same as
  148.      that of the recipient lists in the alias file described
  149.      above.
  150.  
  151.      One difference between _s_m_a_i_l and _s_e_n_d_m_a_i_l is that _s_m_a_i_l
  152.      doesn't handle stuff like mail to files or command execu-
  153.      tion.
  154.  
  155. SEE ALSO
  156.      smail(8), paths(8), pathproc(8)
  157.  
  158. VERSION
  159.      @(#)aliases.8  2.5 (smail) 9/15/87
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                 3
  196.  
  197.  
  198.  
  199.