uupath(1)                                                         uupath(1)
                               TO BE OBSOLETED



 NAME    [Toc]    [Back]
      uupath, mkuupath - access and manage the pathalias database

 SYNOPSIS    [Toc]    [Back]
      uupath [-f pathsfile] mailaddress

      mkuupath [-v] pathsfile

 DESCRIPTION    [Toc]    [Back]
      The uucp commands, including uupath and mkuupath, are targeted for
      removal from HP-UX; see the WARNINGS below.

      uupath provides electronic message routing by expanding a simple UUCP
      address into a full UUCP path (see uucp(1)).  For example, host!user
      could be expanded into hostA!hostB!host!user.

      uupath expands an address by parsing mailaddress for the dominant host
      (see below) and looking up the host in the appropriate pathalias
      database (see pathalias(1)).  If the host is found in the database,
      the expanded address is written to the standard output.  If the host
      is not found, uupath writes the original address to the standard
      output and returns an exit status of 1.  uupath expects mailaddress to
      be in UUCP format (host!...!hostZ!user) or ARPANET format (user@host).

      The -f option opens the pathalias database based on pathsfile rather
      than the default database based on /usr/lib/mail/paths.  This database
      must be a database created by mkuupath, consisting of the two files
      pathsfile.dir and pathsfile.pag.

      The dominant host is the left-most UUCP host in mailaddress.  If no
      UUCP host is found (no ! is in the address), uupath assumes that the
      address is in the simple ARPANET format user@host.  If the address
      does not match either format, uupath writes the original address to
      the standard output and returns an exit status of 1.

      mkuupath constructs a mail routing database by using the pathsfile
      data file obtained from pathalias (see pathalias(1)).  as input.  The
      recommended pathsfile location is /usr/lib/mail/paths, because this is
      the default database used by uupath.  The database files pathsfile.dir
      and pathsfile.pag are created by mkuupath.  If these files already
      exist, they must be removed prior to running mkuupath.

      The -v option specifies verbose mode, which writes a line to the
      standard output for each entry written to the database.

 DIAGNOSTICS    [Toc]    [Back]
      uupath returns an exit status of 1 and writes the original mailaddress
      to the standard output if the address is not found or is incorrectly
      formatted.  uupath returns an exit status of 2 and prints a diagnostic
      message if the database files are not accessible, or if improper
      parameters are given.  Otherwise, uupath returns an exit status of 0.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 uupath(1)                                                         uupath(1)
                               TO BE OBSOLETED



      If the database files pathsfile.dir and pathsfile.pag already exist
      prior to running mkuupath, the message mkuupath: pathsfile.dir: File
      exists is displayed.  These files must be removed before running
      mkuupath.

 WARNINGS    [Toc]    [Back]
      Use of uucp commands, including uupath and mkuupath, is discouraged
      because they are targeted for removal from HP-UX.  Use ftp(1) or
      rcp(1) instead.

 AUTHOR    [Toc]    [Back]
      uupath was developed by University of California, Berkeley.

 FILES    [Toc]    [Back]
      /usr/lib/mail/paths
      /usr/lib/mail/paths.dir
      /usr/lib/mail/paths.pag

 SEE ALSO    [Toc]    [Back]
      pathalias(1), uucp(1).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003