pkprint
Abstract
Displays the contents of the specified packet, including field information and selected properties.
Syntax
pkprint <pk_id> [tda | vvec | long]
| 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 the ODB command “pkmap all”; (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. |
| tda | n/a | Display any associated TDAs. |
| vvec | n/a | Display the contents of any value vectors installed in the packet. |
| long | n/a | Display both TDAs and value vectors, if any. |
Details
The displayed packet information includes:
- the packet ID and packet tree ID
- the packet’s address in the simulation process address space (printed in hexadecimal)
- the format name of the packet (if it is formatted)
- the module, simulation time, and event ID associated with packet’s creation, and with the last stamp applied to the packet
- the bulk and the total size of the packet, in bits
- the packet’s owner (this is either a module or the Simulation Kernel, if the packet is in transit between modules)
- the ID of an ICI assigned to the packet (“NONE” if no ICI has been assigned)
- Boolean flags indicating whether the packet ID or packet tree ID has an active trace
- a list of the packet fields, including their names, data types, values, and sizes in bits
- for SAR packets, the ID of each segment that references the packet
Example
ODB> pkprint 2 tda
_______________________________________________________
Packet content
ID : 2
tree ID : 2
address : 0x03090158
format : lab1_top
creation module : top.Enterprise Network.send.gen [Objid=4]
creation time : 0.0 sec, [0s]
creation event : 457
stamp module : top.Enterprise Network.send.gen [Objid=4]
stamp time : 0.0 sec, [0s]
bulk size : 0
total size : 232
owner : top.Enterprise Network.recv.recev [Objid=15]
ICI ID : NONE
ID trace : off
tree ID trace : off
encap flags : NONE
_______________________________________________________
Packet Fields
Index Name Type Value Size
----- ----------------------------- ----------- --------------- ----
0 a_very_long_name_for_an_int integer 3 32
1 dbl floating pt 12,345.678 64
2 child packet pk id (1) 136 (inherited)
_______________________________________________________
Transmission Data Attributes (TDA)
TDAs (built-in radio)
OPC_TDA_RA_ACTUAL_BER (0.0)
OPC_TDA_RA_BER (0.0)
OPC_TDA_RA_BKGNOISE (0.0 W)
OPC_TDA_RA_CLOSURE (OPC_TRUE)
OPC_TDA_RA_ECC_THRESH (0.0)
OPC_TDA_RA_END_DIST (2,534.045830 m)
OPC_TDA_RA_END_PROPDEL (0.000008446819 sec. [8us 446ns 819ps])