11.9. Obtaining packet information

11.9.1. Address

Represents an address.

11.9.1.1. Address.ip(hostname)

Creates an Address Object representing an IP address.

11.9.1.1.1. Arguments
hostname

The address or name of the IP host.

11.9.1.1.2. Returns

The Address object.

11.9.1.2. address:__tostring()

11.9.1.2.1. Returns

The string representing the address.

11.9.1.3. address:__eq()

Compares two Addresses.

11.9.1.4. address:__le()

Compares two Addresses.

11.9.1.5. address:__lt()

Compares two Addresses.

11.9.2. Column

A Column in the packet list.

11.9.2.1. column:__tostring()

11.9.2.1.1. Returns

The column's string text (in parenthesis if not available).

11.9.2.2. column:clear()

Clears a Column.

11.9.2.3. column:set(text)

Sets the text of a Column.

11.9.2.3.1. Arguments
text

The text to which to set the Column.

11.9.2.4. column:append(text)

Appends text to a Column.

11.9.2.4.1. Arguments
text

The text to append to the Column.

11.9.2.5. column:prepend(text)

Prepends text to a Column.

11.9.2.5.1. Arguments
text

The text to prepend to the Column.

11.9.2.6. column:fence()

Sets Column text fence, to prevent overwriting.

Since: 1.10.6

11.9.2.7. column:clear_fence()

Clear Column text fence.

Since: 1.11.3

11.9.3. Columns

The Columns of the packet list.

11.9.3.1. columns:__tostring()

11.9.3.1.1. Returns

The string "Columns", no real use, just for debugging purposes.

11.9.3.2. columns:__newindex(column, text)

Sets the text of a specific column.

11.9.3.2.1. Arguments
column

The name of the column to set.

text

The text for the column.

11.9.3.3. columns:__index()

Gets a specific Column.

11.9.4. NSTime

NSTime represents a nstime_t. This is an object with seconds and nanoseconds.

11.9.4.1. NSTime.new([seconds], [nseconds])

Creates a new NSTime object.

11.9.4.1.1. Arguments
seconds (optional)

Seconds.

nseconds (optional)

Nano seconds.

11.9.4.1.2. Returns

The new NSTime object.

11.9.4.2. nstime:__call([seconds], [nseconds])

Creates a NSTime object.

11.9.4.2.1. Arguments
seconds (optional)

Seconds.

nseconds (optional)

Nanoseconds.

11.9.4.2.2. Returns

The new NSTime object.

11.9.4.3. nstime:__tostring()

11.9.4.3.1. Returns

The string representing the nstime.

11.9.4.4. nstime:__add()

Calculates the sum of two NSTimes.

11.9.4.5. nstime:__sub()

Calculates the diff of two NSTimes.

11.9.4.6. nstime:__unm()

Calculates the negative NSTime.

11.9.4.7. nstime:__eq()

Compares two NSTimes.

11.9.4.8. nstime:__le()

Compares two NSTimes.

11.9.4.9. nstime:__lt()

Compares two NSTimes.

11.9.4.10. nstime.secs

Mode: Retrieve or assign.

The NSTime seconds.

11.9.4.11. nstime.nsecs

Mode: Retrieve or assign.

The NSTime nano seconds.

11.9.5. Pinfo

Packet information.

11.9.5.1. pinfo.visited

Mode: Retrieve only.

Whether this packet has been already visited.

11.9.5.2. pinfo.number

Mode: Retrieve only.

The number of this packet in the current file.

11.9.5.3. pinfo.len

Mode: Retrieve only.

The length of the frame.

11.9.5.4. pinfo.caplen

Mode: Retrieve only.

The captured length of the frame.

11.9.5.5. pinfo.abs_ts

Mode: Retrieve only.

When the packet was captured.

11.9.5.6. pinfo.rel_ts

Mode: Retrieve only.

Number of seconds passed since beginning of capture.

11.9.5.7. pinfo.delta_ts

Mode: Retrieve only.

Number of seconds passed since the last captured packet.

11.9.5.8. pinfo.delta_dis_ts

Mode: Retrieve only.

Number of seconds passed since the last displayed packet.

11.9.5.9. pinfo.ipproto

Mode: Retrieve only.

IP Protocol id.

11.9.5.10. pinfo.circuit_id

Mode: Retrieve or assign.

For circuit based protocols.

11.9.5.11. pinfo.curr_proto

Mode: Retrieve only.

Which Protocol are we dissecting.

11.9.5.12. pinfo.can_desegment

Mode: Retrieve or assign.

Set if this segment could be desegmented.

11.9.5.13. pinfo.desegment_len

Mode: Retrieve or assign.

Estimated number of additional bytes required for completing the PDU.

11.9.5.14. pinfo.desegment_offset

Mode: Retrieve or assign.

Offset in the tvbuff at which the dissector will continue processing when next called.

11.9.5.15. pinfo.private_data

Mode: Retrieve only.

Access to private data.

11.9.5.16. pinfo.fragmented

Mode: Retrieve only.

If the protocol is only a fragment.

11.9.5.17. pinfo.in_error_pkt

Mode: Retrieve only.

If we're inside an error packet.

11.9.5.18. pinfo.match_uint

Mode: Retrieve only.

Matched uint for calling subdissector from table.

11.9.5.19. pinfo.match_string

Mode: Retrieve only.

Matched string for calling subdissector from table.

11.9.5.20. pinfo.port_type

Mode: Retrieve or assign.

Type of Port of .src_port and .dst_port.

11.9.5.21. pinfo.src_port

Mode: Retrieve or assign.

Source Port of this Packet.

11.9.5.22. pinfo.dst_port

Mode: Retrieve or assign.

Source Address of this Packet.

11.9.5.23. pinfo.dl_src

Mode: Retrieve or assign.

Data Link Source Address of this Packet.

11.9.5.24. pinfo.dl_dst

Mode: Retrieve or assign.

Data Link Destination Address of this Packet.

11.9.5.25. pinfo.net_src

Mode: Retrieve or assign.

Network Layer Source Address of this Packet.

11.9.5.26. pinfo.net_dst

Mode: Retrieve or assign.

Network Layer Destination Address of this Packet.

11.9.5.27. pinfo.src

Mode: Retrieve or assign.

Source Address of this Packet.

11.9.5.28. pinfo.dst

Mode: Retrieve or assign.

Destination Address of this Packet.

11.9.5.29. pinfo.match

Mode: Retrieve only.

Port/Data we are matching.

11.9.5.30. pinfo.columns

Mode: Retrieve only.

Accesss to the packet list columns.

11.9.5.31. pinfo.cols

Mode: Retrieve only.

Accesss to the packet list columns (equivalent to pinfo.columns).

11.9.5.32. pinfo.private

Mode: Retrieve only.

Access to the private table entries.

11.9.5.33. pinfo.hi

Mode: Retrieve or assign.

Higher Address of this Packet.

11.9.5.34. pinfo.lo

Mode: Retrieve only.

Lower Address of this Packet.

11.9.5.35. pinfo.conversation

Mode: Assign only.

Sets the packet conversation to the given Proto object.

11.9.6. PrivateTable

PrivateTable represents the pinfo->private_table.

11.9.6.1. privatetable:__tostring()

Gets debugging type information about the private table.

11.9.6.1.1. Returns

A string with all keys in the table, mostly for debugging.