HP-UX Reference (11i v2 07/12) - 1 User Commands N-Z (vol 2)

u
uupath(1) uupath(1)
(TO BE OBSOLETED)
NAME
uupath, mkuupath - access and manage the pathalias database
SYNOPSIS
uupath [-f pathsfile ] mailaddress
mkuupath [-v] pathsfile
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)orARPANET
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.IfnoUUCP 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 diagnos-
tic 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 mes-
sage
mkuupath: pathsfile.dir: File exists is displayed. These files must be removed before run-
ning 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
/usr/lib/mail/paths
/usr/lib/mail/paths.dir
/usr/lib/mail/paths.pag
SEE ALSO
pathalias(1), uucp(1).
396 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update