diff options
-rw-r--r-- | docbook/CMakeLists.txt | 9 | ||||
-rw-r--r-- | docbook/wsug_graphics/related-ack.png | bin | 0 -> 272 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-current.png | bin | 0 -> 120 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-dup-ack.png | bin | 0 -> 296 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-first.png | bin | 0 -> 131 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-last.png | bin | 0 -> 133 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-other.png | bin | 0 -> 128 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-request.png | bin | 0 -> 182 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-response.png | bin | 0 -> 182 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/related-segment.png | bin | 0 -> 205 bytes | |||
-rw-r--r-- | docbook/wsug_graphics/ws-list-pane.png | bin | 13438 -> 179959 bytes | |||
-rw-r--r-- | docbook/wsug_src/WSUG_chapter_use.asciidoc | 56 | ||||
-rw-r--r-- | ui/qt/related_packet_delegate.cpp | 4 |
13 files changed, 67 insertions, 2 deletions
diff --git a/docbook/CMakeLists.txt b/docbook/CMakeLists.txt index c99692ed68..b257b69a7c 100644 --- a/docbook/CMakeLists.txt +++ b/docbook/CMakeLists.txt @@ -77,6 +77,15 @@ set(WSUG_FILES ) set(WSUG_GRAPHICS + wsug_graphics/related-ack.png + wsug_graphics/related-current.png + wsug_graphics/related-dup-ack.png + wsug_graphics/related-first.png + wsug_graphics/related-last.png + wsug_graphics/related-other.png + wsug_graphics/related-request.png + wsug_graphics/related-response.png + wsug_graphics/related-segment.png wsug_graphics/ws-analyze-menu.png wsug_graphics/ws-bytes-pane-tabs.png wsug_graphics/ws-bytes-pane.png diff --git a/docbook/wsug_graphics/related-ack.png b/docbook/wsug_graphics/related-ack.png Binary files differnew file mode 100644 index 0000000000..cfb853121b --- /dev/null +++ b/docbook/wsug_graphics/related-ack.png diff --git a/docbook/wsug_graphics/related-current.png b/docbook/wsug_graphics/related-current.png Binary files differnew file mode 100644 index 0000000000..6f17eb191b --- /dev/null +++ b/docbook/wsug_graphics/related-current.png diff --git a/docbook/wsug_graphics/related-dup-ack.png b/docbook/wsug_graphics/related-dup-ack.png Binary files differnew file mode 100644 index 0000000000..f43e8a4e3c --- /dev/null +++ b/docbook/wsug_graphics/related-dup-ack.png diff --git a/docbook/wsug_graphics/related-first.png b/docbook/wsug_graphics/related-first.png Binary files differnew file mode 100644 index 0000000000..c4bc21b1ca --- /dev/null +++ b/docbook/wsug_graphics/related-first.png diff --git a/docbook/wsug_graphics/related-last.png b/docbook/wsug_graphics/related-last.png Binary files differnew file mode 100644 index 0000000000..1a62cddbe9 --- /dev/null +++ b/docbook/wsug_graphics/related-last.png diff --git a/docbook/wsug_graphics/related-other.png b/docbook/wsug_graphics/related-other.png Binary files differnew file mode 100644 index 0000000000..fb6a51fac4 --- /dev/null +++ b/docbook/wsug_graphics/related-other.png diff --git a/docbook/wsug_graphics/related-request.png b/docbook/wsug_graphics/related-request.png Binary files differnew file mode 100644 index 0000000000..680b9fa57d --- /dev/null +++ b/docbook/wsug_graphics/related-request.png diff --git a/docbook/wsug_graphics/related-response.png b/docbook/wsug_graphics/related-response.png Binary files differnew file mode 100644 index 0000000000..24767ee4a3 --- /dev/null +++ b/docbook/wsug_graphics/related-response.png diff --git a/docbook/wsug_graphics/related-segment.png b/docbook/wsug_graphics/related-segment.png Binary files differnew file mode 100644 index 0000000000..529b96e919 --- /dev/null +++ b/docbook/wsug_graphics/related-segment.png diff --git a/docbook/wsug_graphics/ws-list-pane.png b/docbook/wsug_graphics/ws-list-pane.png Binary files differindex 5a4056e2f6..6d1e91327c 100644 --- a/docbook/wsug_graphics/ws-list-pane.png +++ b/docbook/wsug_graphics/ws-list-pane.png diff --git a/docbook/wsug_src/WSUG_chapter_use.asciidoc b/docbook/wsug_src/WSUG_chapter_use.asciidoc index 20104055f3..af4bbc78db 100644 --- a/docbook/wsug_src/WSUG_chapter_use.asciidoc +++ b/docbook/wsug_src/WSUG_chapter_use.asciidoc @@ -781,7 +781,7 @@ The packet list pane displays all the packets in the current capture file. [[ChUseWiresharkListPane]] .The ``Packet List'' pane -image::wsug_graphics/ws-list-pane.png[] +image::wsug_graphics/ws-list-pane.png[scaledwidth="100%"] Each line in the packet list corresponds to one packet in the capture file. If you select a line in this pane, more details will be displayed in the ``Packet @@ -814,9 +814,61 @@ The default columns will show: * button:[Protocol] The protocol name in a short (perhaps abbreviated) version. +* button:[Length] The length of each packet. + * button:[Info] Additional information about the packet content. -There is a context menu (right mouse click) available, see details in +The first column shows how each packet is related to the selected packet. For +example, in the image above the first packet is selected, which is a DNS +request. Wireshark shows a rightward arrow for the request itself, followed by a +leftward arrow for the response in packet 2. Why is there a dashed line? There +are more DNS packets further down that use the same port numbers. Wireshark +treats them as belonging to the same conversation and draws a line connecting +them. + +// Images were created on OS X 10.11 using a retina display. Lines were +// 36 physical pixels high. + +[horizontal] +.Related packet symbols + +image:wsug_graphics/related-first.png[height="18px"]:: + First packet in a conversation. + +image:wsug_graphics/related-current.png[height="18px"]:: + Part of the selected conversation + +image:wsug_graphics/related-other.png[height="18px"]:: + _Not_ part of the selected conversation + +image:wsug_graphics/related-last.png[height="18px"]:: + Last packet in a conversation. + +image:wsug_graphics/related-request.png[height="18px"]:: + Request. + +image:wsug_graphics/related-response.png[height="18px"]:: + Response. + +image:wsug_graphics/related-ack.png[height="18px"]:: + The selected packet acknowledges this packet. + +image:wsug_graphics/related-dup-ack.png[height="18px"]:: + The selected packet is a duplicate acknowledgement of this packet. + +image:wsug_graphics/related-segment.png[height="18px"]:: + The selected packet is related to this packet in some other way, e.g. as part + of reassembly. + +The packet list has an _Intelligent Scrollbar_ which shows a miniature map of +nearby packets. Each https://en.wikipedia.org/wiki/Raster_graphics[raster line] +of the scrollbar corresponds to a single packet, so the number of packets shown +in the map depends on your physical display and the height of the packet list. A +tall packet list on a high-resolution (``Retina'') display will show you quite a +few packets. In the image above the scrollbar shows the status of more than 500 +packets along with the 15 shown in the packet list itself. + +Right clicking will show a context menu, described in <<ChWorkPacketListPanePopUpMenu>>. [[ChUsePacketDetailsPaneSection]] diff --git a/ui/qt/related_packet_delegate.cpp b/ui/qt/related_packet_delegate.cpp index 75281c9781..1ab1eb2994 100644 --- a/ui/qt/related_packet_delegate.cpp +++ b/ui/qt/related_packet_delegate.cpp @@ -111,6 +111,10 @@ void RelatedPacketDelegate::paint(QPainter *painter, const QStyleOptionViewItem // The current decorations are based on what looked good and were easy // to code. + // It might be useful to have a JACKPOT_MODE define that shows each + // decoration in sequence in order to make it easier to create + // screenshots for the User's Guide. + // Vertical line. Lower and upper half for the start and end of the // conversation respectively, solid for conversation member, dashed // for other packets in the start-end range. |