UUPATH(1) — Series 300 Only
NAME
uupath, mkuupath − pathalias database access/management
SYNOPSIS
uupath [ −f db_name ] mail-address
mkuupath [ −v ] paths-file
HP-UX COMPATIBILITY
Level: HP-UX/NONSTANDARD
Origin: UCB
Remarks: Implemented on the Series 300 only.
DESCRIPTION
Uupath is a convenient tool for changing electronic message routing and is chiefly used to expand a simple uucp address into a full uucp path, e.g., host!user into hostA!hostB!host!user. Uupath expands an address by parsing mail-address 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 stdout. If the host is not found, uupath writes the original address to stdout and returns an exit status of 1. Uupath expects mail-address to be in uucp format (host!...!hostZ!user) or simple ARPANET format (user@host).
If the −f option is specified, uupath opens db_name as the pathalias database rather than the default database /usr/lib/mail/paths. This database must be a database created by mkuupath, and must consist of the two files paths-file.dir and paths-file.pag.
The dominant host is the leftmost uucp host in mail-address. If no uucp host is found (no ! is in the address) then 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 stdout and returns an exit status of 1.
Mkuupath constructs a mail routing database, using as input the paths-file data file obtained from pathalias(1). The recommended paths-file location is /usr/lib/mail/paths, since this is the default database used by uupath. The database files paths-file.dir and paths-file.pag are created by mkuupath. If these files already exist, they must be removed prior to running mkuupath. The −v option specifies verbose mode, causing a line to be written to stdout for each entry written to the database.
DIAGNOSTICS
Uupath returns an exit status of 1 and writes the original mail-address to stdout 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.
If the database files paths-file.dir and paths-file.pag already exist before running mkuupath, then the message “mkuupath: paths-file.dir: File exists” is displayed. These files must be removed before running mkuupath.
FILES
/usr/lib/mail/paths
/usr/lib/mail/paths.dir
/usr/lib/mail/paths.pag
SEE ALSO
Hewlett-Packard Company — December 25, 1986