Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > U

uupath(1)

TO BE OBSOLETED
HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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

/usr/lib/mail/paths /usr/lib/mail/paths.dir /usr/lib/mail/paths.pag

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.