atlookup(1)                                           atlookup(1)



     NAME
          atlookup  -  look  up  network   visible   entities   (NVEs)
          registered on the AppleTalk internet

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

          atlookup -z [-C]

     DESCRIPTION
          The atlookup command 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.  The command
          line arguments and parameters are

          -d        Print network address using decimal numbers.

          -r nn     Retry lookup nn times.  The default is to try the
                    lookup eight times.

          -s nn     Retry lookup every nn seconds.  The default is to
                    space retries one second apart.

          -x        Print the 8-bit ASCII characters on output as hex-
                    adecimal numbers of the form \XX (where X is a hex
                    digit).  This is useful when you are using a ter-
                    minal other than the A/UX system console.

          object    Name of the object to be looked up.

          type      Type of the object to be looked up.

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

          -z        Lists all zones in the internet.

          -C        Prints zones in multiple columns.

          The object and type arguments may contain wildcard charac-
          ters. The symbol `=' indicates a wildcard lookup. For wild-
          card lookups to work correctly with all nodes any wildcard
          character specified must be the only character in the
          string. However, AppleTalk Phase 2 nodes also honor a single
          embedded wildcard character `='. Under this scheme one wild-
          card character may appear anywhere in the string and may



     April, 1990                                                     1

     atlookup(1)                                           atlookup(1)



          match zero or more characters. Note, however, that although
          an embedded `=' is acceptable in object and type arguements
          of atlookup, only the nodes implementing AppleTalk Phase 2
          protocols respond to such a query.  Hence the list of NVEs
          obtained may be incomplete.

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

     EXAMPLES
          This command looks up all NVEs registered on the local Ap-
          pleTalk 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 the command

             atlookup L=y:=

          displays all NVEs (of any type) in the current zone that
          have names starting with an L and ending in a y.  For exam-
          ple, 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

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











     2                                                     April, 1990