Note: This function is supported in AIX® 5.1 and earlier only.
Provides the means for performing a network dump.
Refer to the dddump entry point for the complete syntax of the dump entry point.
The tokdump entry point provides support for six of the seven dump commands. The DUMPWRITE command is not supported for network dump. The tokdumpwrt entry point supports this write function.
The supported commands are:
| Item | Description |
|---|---|
| DUMPINIT | Initializes the token-ring device handler as a dump device. |
| DUMPQUERY |
Gets the information required for performing a network dump.
The information is returned in the dmp_query structure in /usr/include/sys/dump.h file.
It contains the following information:
|
| DUMPSTART | Starts the network dump processing. |
| DUMPREAD | Initiates a dump read request to the token-ring device handler. |
| DUMPEND | Terminates the network dump processing. |
| DUMPTERM | Terminates the token-ring device hander as a dump device. |
The tokdump entry point functions with a Token-Ring High-Performance Network Adapter that has been correctly configured for use on a qualified network. Consult adapter specifications for more information on configuring the adapter and network qualifications.
The DUMPINIT command can be called from the process environment only. DUMPQUERY, DUMPSTART, DUMPREAD, DUMPEND, and DUMPTERM commands can be called in both the process environment and the interrupt environment.