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 num-
ber 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 num-
bers 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 cur-
rent 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. How-
ever, AppleTalk Phase 2 nodes also honor a single embedded
wildcard character, `='. Under this scheme, one wildcard char-
acter 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 cur-
rent 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)
Mac OS X 10.5 - Generated Sun Oct 28 20:55:44 EDT 2007
