uupath(1)

DESCRIPTION

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

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.

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

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

uupath was developed by University of California, Berkeley.

FILES

SEE ALSO

pathalias(1), uucp(1).