pkmap
Abstract
Displays information about the specified packet including its ID, packet tree ID, and owner name.
Syntax
pkmap [<pk_id> | all | stats | <pk_format> | #<objid> | <object_hname>]
| Argument | Type | Description |
|---|---|---|
<pk_id> |
integer | numeric ID of the packet of interest A packet ID for this argument can be obtained by using one of several methods: (1) estimating the index of packet creation (e.g., “the 100th packet”); (2) issuing pkmap with the “all” argument; (3) observing a packet ID argument or return value in KP trace messages; (4) observing a packet ID during a previous run of the same simulation. |
| all | n/a | Display information about all packets. |
| stats | n/a | Display the number of packets owned by each object ID. |
<pk_format> |
string | Display all packets using the named format. |
#<objid> |
integer | object ID of the object holding the packets of interest Can be used alone or in combination with other options such as a packet ID or a packet format. |
<object_hname> |
string | hierarchical name of the object holding the packets of interest Can be used alone or in combination with other options such as a packet ID or a packet format. |
Details
Arguments can be combined. For example,
pkmap stats <pk_format> #<objid>
will display the number of packets with the specified format owned by the specified object.
Note: If several object IDs or hierarchical names are used in a command, only the last one listed will be used.
The packet is described as being “held” by the object that contains or “owns” it. Packets are either owned by a particular module, by a packet stream, or by the Simulation Kernel (if the packet is in transit). An error message will be displayed if an ID is specified for a packet that does not exist at the simulation time when pkmap is issued.
Example
ODB> tstop 200
Added breakpoint #1: stop at time = (200) sec.
ODB> cont
__________________________ (ODB 18.6.0: Event) ____________________________
* Time : 200,273985989774 sec, [3m 20s . 273ms 985us 989ns 774ps]
* Event : execution ID (6227), schedule ID (#6207), type (self intrpt)
* Source : execution ID (6195), top.pksw1.node3.src (processor)
* Data : code (0)
> Module : top.pksw1.node3.src [Objid=23] (processor) [process id: 15]
breakpoint #1 trapped : "stop at time = (200) sec."
ODB> pkmap all
packet (ID 1434, tree ID 1434) held by module (top.pksw2.node0.xmt)
packet (ID 1460, tree ID 1460) held by module (top.pksw2.node0.xmt)
packet (ID 1463, tree ID 1463) held by module (top.pksw2.node0.xmt)
packet (ID 1472, tree ID 1472) held by module (top.pksw2.node0.xmt)
packet (ID 1494, tree ID 1494) held by module (top.pksw2.node0.xmt)
packet (ID 1501, tree ID 1501) held by module (top.pksw2.node0.xmt)
...
packet (ID 1559, tree ID 1559) held by module (top.pksw2.node0.xmt)