


PATHTO(1)                                               PATHTO(1)


NNAAMMEE
       pathto, uupath - calculate mail paths

SSYYNNOOPPSSIISS
       ppaatthhttoo  [ --ttddnnssvv ] _a_d_d_r_e_s_s ...
       uuuuppaatthh  [ --ttssvv ] [ _s_i_t_e_n_a_m_e|_d_o_m_a_i_n|_p_a_t_h ]  _._._.

DDEESSCCRRIIPPTTIIOONN
       These  commands query the mail routing databases to deter-
       mine which paths will be used in sending mail to the spec-
       ified hosts or addresses.

       The  _p_a_t_h_t_o(1)  command  takes  the  address of a user and
       determines the path that _s_m_a_i_l(8) would use for  delivery.
       For historical reasons, the resulting path is rewritten as
       a UUCP-style `!'_-_p_a_t_h by default, even  though  this  form
       may  not be used by smail for delivery.  The leading site-
       name in the path is the site towards which  _s_m_a_i_l(8)  will
       make  a delivery.  The leading sitename may be followed by
       a route to the target of the address if the leading  site-
       name and target are different.  The remainder of the argu-
       ment, if anything, is added on to the end.   This  command
       advises  you  on  how  _s_m_a_i_l(8) will handle an address but
       does not give the actual address that _s_m_a_i_l(8)  will  use,
       unless the --nn option given.

       The  _u_u_p_a_t_h(1) command attempts to compute paths from your
       machine to other machines.  If the argument is the name of
       a  site such as _n_s_a_v_a_x_, or _n_s_a_v_a_x_._n_s_a_._g_o_v_, or if it is the
       name of a domain such as _._n_s_a_._g_o_v_, then the _u_u_p_a_t_h(1) pro-
       gram  will  try  to produce a path to that site or domain.
       If the argument is a  `!'_-_p_a_t_h,  then  _u_u_p_a_t_h  computes  a
       route  to the first site, and appends the remainder of the
       path onto  it.   For  historical  reasons,  the  resultant
       string will be _`_`_%_s_'_'_, if the host is the local host.

       It  is  important  to note that _u_u_p_a_t_h arguments relate to
       _s_i_t_e_n_a_m_e_s, while the _p_a_t_h_t_o arguments relate to  _a_d_d_r_e_s_s_e_s
       _o_f _u_s_e_r_s.  The command:

              uupath namei

       will  compute  a  path  to the SITE named _n_a_m_e_i_, while the
       command:

              pathto namei

       will ``compute a path'' to the USER  named  _n_a_m_e_i  on  the
       local machine.

OOPPTTIIOONNSS
       All three commands take hosts and addresses from the argu-
       ments, or from standard input if none are given  as  argu-
       ments.  The following options are recognized:



Local                    1 February 1988                        1





PATHTO(1)                                               PATHTO(1)


       --ss     If _s_m_a_r_t_-_h_o_s_t routing is enabled in the _s_m_a_i_l rout-
              ing databases, then --ss will cause smart-host  rout-
              ing  used  as a last resort in computing paths.  By
              default,  smart-host  routing  is  not  taken  into
              account  by  these  commands.   A smart-host router
              will route an address to a remote host that suppos-
              edly  has  a  larger  or  more  up-to-date  routing
              database than the local host.

       --dd     By default, _p_a_t_h_t_o does not examine what will  hap-
              pen  when  mail  is actually delivered to the final
              user(s).  If the final users are on the local  sys-
              tem, then --dd will apply any aliasing, forwarding or
              mailing lists expansions.  The order and number  of
              arguments  will  not  necessarily correspond to the
              order and number of output address when this option
              is used.

       --nn     _u_u_p_a_t_h will always produce a pure UUCP path, and by
              default so will will _p_a_t_h_t_o,  in  the  interest  of
              backward  compatibility.  The --nn flag will generate
              other addressing forms if they  would  actually  be
              used  by  _s_m_a_i_l  for delivery.  With the --nn option,
              the _p_a_t_h_t_o command will  print  the  next-hop  host
              that  a  particular address would be sent to (or it
              will print ``local'' if the address would be deliv-
              ered  locally),  and it will print the address that
              smail will give to the next-hop.  The next-hop host
              and  the  address  are  separated  by  ::  and some
              whitespace.

       --tt     Announce the name of the transport  that  would  be
              used  in delivering to an address, if the transport
              is known.  Local addresses that  are  not  resolved
              using  the  --dd  flag  will  not  produce a tranport
              because the specific local transport cannot  deter-
              mined without applying the directors.

       --vv     Be  verbose,  announcing  each  important  state of
              address resolution as it occurs.  The verbose  mes-
              sages are written to standard error.

