82 lines
2.0 KiB
Groff
82 lines
2.0 KiB
Groff
.TH IPX_DUMP 8 "April 2026" "ipx-utils 1.3" "System Administration"
|
|
.SH NAME
|
|
ipx_dump \- dump IPX packets from a network interface
|
|
.SH SYNOPSIS
|
|
.B ipx_dump
|
|
.RB [ \-r ]
|
|
.RB [ \-d
|
|
.IR device ]
|
|
.RI [ node ]
|
|
.br
|
|
.B ipx_dump
|
|
.B \-h
|
|
.SH DESCRIPTION
|
|
.B ipx_dump
|
|
captures Ethernet frames from a network interface and prints IPX packets in a
|
|
text format suitable for inspection or for later decoding with
|
|
.BR ipx_parse (8).
|
|
|
|
By default,
|
|
.B ipx_dump
|
|
opens a raw packet socket on the selected interface, puts the interface into
|
|
promiscuous mode while it is running, and prints decoded IPX frame information.
|
|
The program must normally be run as root or with equivalent capabilities.
|
|
|
|
When
|
|
.B \-r
|
|
is used,
|
|
.B ipx_dump
|
|
prints raw Ethernet frames as hexadecimal data prefixed with
|
|
.BR raweth .
|
|
This raw output can be piped to
|
|
.BR ipx_parse (8)
|
|
for more detailed protocol decoding.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-r
|
|
Dump raw Ethernet frames instead of the default decoded IPX frame output.
|
|
.TP
|
|
.BI \-d " device"
|
|
Capture packets from
|
|
.IR device .
|
|
If this option is not specified,
|
|
.B eth0
|
|
is used.
|
|
.TP
|
|
.B \-h
|
|
Show usage information and exit.
|
|
.TP
|
|
.I node
|
|
Optional IPX node filter. If specified, only packets whose source or
|
|
destination node matches
|
|
.I node
|
|
are printed. The node value is parsed as an IPX node address.
|
|
.SH EXAMPLES
|
|
.TP
|
|
Capture decoded IPX packets on the default interface:
|
|
.B ipx_dump
|
|
.TP
|
|
Capture raw frames on interface
|
|
.BR eth1 :
|
|
.B ipx_dump -r -d eth1
|
|
.TP
|
|
Capture raw frames and decode them with
|
|
.BR ipx_parse :
|
|
.B ipx_dump -r -d eth1 | ipx_parse
|
|
.SH NOTES
|
|
.B ipx_dump
|
|
temporarily enables promiscuous mode on the selected interface and restores the
|
|
previous interface flags before exiting normally. If the program is killed
|
|
abruptly, the interface flags may need to be checked manually.
|
|
|
|
The raw capture mode uses Linux packet sockets and is intended for diagnostic
|
|
use.
|
|
.SH SEE ALSO
|
|
.BR ipx_parse (8),
|
|
.BR ipx_configure (8),
|
|
.BR ipx_interface (8),
|
|
.BR ipx_route (8)
|
|
.SH AUTHORS
|
|
Originally written by Volker Lendecke and Petr Vandrovec.
|
|
Maintained in the standalone ipx-utils package by Mario Fetka.
|