NAME

atnetstat − AppleTalk network status display

SYNOPSIS

atnetstat [ −i interface ] [ −s ] [ −r ] [ −m ] [ −S ] [ −v ]

DESCRIPTION

The atnetstat command is used to assemble and display a wide range of data about AppleTalk. As is shown below, it can display this data in a variety of formats. 

The meanings of the options are described below. 

−i Specifies the network interface used as the AppleTalk interface.  The interface names that can be specified are Ethernet interfaces(en0, en1, en2,...) Once an interface is specified, the number of AppleTalk packets sent and received via it and aggregate number of bytes are displayed. When LocalTalk interface is available, you can select lt0. In this case also each error statistics are displayed. 

−s Displays statistical data on the DDP protocol.  The DDP protocol statistics displayed in this case report the total data processed and are not related to the interface through which the data passed.  The −v flag (described below) can be used to obtain more detailed data. 

−r Displays the contents of the AppleTalk routing table.  The −v flag (described below) can be used to obtain more detailed data. 

−m MacIP status

−S Displays the AppleTalk socket status. 

−v Turns on the verbose mode. 

EXAMPLE 1

Here are some examples of how the command works.  % atnetstat −r The above command will produce a display of the sort shown below.

Routing tables[0] Status: GOOD
Network [E] <300,310> Hop 1 TO <10,240> From en1
Engineering-1
Routing tables[1] Status: GOOD
Network [E] <10,10> Hop 0 From en0
Doc-1 Doc-2
Routing tables[2] Status: SUSPECT
Network [N] <10> Hop 2 To <10,145> From en1
System-1

Status is reported as GOOD, SUSPECT, BAD0 or BAD1.  These status designations are automatically aged by exchanging AppleTalk routing data.  Only routing data exchanged when the status is GOOD, SUSPECT or BAD0 is valid. The command atnetstat −r can be used to display only valid data.  Specifying the −v option causes all data in the routing table, including “BAD1” status data, to be displayed. 
The [N] following Network indicates NON-Extended Network.  [E] means Extended Network.  The network range is indicated by <300, 310>.  In this case, network numbers from 300 though 310 are valid. 
HOP 1 indicates that the hopcount is 1.  A hopcount of 0 means a direct connection. 
TO <10, 240> indicates the router address for the next hop.  In the example above, the address indicated is network number 10 and node number 240 (decimal values).  If HOP is 0 no router address is displayed. 
From en0 indicates which interface should be used for output.  The next line is a list of zones set up on the network. 

EXAMPLE 2

% atnetstat  −S The above command will produce a display of the sort shown below.

Current Socket Status
NUMBER                  UPSTREAM     ADDR
  1.(    RTMP)            Kernel       8009b930
  2.(     NBP)            Kernel       800a33dc
  4.(     AEP)            Kernel       8009af34
  6.(     ZIP)            Kernel       800a8250
128.( Dynamic)          Kernel       8009e050
253.( Dynamic)          User         c020aff0

Number indicates the DDP socket number.  On AppleTalk socket numbers 1 through 127 are defined as static.  They must be used in specific ways.  Those that the command recognizes are displayed (e.g. RTMP).  Socket numbers 128 through 254 are defined dynamically. 

UPSTREAM shows where each socket’s processing routine is and the ADDR item indicates the address of each processing routine.  In the above example, the processing routines for sockets 1 through 128 are internal to the kernel and 253 is a user process. 

EXAMPLE 3

% atnetstat  −m The followings are sample

dynamic address table:
IP addrAT addrstatustimer
133.138.118.110000.00free    0
133.138.118.120000.00free    0
133.138.118.130000.00free    0
133.138.118.140000.00free    0
133.138.118.150000.00free    0
static address table:
IP addrAT addrstatustimer
133.138.118.510000.00free    0
133.138.118.520000.00free    0
133.138.118.530000.00free    0
133.138.118.540000.00free    0
133.138.118.550000.00free    0

AT addr is the AppleTalk node address which already assigned IP address,Status takes one of free, arp (searching) or assigned.Timer indicates the client status.Initial timer value is 5. Address assignee asks client status every minute.If client are alive, timer value sets 5.If client cannot answer, 1 is substructed from timer value. When timer value is 0, the address status is changed into free status. 

BUGS

The data values obtained by atnetstat are only approximate.  There will be cases where more precise and detailed data is necessary. 
The socket data may not be particularly useful.

SEE ALSO

atlookup(1), atconfig(8). 

NEWS-OSRelease 4.2.1R