NAME

atlookup − displays entities on an AppleTalk network

SYNOPSIS

atlookup [ −d ] [ −r ntimes ] [ −s nseconds ] [ −x ] [ [object[:type[@zone]]] ]
atlookup [ −z ] [ −C ]

DESCRIPTION

The atlookup command uses the AppleTalk NBP (Name Binding Protocol) to display the names and addresses of entities on a network. 
The first command syntax listed under “SYNOPSIS” above displays all of the entities within the specified zone. The default is the current zone. The second command syntax listed displays all of the zones in the AppleTalk network.

The meanings of the options are as follows:

−d Displays network addresses in decimal notation. The default is hexadecimal. 

−r Specifies the number of retries. The default is 8. 

−s Specifies the interval between rewrites in seconds. The default is 1. 

−x Specifies that if characters other than ASCII characters are encountered, they should be displayed in hexadecimal notation. 

−z Displays all zones. 

−C Produces a multi-column display. 

The character “=” may be used as a wildcard when specifying object and type names.  However, wildcards may not be used when the specifying zone.  If no zone specification is made, the user’s current zone is used. 

EXAMPLES

A cupple of examples are presented below.  The first example will display all of the entities in the current zone.  % atlookup The display produced will be something like the following. Found 2 entries in zone LocalTalk
00c8.84.f9 LaserWriter II NTX:LaserWriter
00c8.57.fb System:Macintosh II The first line shows how many entities were actually found and the zone name. In the above example, two entities were found and the zone name is LocalTalk.
From the next line onward, the addresses of the entities that were found are listed. The address 00c8.84.f9 is in hexadecimal notation.  The initial 00c8 indicates the network number; the 84 is the node number; and the final f9 is the number of the socket being used.  It is rare for the socket number to be included in an address indication, but it can be useful in cases where more than one application is running on the same machine. 
In the field next to the address each entity is listed in the format object:type.  In other words, “LaserWriter II NTX” is the entity’s object name and “LaserWriter” is its type name.  The example which follows produces a list of all current zones. In this case, only zone names are displayed. % atlookup −z The following example will list all of the entities in the zone EtherTalk.  % atlookup ’=:=@EtherTalk’ The following example lists all the entities in the zone EtherTalk with the type name LaserWriter.  % atlookup ’=:LaserWriter@LocalTalk’ The following example lists all the entities in the current zone that begin with the letter M.  % atlookup ’M=:=’

BUGS

Depending on the structure of the network, there may be cases in which collecting entity data can take a long time.  Also, entities with very clow response times may sometimes be overlooked.  The only way to remedy this is to increase the number of retries. 

SEE ALSO

atnetstat(1), atconfig(8)

NEWS-OSRelease 4.2.1R