ptmap

Abstract

Displays a list of all packets belonging to the specified packet tree. Each list entry includes a packet’s numeric ID, packet tree ID, and owner name.

Syntax

ptmap <pk_tree_id>

Argument Type Description
<pk_tree_id> integer numeric ID of the packet tree-of-interest
A packet tree ID can be obtained by using one of several methods: (1) estimating the index of packet tree creation (e.g., “the 50th packet tree”); (2) issuing the ODB command pkmap with a specified packet or with the argument all; (3) issuing the ODB command pkprint with a specified packet; (4) observing a packet tree ID during a previous run of the same simulation.

Details

A packet tree is a group of packets related to a common ancestor. When a new packet is created by the KPs op_pk_create() or op_pk_create_fmt(), a new packet tree is created as well. However, when a new packet is created by copying an existing packet, either via the KP op_pk_copy() or due to broadcast transmission over a bus or radio link, this new copy packet is part of the same packet tree as the original packet. Each packet tree has a corresponding packet tree ID, which is used to identify the tree to the ODB commands ptmap and pttrace.

Issuing the ptmap command is useful for determining the number of offspring of a known original packet and their location in the network. The output format of ptmap is identical to the output format of the pkmap command. In the output list, a 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).

Example

This example is from the Ethernet simulation in models/std/eth_net, which has multiple packets within a packet tree due to a bus link broadcasting.

ODB> ptmap 1

packet (ID 1, tree ID 1) held by module (top.lan0.e5.mac)
packet (ID 2, tree ID 1) held by module (top.lan0.e5.bus_tx)
packet (ID 4, tree ID 1) held by (top.lan0.e6.strm_1)
packet (ID 6, tree ID 1) held by (top.lan0.e7.strm_1)
packet (ID 8, tree ID 1) held by (top.lan0.e5.strm_1)
packet (ID 10, tree ID 1) held by (top.lan0.e4.strm_1)
packet (ID 12, tree ID 1) held by (top.lan0.e3.strm_1)
packet (ID 14, tree ID 1) held by (top.lan0.e2.strm_1)
packet (ID 16, tree ID 1) held by module (top.lan0.e5.bus_tx)

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com