home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SMAILBIN.ZIP / DOC.ZIP / PATHS.MAN < prev    next >
Encoding:
Text File  |  1990-04-03  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.                                                          PATHS(8)
  5.  
  6.  
  7.  
  8. NAME
  9.      paths - smail routing database
  10.  
  11. DESCRIPTION
  12.      The _p_a_t_h_s file is the routing database for _s_m_a_i_l.  Each line
  13.      of the file provides routing information to either a host or
  14.      to a domain.  Each line should have either two or three tab
  15.      (ascii 0x9) separated fields.  The format of each line in
  16.      the paths file is:
  17.  
  18.                          _k_e_y  _r_o_u_t_e   [_c_o_s_t]
  19.  
  20.      The _k_e_y field is the key on which searches are performed.
  21.      Typically this is either a UUCP host name or a domain name.
  22.      _s_m_a_i_l uses a binary search algorithm when searching the
  23.      database, so the keys must be sorted in ascending order.
  24.      Case is ignored when searching, so the keys should be con-
  25.      verted to lower case before sorting (see _l_c_a_s_e(8) and _p_a_t_h_-
  26.      _p_r_o_c(8)).  Warning: There is a bug in _s_o_r_t -_f, so don't use
  27.      it.  Convert the keys to lower case, and then sort.
  28.  
  29.      The _r_o_u_t_e field is a "printf" string that details the route
  30.      that mail to the _k_e_y should take.  See _p_a_t_h_a_l_i_a_s documenta-
  31.      tion for details.
  32.  
  33.      The optional _c_o_s_t field is used by _s_m_a_i_l to determine
  34.      whether to simply queue outbound UUCP mail, or to attempt
  35.      immediate delivery (usually by invoking _u_u_c_i_c_o).  If the
  36.      cost field is present, and the value is at or below _s_m_a_i_l's
  37.      _q_u_e_u_e_i_n_g _t_h_r_e_s_h_o_l_d then the mail will be queued and an
  38.      attempt at immediate delivery will be made.  This will speed
  39.      mail delivery between hosts who enjoy a cheap uucp link,
  40.      like a hardwired line or some other low cost transport
  41.      medium, while allowing mail sent over more expensive media
  42.      to accumulate before transmission.  If the field is absent,
  43.      the cost defaults to a value above the _q_u_e_u_e_i_n_g _t_h_r_e_s_h_o_l_d.
  44.      The default value for the queueing threshold is equal to the
  45.      pathalias cost DEDICATED+LOW.  Thus, direct links with cost
  46.      DEDICATED+LOW or less will see immediate delivery, while the
  47.      others are queued for later delivery.
  48.  
  49. EXAMPLE
  50.      Here's a sample paths file for a small host, like a pc, that
  51.      doesn't want to maintain complete routing information.  It
  52.      illustrates most of the aspect of the _p_a_t_h_s file.  Assme
  53.      that the pc's name is _m_y_p_c, and that it's in domain
  54.      ._m_y_d_o_m_a_i_n. Also, assume that it has a dedicated link to a
  55.      smart host named _b_i_g_h_u_b, and that _b_i_g_h_u_b's administrator has
  56.      given _m_y_p_c permission to use _b_i_g_h_u_b as a mail relay.
  57.      Lastly, assume that _m_y_p_c has a dialed on demand link to
  58.      another computer named _f_r_i_e_n_d.
  59.  
  60.  
  61.  
  62.  
  63.                                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PATHS(8)
  71.  
  72.  
  73.  
  74.           _p_a_t_h_a_l_i_a_s input
  75.  
  76.            mypc =   .mypc.mydomain
  77.            mypc friend(DEMAND), bighub(DEDICATED)
  78.            smart-host = bighub
  79.  
  80.           _p_a_t_h_s file produced by _p_a_t_h_a_l_i_a_s -_f _i_n_p_u_t_f_i_l_e|_p_a_t_h_p_r_o_c
  81.  
  82.            .mypc.mydomain     %s   0
  83.            bighub   bighub!%s 95
  84.            friend   friend!%s 300
  85.            mypc     %s   0
  86.            smart-host    bighub!%s 95
  87.  
  88.  
  89. SEE ALSO
  90.      pathalias - by Peter Honeyman
  91.      smail(8), lcasep(8), pathproc(8)
  92.  
  93. VERSION
  94.      @(#)paths.8    2.5 (smail) 9/15/87
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. 2
  130.  
  131.  
  132.  
  133.