uupath.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

uupath(1) uupath(1)

(TO BE OBSOLETED)

NAME

uupath, mkuupath - access and manage the pathalias database

SYNOPSIS

uupath [-f pathsﬁle ] mailaddress

mkuupath [-v] pathsﬁle

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 data-

base, 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 mailad-

dress to be in

UUCP format (host

!...!hostZ !user)orARPANET format (user@host).

The

-f option opens the pathalias database based on pathsﬁle rather than the default database

based on

/usr/lib/mail/paths

. This database must be a database created by mkuupath, consist-

ing of the two ﬁles pathsﬁle

.dir and pathsﬁle.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 pathsﬁle data ﬁle obtained from

pathalias (see pathalias (1)). as input. The recommended pathsﬁle location is

/usr/lib/mail/paths

, because this is the default database used by uupath. The database ﬁles

pathsﬁle

.dir and pathsﬁle.pag are created by mkuupath. If these ﬁles already exist, they must be

removed prior to running mkuupath.

The

-v option speciﬁes 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 diag-

nostic message if the database ﬁles are not accessible, or if improper parameters are given. Otherwise,

uupath returns an exit status of 0.

If the database ﬁles pathsﬁle

.dir and pathsﬁle .pag already exist prior to running

mkuupath, the

message

mkuupath: pathsﬁle .dir: File exists is displayed. These ﬁles 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

/usr/lib/mail/paths

/usr/lib/mail/paths.dir

/usr/lib/mail/paths.pag

Summary of content (2 pages)

PAGE 1
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 (see uucp (1)). For example, host !user could be expanded into hostA !hostB !host !user.
PAGE 2
(Notes) A (Notes) uA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010