pathrouter(1M)                                        pathrouter(1M)


       NAME
             pathrouter - path routing utility for UnixWare mailer

       SYNOPSIS
             /usr/lib/mail/surrcmd/pathrouter [-p] [-d] [-T pathfile] address ...

       DESCRIPTION
             The program /usr/lib/mail/surrcmd/pathrouter is used with the
             UnixWare mailer to enable a host to perform smart routing.
             This is typically done by a machine which acts as a gateway to
             a group of machines.  Given an email address, pathrouter does
             the following: it rewrites the address according to a routing
             database in /etc/uucp/paths; and it prints the resolved
             address on stdout.

             The pathrouter program uses a binary search algorithm to
             resolve addresses and so the key field in the /etc/uucp/paths
             file must be sorted in ascending order.

             All modes of the pathrouter program have the ability to
             process multiple addresses.

             pathrouter is automatically configured on your system.

          Options
             pathrouter accepts the following command line options:

                   -p        Use for batch mode processing, this prints on
                             the same line pairs of the original address
                             argument and the resolved address.

                   -d        Be verbose.  This is provided for debugging
                             purposes and is usually run by hand).

                   -T pathfile
                             Use pathfile as an alternate database rather
                             than the system defined database,
                             /etc/uucp/paths This option is useful for
                             debugging a new database file.

                   address ...
                             Address or addresses to be rewritten.

             # On gateway do routing checks
             # Comment this out for internal hosts
             '.+'  '.*[!@].*'   'Translate T=1;B=*; R=|pathrouter -p' '%n'


                           Copyright 1994 Novell, Inc.               Page 1

      pathrouter(1M)                                        pathrouter(1M)


         Files
            /etc/uucp/paths         ASCII database
            /etc/mail/mailsurr      UnixWare mail configuration rules file

      USAGE
            If you edit the /etc/uucp/paths file by hand, it is wise to
            run a script to check that the routing information is correct.
            An example that checks direct connections follows:

                        #!/bin/sh
                        # check the hosts directly connected
                        for  i in `uuname`
                        do
                        echo "$i \c";/usr/lib/mail/surrcmd/pathrouter $i!fred
                        done

            Following is an example that checks common domains:

                        # check commonly used domain addresses
                        for i in xsmuc.abc.de oasis.xyz.co.uk
                        do
                        echo "$i \c";/usr/lib/mail/surrcmd/pathrouter $i!fred
                        done

      REFERENCES
            uux(1C), smtpqer(1M), paths(4)

      NOTICES
            This program is derived from smail2.6.



















                          Copyright 1994 Novell, Inc.               Page 2