EEXXAAMMPPLLEESS
       The  following  examples assume the following routing con-
       figuration will be used to compute path information:

       a.  a  list   of   known   local   host   names:   _a_m_d_a_h_l,
           _u_t_s_._a_m_d_a_h_l_._c_o_m and _a_m_d_a_h_l_._c_o_m.

       b.  a _p_a_t_h_a_l_i_a_s(8) database containing the lines:

                .nsa.gov       namei!nsavax!%s
                amdahl         %s
                glotz          namei!glotz!%s



Local                    1 February 1988                        2





PATHTO(1)                                               PATHTO(1)


                kgbvax         name!walldrug!kgbvax!%s
                namei          namei!%s
                nsavax         namei!glotz!nsavax!%s

           where each path will use _U_U_X for delivery.

       c.  a  known  network connection to the host _e_e_k, which is
           also known as _e_e_k_._u_t_s_._a_m_d_a_h_l_._c_o_m.

       d.  domains of the form _[_n_u_m_b_e_r_._n_u_m_b_e_r_._n_u_m_b_e_r_._n_u_m_b_e_r_]  are
           recognized  as  internet numbers to be delivered using
           TCP/IP.

       e.  the path _n_a_m_e_i_!_g_l_o_t_z_!_n_s_a_v_a_x is used  as  a  smart-host
           path for addresses the localhost cannot route.

       The following commands, in italic, will produce the corre-
       sponding output:

            $ _u_u_p_a_t_h _n_s_a_v_a_x _m_i_t_-_p_r_e_p _u_t_s_._a_m_d_a_h_l_._c_o_m
            namei!glotz!nsavax
            uupath: no route found to mit-prep
            %s

            $ _u_u_p_a_t_h _-_s _m_i_t_-_p_r_e_p_!_r_m_s
            namei!glotz!nsavax!mit-prep!rms

            $ _p_a_t_h_t_o _@_e_e_k_._u_t_s_._a_m_d_a_h_l_._c_o_m_:_r_m_s_@_p_r_e_p_._a_i_._m_i_t_._e_d_u
            eek!prep.ai.mit.edu!rms

            $ _p_a_t_h_t_o _-_n _@_[_1_9_2_._2_._1_2_._3_]_:_r_m_s_@_p_r_e_p_._a_i_._m_i_t_._e_d_u
            [192.2.12.3] :: rms@prep.ai.mit.edu

            $ _p_a_t_h_t_o _b_r_o_w_n_@_n_s_a_v_a_x
            namei!glotz!nsavax!brown


DDIIAAGGNNOOSSTTIICCSS
       An error message will be  written  to  standard  error  if
       there  is  a syntax error in an address, or if no path can
       be found for an address  and  smart-host  routing  is  not
       being used.  In case of such errors, these programs return
       an    appropriate    exit    code    from     the     file
       _/_u_s_r_/_i_n_c_l_u_d_e_/_s_y_s_e_x_i_t_s_._h; e.g., _E_X___D_A_T_A_E_R_R or _E_X___N_O_H_O_S_T.

FFIILLEESS
       _/_u_s_r_/_l_i_b_/_m_a_i_l_/_p_a_t_h_s      Standard ascii path database.

       _/_u_s_r_/_l_i_b_/_m_a_i_l_/_r_o_u_t_e_r_s    Smail routing configuration.

SSEEEE AALLSSOO
       _s_m_a_i_l(8), _s_m_a_i_l(5), _p_a_t_h_a_l_i_a_s(8) and _p_a_t_h_a_l_i_a_s(5).





Local                    1 February 1988                        3





PATHTO(1)                                               PATHTO(1)


BBUUGGSS
       Your  local  site  does  not always know a correct path to
       every site.

       Routing is only  as  good  as  your  routing  information.
       Smail  cannot  compensate  for  out-of-date or poorly syn-
       cronized databases.

CCOOPPYYRRIIGGHHTT
       Copyright(C)1987, 1988 Ronald S. Karr and Landon Curt Noll
       Copyright(C)1992 Ronald S. Karr
       See  a  file COPYING, distributed with the source code, or
       type _s_m_a_i_l _-_b_c for distribution  rights  and  restrictions
       associated with this software.











































Local                    1 February 1988                        4


