uupath, mkuupath - access and manage the pathalias database
uupath [-f pathsfile] mailaddress
mkuupath [-v] pathsfile
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.
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
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
exists is displayed. These files must be removed before running
uupath was developed by University of California, Berkeley.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000