NETTRACE(1M) Series 300 Only NETTRACE(1M)
NAME
nettrstart, nettrdump, nettrstop - network trace facilities
SYNOPSIS
/etc/nettrstart [ -rt ] [ -b queue-size ]
/etc/nettrdump [ -fb ]
/etc/nettrstop
HP-UX/COMPATIBILITY
Level: HP-UX/NON-STANDARD
Origin: HP
Remarks: Implemented on the Series 300 only.
DESCRIPTION
Network tracing is associated with the network interface
card. When tracing is enabled, all packets received or
transmitted over the interface card will be recorded in the
trace queue, including packets whose source and destination
are the local host. When this first-in-first-out (FIFO)
queue is filled, the packet at the front of the queue
(oldest packet) will be deleted in order to accommodate any
new packet.
Only the super-user can perform network tracing via these
commands.
Nettrstart allocates the tracing queue and activates network
tracing. When no options are specified, nettrstart
allocates a queue of 12000 bytes and starts tracing both the
receive and transmit packets. Nettrstart recognizes the
following options:
-t Trace only transmit packets.
-r Trace only receive packets.
-b queue-size Set the size of the trace queue to queue-size
bytes (instead of the default 12000 bytes).
Nettrdump displays the current contents of the trace queue.
Unless the -f option is used, nettrdump performs a non-
destructive read of the trace queue; i.e., all packets
displayed remain intact in the trace queue. Tracing is
paused momentarily during the display, so any packets sent
or received during the display will not be traced; tracing
resumes when the display is completed. Nettrdump recognizes
the following options:
-f Flush the trace queue. The trace queue is
cleared after displaying its contents.
Hewlett-Packard - 1 - (printed 7/16/86)
NETTRACE(1M) Series 300 Only NETTRACE(1M)
-b Output the packets in binary format. Each
packet in the binary format has a three-byte
header. The first byte of the header
describes the type of packet: the character
``r'' represents a received packet, while the
character ``t'' represents a transmitted
packet. The second and third bytes of the
header provide the length of the packet.
Nettrstop stops tracing and deallocates the trace queue.
Nettrstart may not be used when tracing is already active.
Nettrdump and nettrstop may not be used unless tracing is
active.
Hewlett-Packard - 2 - (printed 7/16/86)