This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

atlookup(1)                                                                                      atlookup(1)



NAME
       atlookup - looks up network-visible entities (NVEs) registered on the AppleTalk network system


SYNOPSIS
       atlookup [-d] [-a] [-r nn] [-s ss] [-x] [object[:type[@zone]]]

       atlookup -z [-C]


ARGUMENTS
       -C      Prints zones in multiple columns.

       -d      Prints the network address in decimal numbers.

       -a      Don't display network addresses

       object  Specifies the name of the object to be looked up.

       -r nn   If  the  lookup  is unsuccessful, the system tries again the number of times specified by nn.
               The default is to try the lookup eight times.

       -s nn   Instructs atlookup to wait a certain number (ss) of seconds between consecutive  attempts  to
               complete a lookup successfully. The default is to space retries one second apart.

       type    Specifies the type of object to be looked up.

       -x      Prints  the 8-bit ASCII characters on output as hexadecimal numbers of the form      (where X
               is a hexadecimal digit).

       -z      Lists all zones in the network.

       zone    Specifies the zone in which the lookup is to be performed. You can use an asterisk instead of
               a zone name to indicate the current zone name.  If you don't specify a zone name, the current
               zone is the default.

               The object and type arguments can contain wildcard characters. The equal sign (=) indicates a
               wildcard  lookup.   For wildcard lookups to work correctly with all nodes, the only character
               specified in the string must be the wildcard character. However, AppleTalk Phase 2 nodes also
               honor  a  single  embedded wildcard character, `='. Under this scheme, one wildcard character
               can appear anywhere in the string and can match zero or more characters. Note, however,  that
               although  an  embedded  `='  is acceptable in object and type arguments of atlookup, only the
               nodes implementing AppleTalk Phase 2 protocols respond to such a query.  For this reason, the
               resulting list of NVEs may be incomplete.


DESCRIPTION
       atlookup uses the Name Binding Protocol (NBP) to look up names and addresses of the specified NVEs.

       The  default  is  to  look  up  all  the entities (of all types) in the current zone.  Specifying the
       object, type, or zone on the command line changes the scope of lookup.

       Information about the NVEs is displayed in a table format, one line per NVE.   Each  line  gives  the
       names of the object, type, and zone and the numbers of the network, node, and socket.


EXAMPLES
       This command looks up all NVEs registered in the local AppleTalk zone:

               atlookup

       In response, the system displays output similar to this:

               Found 5 entries in zone My-Zone
               6b5b.c3.ea 3-Eyed Monster:LaserWriter
               6b5b.80.fd 3-Eyed Monster Spooler:LaserWriter
               6b14.84.ea Incognito :LaserWriter
               6b19.a3.fd Light of Day:AFPServer
               6b51.27.fd Nets-R-Us Spooler:LaserWriter

       In  an  extended  AppleTalk network, this command displays all NVEs (of any type) in the current zone
       whose names start with L and end in y:

               atlookup L=y:=

       The output might be similar to this:

               Found 1 entries in zone My-Zone
               6b19.a3.fd Light of Day:AFPServer


FILES
       /usr/bin/atlookup Executable file


SEE ALSO
       at_cho_prn(1), atprint(1), atstatus(1) Inside AppleTalk



                                                                                                 atlookup(1)