atlookup(1)                                           atlookup(1)



NAME
       atlookup - looks up network-visible entities (NVEs) regis-
       tered 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 com-
               plete 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  wild-
               card  lookup.   For  wildcard lookups to work cor-
               rectly with all nodes, the only  character  speci-
               fied in the string must be the wildcard character.
               However, AppleTalk Phase 2 nodes also honor a sin-
               gle  embedded  wildcard character, `='. Under this
               scheme, one wildcard character can appear anywhere
               in  the  string and can match zero or more charac-
               ters. 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)