atnvelkup(1)                                       atnvelkup(1)



          at_nvelkup - look up NVE's

     SYNOPSIS
          atnvelkup [-l] [-f network] [object] [-t type] [-z zone]

     DESCRIPTION
          atnvelkup queries the Name Binding Protocol module for the
          addresses of all Network Visible Entries (NVE's) registered
          on the AppleTalk network matching the name specified by the
          user.  The object, type, and zone of the NVE's may be
          specified to limit the lookup.  Wildcard characters are
          allowed; they are `=' for object and type, and `*' for zone.
          An object or type field of `=' matches any object or any
          type; a zone field of `*' designates the current zone.  You
          may omit the following fields instead of giving the
          corresponding wildcard characters:
               zone
               type and zone
               object, type and zone
          to achieve the same effect.

          Since it is possible to have multiple AppleTalk networks
          attached to a system, this utility needs to know the path in
          the file system to the desired network.  Using
               -f network
          will select the network network.  For example:
               -f /dev/appletalk2
          will choose the second AppleTalk network that is attached to
          the system.  If -f - is used, then standard input will be
          used.

          If the -f flag option is not used, there is a sequence of
          other locations which are looked at for the network path.
          First, if there is an environmental variable ATNETWORK, its
          value will be used as the path to the desired network.

          If no ATNETWORK variable exists, then the environmental
          variable ATDIR is used as a path to a directory that should
          contain a file called .appletalkrc.  The first line in that
          file is the path to the desired network.

          If no ATDIR variable is found, the user's home directory is
          searched for the the .appletalkrc file.

          If all of the above attempts fail, then the default path is
          used, /dev/appletalk.

          If the /-l flag option is used, only the NVE's registered on
          the local node will be displayed.

          Information about the NVE's is displayed in a table format,
          one line per NVE, containing the object, type and zone



     Page 1                                        (last mod. 1/16/87)

     atnvelkup(1)                                       atnvelkup(1)



          names, and the net, node and socket numbers in hexadecimal
          format, respectively.  If the -l flag option is used, the ID
          of the process that registered the NVE and the time of
          registration will also be printed.


     EXAMPLE
            atnvelkup

          queries the NBP daemon for all NVE's registered on the
          default AppleTalk network, /dev/appletalk.  The following
          table is displayed:

          OBJECT   TYPE        ZONE NET  ND SK
          at_pftd1 Apple_PFT    *   0000 40 80
          Writer2  LaserWriter  *   5678 d3 ea


     SEE ALSO
          at_nvereg(1M), at_nveshow(1),
          ``AppleTalk programmer's guide'' in Oreo Network
          Applications Programming.

































     Page 2                                        (last mod. 1/16/87)