docbook/wsug_src/WSUG_chapter_use.asciidoc

   1 ++++++++++++++++++++++++++++++++++++++
   2 <!-- WSUG User Interface Chapter -->
   3 ++++++++++++++++++++++++++++++++++++++
   4
   5 [[ChapterUsing]]
   6
   7 == User Interface
   8
   9 [[ChUseIntroductionSection]]
  10
  11 === Introduction
  12
  13 By now you have installed Wireshark and are most likely keen to get started
  14 capturing your first packets. In the next chapters we will explore:
  15
  16 * How the Wireshark user interface works
  17 * How to capture packets in Wireshark
  18 * How to view packets in Wireshark
  19 * How to filter packets in Wireshark
  20 * ... and many other things!
  21
  22 [[ChUseStartSection]]
  23
  24 === Start Wireshark
  25
  26 You can start Wireshark from your shell or window manager.
  27
  28 [TIP]
  29 .Power user tip
  30 ====
  31 When starting Wireshark it's possible to specify optional settings using the
  32 command line. See <<ChCustCommandLine>> for details.
  33 ====
  34
  35 In the following chapters a lot of screenshots from Wireshark will be shown. As
  36 Wireshark runs on many different platforms with many different window managers,
  37 different styles applied and there are different versions of the underlying GUI
  38 toolkit used, your screen might look different from the provided screenshots.
  39 But as there are no real differences in functionality these screenshots should
  40 still be well understandable.
  41
  42 [[ChUseMainWindowSection]]
  43
  44 === The Main window
  45
  46 Let's look at Wireshark's user interface. <<ChUseFig01>> shows Wireshark as you
  47 would usually see it after some packets are captured or loaded (how to do this
  48 will be described later).
  49
  50 [[ChUseFig01]]
  51 .The Main window
  52 image::wsug_graphics/ws-main.png[{screenshot-attrs}]
  53
  54 Wireshark's main window consists of parts that are commonly known from many
  55 other GUI programs.
  56
  57 . The _menu_ (see <<ChUseMenuSection>>) is used to start actions.
  58 . The _main toolbar_ (see <<ChUseMainToolbarSection>>) provides quick access to
  59   frequently used items from the menu.
  60 . The _filter toolbar_ (see <<ChUseFilterToolbarSection>>) provides a way to
  61   directly manipulate the currently used display filter (see
  62   <<ChWorkDisplayFilterSection>>).
  63 . The _packet list pane_ (see <<ChUsePacketListPaneSection>>) displays a summary
  64   of each packet captured. By clicking on packets in this pane you control what is
  65   displayed in the other two panes.
  66 . The _packet details pane_ (see <<ChUsePacketDetailsPaneSection>>) displays the
  67   packet selected in the packet list pane in more detail.
  68 . The _packet bytes pane_ (see <<ChUsePacketBytesPaneSection>>) displays the
  69   data from the packet selected in the packet list pane, and highlights the field
  70   selected in the packet details pane.
  71 . The _statusbar_ (see <<ChUseStatusbarSection>>) shows some detailed
  72   information about the current program state and the captured data.
  73
  74 [TIP]
  75 ====
  76 The layout of the main window can be customized by changing preference settings.
  77 See <<ChCustPreferencesSection>> for details!
  78 ====
  79
  80 [[ChUseMainWindowNavSection]]
  81
  82 ==== Main Window Navigation
  83
  84 Packet list and detail navigation can be done entirely from the keyboard.
  85 <<ChUseTabNav>> shows a list of keystrokes that will let you quickly move around
  86 a capture file. See <<ChUseTabGo>> for additional navigation keystrokes.
  87
  88 [[ChUseTabNav]]
  89 .Keyboard Navigation
  90 [options="header",cols="1,3"]
  91 |===============
  92 |Accelerator               |Description
  93 |kbd:[Tab], kbd:[Shift+Tab]|Move between screen elements, e.g. from the toolbars to the packet list to the packet detail.
  94 |kbd:[Down]                |Move to the next packet or detail item.
  95 |kbd:[Up]                  |Move to the previous packet or detail item.
  96 |kbd:[Ctrl+Down], kbd:[F8] |Move to the next packet, even if the packet list isn't focused.
  97 |kbd:[Ctrl+Up], kbd:[F7]   |Move to the previous packet, even if the packet list isn't focused.
  98 |kbd:[Ctrl+.]              |Move to the next packet of the conversation (TCP, UDP or IP).
  99 |kbd:[Ctrl+&#x2c;]         |Move to the previous packet of the conversation (TCP, UDP or IP).
 100 |kbd:[Alt+Right] or kbd:[Option+Right] (macOS) |Move to the next packet in the selection history.
 101 |kbd:[Alt+Left] or kbd:[Option+Right] (macOS)  |Move to the previous packet in the selection history.
 102 |kbd:[Left]                |In the packet detail, closes the selected tree item. If it's already closed, jumps to the parent node.
 103 |kbd:[Right]               |In the packet detail, opens the selected tree item.
 104 |kbd:[Shift+Right]         |In the packet detail, opens the selected tree item and all of its subtrees.
 105 |kbd:[Ctrl+Right]          |In the packet detail, opens all tree items.
 106 |kbd:[Ctrl+Left]           |In the packet detail, closes all tree items.
 107 |kbd:[Backspace]           |In the packet detail, jumps to the parent node.
 108 |kbd:[Return], kbd:[Enter] |In the packet detail, toggles the selected tree item.
 109 |===============
 110
 111 menu:Help[About Wireshark,Keyboard Shortcuts] will show a list of all shortcuts
 112 in the main window. Additionally, typing anywhere in the main window will start
 113 filling in a display filter.
 114
 115 [[ChUseMenuSection]]
 116
 117 === The Menu
 118
 119 Wireshark's main menu is located either at the top of the main window (Windows,
 120 Linux) or at the top of your main screen (macOS). An example is shown in
 121 <<ChUseWiresharkMenu>>.
 122
 123 [NOTE]
 124 ====
 125 Some menu items will be disabled (greyed out) if the corresponding feature isn't
 126 available. For example, you cannot save a capture file if you haven't captured
 127 or loaded any packets.
 128 ====
 129
 130 [[ChUseWiresharkMenu]]
 131 .The Menu
 132 image::wsug_graphics/ws-menu.png[{screenshot-attrs}]
 133
 134 The main menu contains the following items:
 135
 136 menu:File[]::
 137 This menu contains items to open and merge capture files, save, print, or export
 138 capture files in whole or in part, and to quit the Wireshark application. See
 139 <<ChUseFileMenuSection>>.
 140
 141 menu:Edit[]::
 142 This menu contains items to find a packet, time reference or mark one or more
 143 packets, handle configuration profiles, and set your preferences; (cut, copy,
 144 and paste are not presently implemented). See <<ChUseEditMenuSection>>.
 145
 146 menu:View[]::
 147 This menu controls the display of the captured data, including colorization of
 148 packets, zooming the font, showing a packet in a separate window, expanding and
 149 collapsing trees in packet details, .... See <<ChUseViewMenuSection>>.
 150
 151 menu:Go[]::
 152 This menu contains items to go to a specific packet. See <<ChUseGoMenuSection>>.
 153
 154 menu:Capture[]::
 155 This menu allows you to start and stop captures and to edit capture filters. See
 156 <<ChUseCaptureMenuSection>>.
 157
 158 menu:Analyze[]::
 159 This menu contains items to manipulate display filters, enable or disable the
 160 dissection of protocols, configure user specified decodes and follow a TCP
 161 stream. See <<ChUseAnalyzeMenuSection>>.
 162
 163 menu:Statistics[]::
 164 This menu contains items to display various statistic windows, including a
 165 summary of the packets that have been captured, display protocol hierarchy
 166 statistics and much more. See <<ChUseStatisticsMenuSection>>.
 167
 168 menu:Telephony[]::
 169 This menu contains items to display various telephony related statistic windows,
 170 including a media analysis, flow diagrams, display protocol hierarchy statistics
 171 and much more. See <<ChUseTelephonyMenuSection>>.
 172
 173 menu:Wireless[]::
 174 The items in this menu show Bluetooth and IEEE 802.11 wireless statistics.
 175
 176 menu:Tools[]::
 177 This menu contains various tools available in Wireshark, such as creating
 178 Firewall ACL Rules. See <<ChUseToolsMenuSection>>.
 179
 180 menu:Help[]::
 181 This menu contains items to help the user, e.g. access to some basic help,
 182 manual pages of the various command line tools, online access to some of the
 183 webpages, and the usual about dialog. See <<ChUseHelpMenuSection>>.
 184
 185 Each of these menu items is described in more detail in the sections that follow.
 186
 187 [TIP]
 188 .Shortcuts make life easier
 189 ====
 190 Most common menu items have keyboard shortcuts. For example, you can
 191 press the Control (or Strg in German) and the K keys together to open the
 192 ``Capture Options'' dialog.
 193 ====
 194
 195 [[ChUseFileMenuSection]]
 196
 197 === The ``File'' menu
 198
 199 The Wireshark file menu contains the fields shown in <<ChUseTabFile>>.
 200
 201 [[ChUseWiresharkFileMenu]]
 202 .The ``File'' Menu
 203 image::wsug_graphics/ws-file-menu.png[{screenshot-attrs}]
 204
 205 [[ChUseTabFile]]
 206 .File menu items
 207 [options="header",cols="3,2,5"]
 208 |===============
 209 |Menu Item                            |Accelerator |Description
 210
 211 |menu:Open...[]                       |kbd:[Ctrl+O]|
 212 This shows the file open dialog box that allows you to load a
 213 capture file for viewing. It is discussed in more detail in <<ChIOOpen>>.
 214
 215 |menu:Open Recent[]                   |            |
 216 This lets you open recently opened capture files.
 217 Clicking on one of the submenu items will open the corresponding capture file
 218 directly.
 219
 220 |menu:Merge...[]                      |            |
 221 This menu item lets you merge a capture file into the currently loaded one. It
 222 is discussed in more detail in <<ChIOMergeSection>>.
 223
 224 |menu:Import from Hex Dump...[]       |            |
 225 This menu item brings up the import file dialog box that allows you to import a
 226 text file containing a hex dump into a new temporary capture. It is discussed in
 227 more detail in <<ChIOImportSection>>.
 228
 229 |menu:Close[]                         |kbd:[Ctrl+W]|
 230 This menu item closes the current capture. If you haven't saved the capture, you
 231 will be asked to do so first (this can be disabled by a preference setting).
 232
 233 |menu:Save[]                          |kbd:[Ctrl+S]|
 234 This menu item saves the current capture. If you have not set a default capture
 235 file name (perhaps with the -w &lt;capfile&gt; option), Wireshark pops up the
 236 Save Capture File As dialog box (which is discussed further in <<ChIOSaveAs>>).
 237
 238 If you have already saved the current capture, this menu item will be greyed
 239 out.
 240
 241 You cannot save a live capture while the capture is in progress. You must
 242 stop the capture in order to save.
 243
 244 |menu:Save As...[]                    |kbd:[Shift+Ctrl+S]|
 245 This menu item allows you to save the current capture file to whatever file you
 246 would like. It pops up the Save Capture File As dialog box (which is discussed
 247 further in <<ChIOSaveAs>>).
 248
 249 |menu:File Set[List Files]            ||
 250 This menu item allows you to show a list of files in a file set. It pops up the
 251 Wireshark List File Set dialog box (which is discussed further in
 252 <<ChIOFileSetSection>>).
 253
 254 |menu:File Set[Next File]             ||
 255 If the currently loaded file is part of a file set, jump to the next file in the
 256 set. If it isn't part of a file set or just the last file in that set, this item
 257 is greyed out.
 258
 259 |menu:File Set[Previous File]         ||
 260 If the currently loaded file is part of a file set, jump to the previous file in
 261 the set. If it isn't part of a file set or just the first file in that set, this
 262 item is greyed out.
 263
 264 |menu:Export Specified Packets...[]                 ||
 265 This menu item allows you to export all (or some) of the packets in the capture
 266 file to file. It pops up the Wireshark Export dialog box (which is discussed
 267 further in <<ChIOExportSection>>).
 268
 269 |menu:Export Packet Dissections...[]|kbd:[Ctrl+H]|
 270 These menu items allow you to export the currently selected bytes in the packet
 271 bytes pane to a text file file in a number of formats including plain, CSV,
 272 and XML. It is discussed further in <<ChIOExportSelectedDialog>>.
 273
 274 |menu:Export Objects[]           ||
 275 These menu items allow you to export captured DICOM, HTTP, SMB, or TFTP objects
 276 into local files. It pops up a corresponding object list (which is discussed
 277 further in <<ChIOExportObjectsDialog>>)
 278
 279 |menu:Print...[]                      |kbd:[Ctrl+P]|
 280 This menu item allows you to print all (or some) of the packets in the capture
 281 file. It pops up the Wireshark Print dialog box (which is discussed further in
 282 <<ChIOPrintSection>>).
 283
 284 |menu:Quit[]                          |kbd:[Ctrl+Q]|
 285 This menu item allows you to quit from Wireshark. Wireshark will ask to save
 286 your capture file if you haven't previously saved it (this can be disabled by a
 287 preference setting).
 288
 289 |===============
 290
 291 [[ChUseEditMenuSection]]
 292
 293 === The ``Edit'' menu
 294
 295 The Wireshark Edit menu contains the fields shown in <<ChUseTabEdit>>.
 296
 297 [[ChUseWiresharkEditMenu]]
 298 .The ``Edit'' Menu
 299 image::wsug_graphics/ws-edit-menu.png[{screenshot-attrs}]
 300
 301 [[ChUseTabEdit]]
 302 .Edit menu items
 303 [options="header",cols="3,2,5"]
 304 |===============
 305 |Menu Item                                    |Accelerator       |Description
 306 |menu:Copy[]                                  ||
 307 These menu items will copy the packet list, packet detail, or properties of
 308 the currently selected packet to the clipboard.
 309
 310 |menu:Find Packet...[]                        |kbd:[Ctrl+F]      |
 311 This menu item brings up a toolbar that allows you to find a packet by many
 312 criteria. There is further information on finding packets in
 313 <<ChWorkFindPacketSection>>.
 314
 315 |menu:Find Next[]                             |kbd:[Ctrl+N]      |
 316 This menu item tries to find the next packet matching the settings from ``Find
 317 Packet...''.
 318
 319 |menu:Find Previous[]                         |kbd:[Ctrl+B]      |
 320 This menu item tries to find the previous packet matching the settings from
 321 ``Find Packet...''.
 322
 323 |menu:Mark/Unmark Packet[]                    |kbd:[Ctrl+M]      |
 324 This menu item marks the currently selected packet. See
 325 <<ChWorkMarkPacketSection>> for details.
 326
 327 |menu:Mark All Displayed Packets[]            |kbd:[Shift+Ctrl+M]|
 328 This menu item marks all displayed packets.
 329
 330 |menu:Unmark All Displayed Packets[]          |kbd:[Ctrl+Alt+M]  |
 331 This menu item unmarks all displayed packets.
 332
 333 |menu:Next Mark[]                             |kbd:[Shift+Alt+N] |
 334 Find the next marked packet.
 335
 336 |menu:Previous Mark[]                         |kbd:[Shift+Alt+B] |
 337 Find the previous marked packet.
 338
 339 |menu:Ignore/Unignore Packet[]                |kbd:[Ctrl+D]      |
 340 This menu item marks the currently selected packet as ignored. See
 341 <<ChWorkIgnorePacketSection>> for details.
 342
 343 |menu:Ignore All Displayed[]                  |kbd:[Shift+Ctrl+D]|
 344 This menu item marks all displayed packets as ignored.
 345
 346 |menu:Unignore All Displayed[]                |kbd:[Ctrl+Alt+D]  |
 347 This menu item unmarks all ignored packets.
 348
 349 |menu:Set/Unset Time Reference[]              |kbd:[Ctrl+T]      |
 350 This menu item set a time reference on the currently selected packet. See
 351 <<ChWorkTimeReferencePacketSection>> for more information about the time
 352 referenced packets.
 353
 354 |menu:Unset All Time References[]             |kbd:[Ctrl+Alt+T]  |
 355 This menu item removes all time references on the packets.
 356
 357 |menu:Next Time Reference[]                   |kbd:[Ctrl+Alt+N]  |
 358 This menu item tries to find the next time referenced packet.
 359
 360 |menu:Previous Time Reference[]               |kbd:[Ctrl+Alt+B]  |
 361 This menu item tries to find the previous time referenced packet.
 362
 363 |menu:Time Shift[]               |kbd:[Ctrl+Shift+T]  |
 364 This will show the Time Shift dialog, which allows you to adjust the
 365 timestamps of some or all packets.
 366
 367 |menu:Packet Comment...[]               ||
 368 This will let you add a comment to a single packet. Note that the ability
 369 to save packet comments depends on your file format. E.g. pcapng supports
 370 comments, pcap does not.
 371
 372 |menu:Capture Comment...[]               ||
 373 This will let you add a capture comment. Note that the ability to save
 374 capture comments depends on your file format. E.g. pcapng supports
 375 comments, pcap does not.
 376
 377 |menu:Configuration Profiles...[]             |kbd:[Shift+Ctrl+A]|
 378 This menu item brings up a dialog box for handling configuration profiles.  More
 379 detail is provided in <<ChCustConfigProfilesSection>>.
 380
 381 |menu:Preferences...[]                        |kbd:[Shift+Ctrl+P] or kbd:[Cmd+,] (macOS)|
 382 This menu item brings up a dialog box that allows you to set preferences for
 383 many parameters that control Wireshark.  You can also save your preferences so
 384 Wireshark will use them the next time you start it. More detail is provided in
 385 <<ChCustPreferencesSection>>.
 386
 387 |===============
 388
 389 [[ChUseViewMenuSection]]
 390
 391 === The ``View'' menu
 392
 393 The Wireshark View menu contains the fields shown in <<ChUseTabView>>.
 394
 395 [[ChUseWiresharkViewMenu]]
 396 .The ``View'' Menu
 397 image::wsug_graphics/ws-view-menu.png[{screenshot-attrs}]
 398
 399 [[ChUseTabView]]
 400 .View menu items
 401 [options="header",cols="3,2,5"]
 402 |===============
 403 |Menu Item              |Accelerator|Description
 404 |menu:Main Toolbar[]    ||This menu item hides or shows the main toolbar, see <<ChUseMainToolbarSection>>.
 405 |menu:Filter Toolbar[]  ||This menu item hides or shows the filter toolbar, see <<ChUseFilterToolbarSection>>.
 406 |menu:Wireless Toolbar[]||This menu item hides or shows the wireless toolbar. May not be present on some platforms.
 407 |menu:Statusbar[]       ||This menu item hides or shows the statusbar, see <<ChUseStatusbarSection>>.
 408 |menu:Packet List[]     ||This menu item hides or shows the packet list pane, see <<ChUsePacketListPaneSection>>.
 409 |menu:Packet Details[]  ||This menu item hides or shows the packet details pane, see <<ChUsePacketDetailsPaneSection>>.
 410 |menu:Packet Bytes[]    ||This menu item hides or shows the packet bytes pane, see <<ChUsePacketBytesPaneSection>>.
 411 |menu:Time Display Format[Date and Time of Day: 1970-01-01 01:02:03.123456]|| Selecting this tells Wireshark to display the time stamps in date and time of day format, see <<ChWorkTimeFormatsSection>>.
 412
 413 The fields "Time of Day", "Date and Time of Day", "Seconds Since Beginning of
 414 Capture", "Seconds Since Previous Captured Packet" and "Seconds Since Previous
 415 Displayed Packet" are mutually exclusive.
 416
 417 |menu:Time Display Format[Time of Day: 01:02:03.123456]||Selecting this tells Wireshark to display time stamps in time of day format, see <<ChWorkTimeFormatsSection>>.
 418 |menu:Time Display Format[Seconds Since Epoch (1970-01-01): 1234567890.123456]||Selecting this tells Wireshark to display time stamps in seconds since 1970-01-01 00:00:00, see <<ChWorkTimeFormatsSection>>.
 419 |menu:Time Display Format[Seconds Since Beginning of Capture: 123.123456]||Selecting this tells Wireshark to display time stamps in seconds since beginning of capture format, see <<ChWorkTimeFormatsSection>>.
 420 |menu:Time Display Format[Seconds Since Previous Captured Packet: 1.123456]||Selecting this tells Wireshark to display time stamps in seconds since previous captured packet format, see <<ChWorkTimeFormatsSection>>.
 421 |menu:Time Display Format[Seconds Since Previous Displayed Packet: 1.123456]||Selecting this tells Wireshark to display time stamps in seconds since previous displayed packet format, see <<ChWorkTimeFormatsSection>>.
 422 |menu:Time Display Format[Automatic (File Format Precision)]||Selecting this tells Wireshark to display time stamps with the precision given by the capture file format used, see <<ChWorkTimeFormatsSection>>.
 423
 424 The fields "Automatic", "Seconds" and "...seconds" are mutually exclusive.
 425
 426 |menu:Time Display Format[Seconds: 0]||Selecting this tells Wireshark to display time stamps with a precision of one second, see <<ChWorkTimeFormatsSection>>.
 427 |menu:Time Display Format[...seconds: 0....]||Selecting this tells Wireshark to display time stamps with a precision of one second, decisecond, centisecond, millisecond, microsecond or nanosecond, see <<ChWorkTimeFormatsSection>>.
 428 |menu:Time Display Format[Display Seconds with hours and minutes]||Selecting this tells Wireshark to display time stamps in seconds, with hours and minutes.
 429 |menu:Name Resolution[Resolve Name]||This item allows you to trigger a name resolve of the current packet only, see <<ChAdvNameResolutionSection>>.
 430 |menu:Name Resolution[Enable for MAC Layer]||This item allows you to control whether or not Wireshark translates MAC addresses into names, see <<ChAdvNameResolutionSection>>.
 431 |menu:Name Resolution[Enable for Network Layer]||This item allows you to control whether or not Wireshark translates network addresses into names, see <<ChAdvNameResolutionSection>>.
 432 |menu:Name Resolution[Enable for Transport Layer]||This item allows you to control whether or not Wireshark translates transport addresses into names, see <<ChAdvNameResolutionSection>>.
 433 |menu:Colorize Packet List[]||This item allows you to control whether or not Wireshark should colorize the packet list.
 434
 435 Enabling colorization will slow down the display of new packets while capturing / loading capture files.
 436
 437 |menu:Auto Scroll in Live Capture[] |                   |This item allows you to specify that Wireshark should scroll the packet list pane as new packets come in, so you are always looking at the last packet.  If you do not specify this, Wireshark simply adds new packets onto the end of the list, but does not scroll the packet list pane.
 438 |menu:Zoom In[]                     |kbd:[Ctrl+&#x2b;]  | Zoom into the packet data (increase the font size).
 439 |menu:Zoom Out[]                    |kbd:[Ctrl+-]       | Zoom out of the packet data (decrease the font size).
 440 |menu:Normal Size[]                 |kbd:[Ctrl+=]       | Set zoom level back to 100% (set font size back to normal).
 441 |menu:Resize All Columns[]          |kbd:[Shift+Ctrl+R] | Resize all column widths so the content will fit into it.
 442
 443 Resizing may take a significant amount of time, especially if a large capture file is loaded.
 444
 445 |menu:Displayed Columns[]                           |                   |This menu items folds out with a list of all configured columns. These columns can now be shown or hidden in the packet list.
 446 |menu:Expand Subtrees[]                             |kbd:[Shift+&#x2192;]|This menu item expands the currently selected subtree in the packet details tree.
 447 |menu:Collapse Subtrees[]                           |kbd:[Shift+&#x2190;]|This menu item collapses the currently selected subtree in the packet details tree.
 448 |menu:Expand All[]                                  |kbd:[Ctrl+&#x2192;] |Wireshark keeps a list of all the protocol subtrees that are expanded, and uses it to ensure that the correct subtrees are expanded when you display a packet. This menu item expands all subtrees in all packets in the capture.
 449 |menu:Collapse All[]                                |kbd:[Ctrl+&#x2190;] |This menu item collapses the tree view of all packets in the capture list.
 450 |menu:Colorize Conversation[]                       |                   |This menu item brings up a submenu that allows you to color packets in the packet list pane based on the addresses of the currently selected packet. This makes it easy to distinguish packets belonging to different conversations. <<ChCustColorizationSection>>.
 451 |menu:Colorize Conversation[Color 1-10]             |                   |These menu items enable one of the ten temporary color filters based on the currently selected conversation.
 452 |menu:Colorize Conversation[Reset coloring]         |                   |This menu item clears all temporary coloring rules.
 453 |menu:Colorize Conversation[New Coloring Rule...]   |                   |This menu item opens a dialog window in which a new permanent coloring rule can be created based on the currently selected conversation.
 454 |menu:Coloring Rules...[]                           |                   |This menu item brings up a dialog box that allows you to color packets in the packet list pane according to filter expressions you choose. It can be very useful for spotting certain types of packets, see <<ChCustColorizationSection>>.
 455 |menu:Show Packet in New Window[]                   |                   |This menu item brings up the selected packet in a separate window. The separate window shows only the tree view and byte view panes.
 456 |menu:Reload[]                                      |kbd:[Ctrl+R]       |This menu item allows you to reload the current capture file.
 457 |===============
 458
 459 [[ChUseGoMenuSection]]
 460
 461 === The ``Go'' menu
 462
 463 The Wireshark Go menu contains the fields shown in <<ChUseTabGo>>.
 464
 465 [[ChUseWiresharkGoMenu]]
 466 .The ``Go'' Menu
 467 image::wsug_graphics/ws-go-menu.png[{screenshot-attrs}]
 468
 469 [[ChUseTabGo]]
 470 .Go menu items
 471 [options="header",cols="3,2,5"]
 472 |===============
 473 |Menu Item                              |Accelerator        |Description
 474 |menu:Back[]                            |kbd:[Alt+&#x2190;] |Jump to the recently visited packet in the packet history, much like the page history in a web browser.
 475 |menu:Forward[]                         |kbd:[Alt+&#x2192;] |Jump to the next visited packet in the packet history, much like the page history in a web browser.
 476 |menu:Go to Packet...[]                 |kbd:[Ctrl+G]       |Bring up a window frame that allows you to specify a packet number, and then goes to that packet. See <<ChWorkGoToPacketSection>> for details.
 477 |menu:Go to Corresponding Packet[]      |                   |Go to the corresponding packet of the currently selected protocol field. If the selected field doesn't correspond to a packet, this item is greyed out.
 478 |menu:Previous Packet[]                 |kbd:[Ctrl+&#x2191;]|Move to the previous packet in the list.  This can be used to move to the previous packet even if the packet list doesn't have keyboard focus.
 479 |menu:Next Packet[]                     |kbd:[Ctrl+&#x2193;]|Move to the next packet in the list.  This can be used to move to the previous packet even if the packet list doesn't have keyboard focus.
 480 |menu:First Packet[]                    |kbd:[Ctrl+Home]    |Jump to the first packet of the capture file.
 481 |menu:Last Packet[]                     |kbd:[Ctrl+End]     |Jump to the last packet of the capture file.
 482 |menu:Previous Packet In Conversation[] |kbd:[Ctrl+&#x2c;]  |Move to the previous packet in the current conversation.  This can be used to move to the previous packet even if the packet list doesn't have keyboard focus.
 483 |menu:Next Packet In Conversation[]     |kbd:[Ctrl+.]       |Move to the next packet in the current conversation.  This can be used to move to the previous packet even if the packet list doesn't have keyboard focus.
 484 |===============
 485
 486 [[ChUseCaptureMenuSection]]
 487
 488 === The ``Capture'' menu
 489
 490 The Wireshark Capture menu contains the fields shown in <<ChUseTabCap>>.
 491
 492 [[ChUseWiresharkCaptureMenu]]
 493 .The ``Capture'' Menu
 494 image::wsug_graphics/ws-capture-menu.png[{screenshot-attrs}]
 495
 496 [[ChUseTabCap]]
 497 .Capture menu items
 498 [options="header",cols="3,2,5"]
 499 |===============
 500 |Menu Item                  |Accelerator    |Description
 501 |menu:Interfaces...[]       |kbd:[Ctrl+I]   |This menu item brings up a dialog box that shows what's going on at the network interfaces Wireshark knows of, see <<ChCapInterfaceSection>>) .
 502 |menu:Options...[]          |kbd:[Ctrl+K]   |This menu item brings up the Capture Options dialog box (discussed further in <<ChCapCaptureOptions>>) and allows you to start capturing packets.
 503 |menu:Start[]               |kbd:[Ctrl+E]   |Immediately start capturing packets with the same settings than the last time.
 504 |menu:Stop[]                |kbd:[Ctrl+E]   |This menu item stops the currently running capture, see <<ChCapStopSection>>) .
 505 |menu:Restart[]             |kbd:[Ctrl+R]   |This menu item stops the currently running capture and starts again with the same options, this is just for convenience.
 506 |menu:Capture Filters...[]  |               |This menu item brings up a dialog box that allows you to create and edit capture filters. You can name filters, and you can save them for future use. More detail on this subject is provided in <<ChWorkDefineFilterSection>>
 507 |===============
 508
 509 [[ChUseAnalyzeMenuSection]]
 510
 511 === The ``Analyze'' menu
 512
 513 The Wireshark Analyze menu contains the fields shown in <<ChUseAnalyze>>.
 514
 515 [[ChUseWiresharkAnalyzeMenu]]
 516 .The ``Analyze'' Menu
 517 image::wsug_graphics/ws-analyze-menu.png[{screenshot-attrs}]
 518
 519 [[ChUseAnalyze]]
 520 .Analyze menu items
 521 [options="header",cols="3,2,5"]
 522 |===============
 523 |Menu Item|Accelerator|Description
 524 |menu:Display Filters...[]          ||This menu item brings up a dialog box that allows you to create and edit display filters. You can name filters, and you can save them for future use. More detail on this subject is provided in <<ChWorkDefineFilterSection>>
 525 |menu:Display Filter Macros...[]    ||This menu item brings up a dialog box that allows you to create and edit display filter macros. You can name filter macros, and you can save them for future use. More detail on this subject is provided in <<ChWorkDefineFilterMacrosSection>>
 526 |menu:Apply as Column[]             ||This menu item adds the selected protocol item in the packet details pane as a column to the packet list.
 527 |menu:Apply as Filter[...]          ||These menu items will change the current display filter and apply the changed filter immediately. Depending on the chosen menu item, the current display filter string will be replaced or appended to by the selected protocol field in the packet details pane.
 528 |menu:Prepare a Filter[...]         ||These menu items will change the current display filter but won't apply the changed filter. Depending on the chosen menu item, the current display filter string will be replaced or appended to by the selected protocol field in the packet details pane.
 529 |menu:Enabled Protocols...[]        |kbd:[Shift+Ctrl+E]|This menu item allows the user to enable/disable protocol dissectors, see <<ChAdvEnabledProtocols>>
 530 |menu:Decode As...[]                ||This menu item allows the user to force Wireshark to decode certain packets as a particular protocol, see <<ChAdvDecodeAs>>
 531 |menu:User Specified Decodes...[]   ||This menu item allows the user to force Wireshark to decode certain packets as a particular protocol, see <<ChAdvDecodeAsShow>>
 532 |menu:Follow TCP Stream[]           ||This menu item brings up a separate window and displays all the TCP segments captured that are on the same TCP connection as a selected packet, see <<ChAdvFollowTCPSection>>
 533 |menu:Follow UDP Stream[]           ||Same functionality as ``Follow TCP Stream'' but for UDP streams.
 534 |menu:Follow SSL Stream[]           ||Same functionality as ``Follow TCP Stream'' but for SSL streams. See the wiki page on link:{wireshark-wiki-url}SSL[SSL] for instructions on providing SSL keys.
 535 |menu:Expert Info[]                 ||Open a dialog showing some expert information about the captured packets. The amount of information will depend on the protocol and varies from  very detailed to non-existent. XXX - add a new section about this and link from here
 536 |menu:Conversation Filter[...]      ||In this menu you will find conversation filter for various protocols.
 537 |===============
 538
 539 [[ChUseStatisticsMenuSection]]
 540
 541 === The ``Statistics'' menu
 542
 543 The Wireshark Statistics menu contains the fields shown in <<ChUseStatistics>>.
 544
 545 [[ChUseWiresharkStatisticsMenu]]
 546 .The ``Statistics'' Menu
 547 image::wsug_graphics/ws-statistics-menu.png[{screenshot-attrs}]
 548
 549 All menu items will bring up a new window showing specific statistical information.
 550
 551 [[ChUseStatistics]]
 552 .Statistics menu items
 553 [options="header",cols="3,2,5"]
 554 |===============
 555 |Menu Item|Accelerator|Description
 556 |menu:Summary[]|| Show information about the data captured, see <<ChStatSummary>>.
 557 |menu:Protocol Hierarchy[]|| Display a hierarchical tree of protocol statistics, see <<ChStatHierarchy>>.
 558 |menu:Conversations[]|| Display a list of conversations (traffic between two endpoints), see <<ChStatConversationsWindow>>.
 559 |menu:Endpoints[]|| Display a list of endpoints (traffic to/from an address), see <<ChStatEndpointsWindow>>.
 560 |menu:Packet Lengths...[]||See <<ChStatXXX>>
 561 |menu:IO Graphs[]|| Display user specified graphs (e.g. the number of packets in the course of time), see <<ChStatIOGraphs>>.
 562 |menu:Service Response Time[]|| Display the time between a request and the corresponding response, see <<ChStatSRT>>.
 563 |menu:ANCP[]||See <<ChStatXXX>>
 564 |menu:Colledtd...[]||See <<ChStatXXX>>
 565 |menu:Compare...[]||See <<ChStatXXX>>
 566 |menu:Flow Graph...[]||See <<ChStatXXX>>
 567 |menu:HTTP[]||HTTP request/response statistics, see <<ChStatXXX>>
 568 |menu:IP Addresses...[]||See <<ChStatXXX>>
 569 |menu:IP Destinations...[]||See <<ChStatXXX>>
 570 |menu:IP Protocol Types...[]||See <<ChStatXXX>>
 571 |menu:ONC-RPC Programs[]||See <<ChStatXXX>>
 572 |menu:Sametime[]||See <<ChStatXXX>>
 573 |menu:TCP Stream Graph[]||See <<ChStatXXX>>
 574 |menu:UDP Multicast Streams[]||See <<ChStatXXX>>
 575 |menu:WLAN Traffic[]||See <<ChStatWLANTraffic>>
 576 |menu:BOOTP-DHCP[]||See <<ChStatXXX>>
 577
 578 |===============
 579
 580 [[ChUseTelephonyMenuSection]]
 581
 582 === The ``Telephony'' menu
 583
 584 The Wireshark Telephony menu contains the fields shown in <<ChUseTelephony>>.
 585
 586 [[ChUseWiresharkTelephonyMenu]]
 587 .The ``Telephony'' Menu
 588 image::wsug_graphics/ws-telephony-menu.png[{screenshot-attrs}]
 589
 590 All menu items will bring up a new window showing specific telephony related statistical information.
 591
 592 [[ChUseTelephony]]
 593 .Telephony menu items
 594 [options="header",cols="3,2,5"]
 595 |===============
 596 |Menu Item|Accelerator|Description
 597 |menu:IAX2[]||See <<ChTelXXX>>
 598 |menu:SMPP Operations...[]||See <<ChTelXXX>>
 599 |menu:SCTP[]||See <<ChTelXXX>>
 600 |menu:ANSI[]||See <<ChTelXXX>>
 601 |menu:GSM[]||See <<ChTelXXX>>
 602 |menu:H.225...[]||See <<ChTelXXX>>
 603 |menu:ISUP Messages...[]||See <<ChTelXXX>>
 604 |menu:LTE[]||See <<ChTelLTEMACTraffic>>
 605 |menu:MTP3[]||See <<ChTelXXX>>
 606 |menu:RTP[]||See <<ChTelRTPAnalysis>>
 607 |menu:SIP...[]||See <<ChTelXXX>>
 608 |menu:UCP Messages...[]||See <<ChTelXXX>>
 609 |menu:VoIP Calls...[]||See <<ChTelVoipCalls>>
 610 |menu:WAP-WSP...[]||See <<ChTelXXX>>
 611
 612 |===============
 613
 614 [[ChUseToolsMenuSection]]
 615
 616 === The ``Tools'' menu
 617
 618 The Wireshark Tools menu contains the fields shown in <<ChUseTools>>.
 619
 620 [[ChUseWiresharkToolsMenu]]
 621 .The ``Tools'' Menu
 622 image::wsug_graphics/ws-tools-menu.png[{screenshot-attrs}]
 623
 624 [[ChUseTools]]
 625 .Tools menu items
 626 [options="header",cols="3,2,5"]
 627 |===============
 628 |Menu Item|Accelerator|Description
 629 |menu:Firewall ACL Rules[]|| This allows you to create command-line ACL rules for many different firewall products, including Cisco IOS, Linux Netfilter (iptables), OpenBSD pf and Windows Firewall (via netsh).  Rules for MAC addresses, IPv4 addresses, TCP and UDP ports, and IPv4+port combinations are supported.
 630
 631 It is assumed that the rules will be applied to an outside interface.
 632
 633 |menu:Lua[]|| These options allow you to work with the Lua interpreter optionally build into Wireshark. See the ``Lua Support in Wireshark'' in the Wireshark Developer's Guide.
 634 |===============
 635
 636 [[ChUseInternalsMenuSection]]
 637
 638 === The ``Internals'' menu
 639
 640 The Wireshark Internals menu contains the fields shown in <<ChUseInternals>>.
 641
 642 [[ChUseWiresharkInternalsMenu]]
 643 .The ``Internals'' Menu
 644 image::wsug_graphics/ws-internals-menu.png[{screenshot-attrs}]
 645
 646 [[ChUseInternals]]
 647 .Internals menu items
 648 [options="header",cols="3,2,5"]
 649 |===============
 650 |Menu Item|Accelerator|Description
 651 |menu:Dissector tables[]|| This menu item brings up a dialog box showing the tables with subdissector relationships.
 652 |menu:Supported Protocols (slow!)[]|| This menu item brings up a dialog box showing the supported protocols and protocol fields.
 653 |===============
 654
 655 [[ChUseHelpMenuSection]]
 656
 657 === The ``Help'' menu
 658
 659 The Wireshark Help menu contains the fields shown in <<ChUseHelp>>.
 660
 661 [[ChUseWiresharkHelpMenu]]
 662 .The ``Help'' Menu
 663 image::wsug_graphics/ws-help-menu.png[{screenshot-attrs}]
 664
 665 [[ChUseHelp]]
 666 .Help menu items
 667 [options="header",cols="3,2,5"]
 668 |===============
 669 |Menu Item|Accelerator|Description
 670 |menu:Contents[]|F1| This menu item brings up a basic help system.
 671 |menu:Manual Pages[...]|| This menu item starts a Web browser showing one of the locally installed html manual pages.
 672 |menu:Website[]|| This menu item starts a Web browser showing the webpage from: link:{wireshark-main-url}[].
 673 |menu:FAQ's[]|| This menu item starts a Web browser showing various FAQ's.
 674 |menu:Downloads[]|| This menu item starts a Web browser showing the downloads from: link:{wireshark-download-url}[].
 675 |menu:Wiki[]|| This menu item starts a Web browser showing the front page from: link:{wireshark-wiki-url}[].
 676 |menu:Sample Captures[]|| This menu item starts a Web browser showing the sample captures from: link:{wireshark-wiki-url}SampleCaptures[].
 677 |menu:About Wireshark[]|| This menu item brings up an information window that provides various detailed information items on Wireshark, such as how it's build, the plugins loaded, the used folders, ...
 678
 679 |===============
 680
 681 [NOTE]
 682 ====
 683 Opening a Web browser might be unsupported in your version of Wireshark. If this
 684 is the case the corresponding menu items will be hidden.
 685
 686 If calling a Web browser fails on your machine, nothing happens, or the browser
 687 starts but no page is shown, have a look at the web browser setting in the
 688 preferences dialog.
 689 ====
 690
 691 [[ChUseMainToolbarSection]]
 692
 693 === The ``Main'' toolbar
 694
 695 The main toolbar provides quick access to frequently used items from the menu.
 696 This toolbar cannot be customized by the user, but it can be hidden using the
 697 View menu, if the space on the screen is needed to show even more packet data.
 698
 699 As in the menu, only the items useful in the current program state will be
 700 available. The others will be greyed out (e.g. you cannot save a capture file if
 701 you haven't loaded one).
 702
 703 [[ChUseWiresharkMainToolbar]]
 704
 705 .The ``Main'' toolbar
 706 image::wsug_graphics/ws-main-toolbar.png[{screenshot-attrs}]
 707
 708 [[ChUseMainToolbar]]
 709 .Main toolbar items
 710 [options="header",cols="1,2,2,4"]
 711 |===============
 712 |Toolbar Icon|Toolbar Item|Menu Item|Description
 713 |image:wsug_graphics/toolbar/capture_interfaces_24.png[{toolbar-icon-attrs}] |btn:[Interfaces...]|menu:Capture[Interfaces...]| This item brings up the Capture Interfaces List dialog box (discussed further in <<ChCapCapturingSection>>).
 714 |image:wsug_graphics/toolbar/capture_options_24.png[{toolbar-icon-attrs}]    |btn:[Options...]|menu:Capture[Options...]| This item brings up the Capture Options dialog box (discussed further in <<ChCapCapturingSection>>) and allows you to start capturing packets.
 715 |image:wsug_graphics/toolbar/capture_start_24.png[{toolbar-icon-attrs}]      |btn:[Start]|menu:Capture[Start]| This item starts capturing packets with the options from the last time.
 716 |image:wsug_graphics/toolbar/capture_stop_24.png[{toolbar-icon-attrs}]       |btn:[Stop]|menu:Capture[Stop]| This item stops the currently running live capture process <<ChCapCapturingSection>>).
 717 |image:wsug_graphics/toolbar/capture_restart_24.png[{toolbar-icon-attrs}]    |btn:[Restart]|menu:Capture[Restart]| This item stops the currently running live capture process and restarts it again, for convenience.
 718 |image:wsug_graphics/toolbar/stock_open_24.png[{toolbar-icon-attrs}]         |btn:[Open...]|menu:File[Open...]| This item brings up the file open dialog box that allows you to load a capture file for viewing. It is discussed in more detail in <<ChIOOpen>>.
 719 |image:wsug_graphics/toolbar/stock_save_as_24.png[{toolbar-icon-attrs}]      |btn:[Save As...]|menu:File[Save As...]| This item allows you to save the current capture file to whatever file you would like. It pops up the Save Capture File As dialog box (which is discussed further in <<ChIOSaveAs>>).
 720
 721 If you currently have a temporary capture file, the Save icon  will be shown instead.
 722
 723 |image:wsug_graphics/toolbar/stock_close_24.png[{toolbar-icon-attrs}]        |btn:[Close]|menu:File[Close]|This item closes the current capture. If you have not saved the capture, you will be asked to save it first.
 724 |image:wsug_graphics/toolbar/stock_refresh_24.png[{toolbar-icon-attrs}]      |btn:[Reload]|menu:View[Reload]| This item allows you to reload the current capture file.
 725 |image:wsug_graphics/toolbar/stock_print_24.png[{toolbar-icon-attrs}]        |btn:[Print...]|menu:File[Print...]| This item allows you to print all (or some of) the packets in the capture file. It pops up the Wireshark Print dialog box (which is discussed further in <<ChIOPrintSection>>).
 726 |image:wsug_graphics/toolbar/stock_search_24.png[{toolbar-icon-attrs}]       |btn:[Find Packet...]|menu:Edit[Find Packet...]|This item brings up a dialog box that allows you to find a packet. There is further information on finding packets in <<ChWorkFindPacketSection>>.
 727 |image:wsug_graphics/toolbar/stock_left_arrow_24.png[{toolbar-icon-attrs}]   |btn:[Go Back]|menu:Go[Go Back]|This item jumps back in the packet history. Hold down the Alt key (Option on macOS) to go back in the selection history.
 728 |image:wsug_graphics/toolbar/stock_right_arrow_24.png[{toolbar-icon-attrs}]  |btn:[Go Forward]|menu:Go[Go Forward]|This item jumps forward in the packet history. Hold down the Alt key (Option on macOS) to go forward in the selection history.
 729 |image:wsug_graphics/toolbar/stock_jump_to_24.png[{toolbar-icon-attrs}]      |btn:[Go to Packet...]|menu:Go[Go to Packet...]| This item brings up a dialog box that allows you to specify a packet number to go to that packet.
 730 |image:wsug_graphics/toolbar/stock_top_24.png[{toolbar-icon-attrs}]          |btn:[Go To First Packet]|menu:Go[First Packet]| This item jumps to the first packet of the capture file.
 731 |image:wsug_graphics/toolbar/stock_bottom_24.png[{toolbar-icon-attrs}]       |btn:[Go To Last Packet]|menu:Go[Last Packet]| This item jumps to the last packet of the capture file.
 732 |image:wsug_graphics/toolbar/colorize_24.png[{toolbar-icon-attrs}]           |btn:[Colorize]|menu:View[Colorize]| Colorize the packet list (or not).
 733 |image:wsug_graphics/toolbar/autoscroll_24.png[{toolbar-icon-attrs}]         |btn:[Auto Scroll in Live Capture]|menu:View[Auto Scroll in Live Capture]| Auto scroll packet list while doing a live capture (or not).
 734 |image:wsug_graphics/toolbar/stock_zoom_in_24.png[{toolbar-icon-attrs}]      |btn:[Zoom In]|menu:View[Zoom In]| Zoom into the packet data (increase the font size).
 735 |image:wsug_graphics/toolbar/stock_zoom_in_24.png[{toolbar-icon-attrs}]      |btn:[Zoom Out]|menu:View[Zoom Out]| Zoom out of the packet data (decrease the font size).
 736 |image:wsug_graphics/toolbar/stock_zoom_1_24.png[{toolbar-icon-attrs}]       |btn:[Normal Size]|menu:View[Normal Size]| Set zoom level back to 100%.
 737 |image:wsug_graphics/toolbar/resize_columns_24.png[{toolbar-icon-attrs}]     |btn:[Resize Columns]|menu:View[Resize Columns]| Resize columns, so the content fits into them.
 738 |image:wsug_graphics/toolbar/capture_filter_24.png[{toolbar-icon-attrs}]     |btn:[Capture Filters...]|menu:Capture[Capture Filters...]| This item brings up a dialog box that allows you to create and edit capture filters. You can name filters, and you can save them for future use. More detail on this subject is provided in <<ChWorkDefineFilterSection>>.
 739 |image:wsug_graphics/toolbar/display_filter_24.png[{toolbar-icon-attrs}]     |btn:[Display Filters...]|menu:Analyze[Display Filters...]| This item brings up a dialog box that allows you to create and edit display filters. You can name filters, and you can save them for future use. More detail on this subject is provided in <<ChWorkDefineFilterSection>>.
 740 |image:wsug_graphics/toolbar/stock_colorselector_24.png[{toolbar-icon-attrs}]|btn:[Coloring Rules...]|menu:View[Coloring Rules...]| This item brings up a dialog box that allows you to color packets in the packet list pane according to filter expressions you choose. It can be very useful for spotting certain types of packets. More detail on this subject is provided in <<ChCustColorizationSection>>.
 741 |image:wsug_graphics/toolbar/stock_preferences_24.png[{toolbar-icon-attrs}]  |btn:[Preferences...]|menu:Edit[Preferences]| This item brings up a dialog box that allows you to set preferences for many parameters that control Wireshark.  You can also save your preferences so Wireshark will use them the next time you start it. More detail is provided in <<ChCustPreferencesSection>>
 742 |image:wsug_graphics/toolbar/stock_help_24.png[{toolbar-icon-attrs}]         |btn:[Help]|menu:Help[Contents]| This item brings up help dialog box.
 743 |===============
 744
 745 [[ChUseFilterToolbarSection]]
 746
 747 === The ``Filter'' toolbar
 748
 749 The filter toolbar lets you quickly edit and apply display filters. More
 750 information on display filters is available in <<ChWorkDisplayFilterSection>>.
 751
 752 [[ChUseWiresharkFilterToolbar]]
 753
 754 .The ``Filter'' toolbar
 755 image::wsug_graphics/ws-filter-toolbar.png[{screenshot-attrs}]
 756
 757 [[ChUseFilterToolbar]]
 758 .Filter toolbar items
 759 [options="header",cols="1,2,4"]
 760 |===============
 761 |Toolbar Icon|Toolbar Item|Description
 762 |image:wsug_graphics/toolbar/display_filter_24.png[{toolbar-icon-attrs}]|btn:[Filter:]|Brings up the filter construction dialog, described in <<FiltersDialog>>.
 763 ||_Filter input_|The area to enter or edit a display filter string, see <<ChWorkBuildDisplayFilterSection>>. A syntax check of your filter string is done while you are typing. The background will turn red if you enter an incomplete or invalid string, and will become green when you enter a valid string. You can click on the pull down arrow to select a previously-entered filter string from a list. The entries in the pull down list will remain available even after a program restart.
 764
 765 After you've changed something in this field, don't forget to press the Apply
 766 button (or the Enter/Return key), to apply this filter string to the display.
 767
 768 This field is also where the current filter in effect is displayed.
 769
 770 |image:wsug_graphics/toolbar/stock_add_24.png[{toolbar-icon-attrs}]     |btn:[Expression...]|The middle button labeled "Add Expression..." opens a dialog box that lets you edit a display filter from a list of protocol fields, described in <<ChWorkFilterAddExpressionSection>>
 771 |image:wsug_graphics/toolbar/stock_clear_24.png[{toolbar-icon-attrs}]   |btn:[Clear]|Reset the current display filter and clears the edit area.
 772 |image:wsug_graphics/toolbar/stock_apply_20.png[{toolbar-icon-attrs}]   |btn:[Apply]|Apply the current value in the edit area as the new display filter.
 773
 774 Applying a display filter on large capture files might take quite a long time.
 775
 776 |===============
 777
 778 [[ChUsePacketListPaneSection]]
 779
 780 === The ``Packet List'' pane
 781
 782 The packet list pane displays all the packets in the current capture file.
 783
 784 [[ChUseWiresharkListPane]]
 785 .The ``Packet List'' pane
 786 image::wsug_graphics/ws-list-pane.png[{screenshot-attrs}]
 787
 788 Each line in the packet list corresponds to one packet in the capture file. If
 789 you select a line in this pane, more details will be displayed in the ``Packet
 790 Details'' and ``Packet Bytes'' panes.
 791
 792 While dissecting a packet, Wireshark will place information from the protocol
 793 dissectors into the columns. As higher level protocols might overwrite
 794 information from lower levels, you will typically see the information from the
 795 highest possible level only.
 796
 797 For example, let's look at a packet containing TCP inside IP inside an Ethernet
 798 packet. The Ethernet dissector will write its data (such as the Ethernet
 799 addresses), the IP dissector will overwrite this by its own (such as the IP
 800 addresses), the TCP dissector will overwrite the IP information, and so on.
 801
 802 There are a lot of different columns available. Which columns are displayed can
 803 be selected by preference settings, see <<ChCustPreferencesSection>>.
 804
 805 The default columns will show:
 806
 807 * btn:[No.] The number of the packet in the capture file. This number won't
 808   change, even if a display filter is used.
 809
 810 * btn:[Time] The timestamp of the packet. The presentation format of this
 811   timestamp can be changed, see <<ChWorkTimeFormatsSection>>.
 812
 813 * btn:[Source] The address where this packet is coming from.
 814
 815 * btn:[Destination] The address where this packet is going to.
 816
 817 * btn:[Protocol] The protocol name in a short (perhaps abbreviated) version.
 818
 819 * btn:[Length] The length of each packet.
 820
 821 * btn:[Info] Additional information about the packet content.
 822
 823 The first column shows how each packet is related to the selected packet. For
 824 example, in the image above the first packet is selected, which is a DNS
 825 request. Wireshark shows a rightward arrow for the request itself, followed by a
 826 leftward arrow for the response in packet 2. Why is there a dashed line? There
 827 are more DNS packets further down that use the same port numbers. Wireshark
 828 treats them as belonging to the same conversation and draws a line connecting
 829 them.
 830
 831 // Images were created on macOS 10.11 using a retina display. Lines were
 832 // 36 physical pixels high.
 833
 834 [horizontal]
 835 .Related packet symbols
 836
 837 image:wsug_graphics/related-first.png[{related-attrs}]::
 838   First packet in a conversation.
 839
 840 image:wsug_graphics/related-current.png[{related-attrs}]::
 841   Part of the selected conversation.
 842
 843 image:wsug_graphics/related-other.png[{related-attrs}]::
 844   _Not_ part of the selected conversation.
 845
 846 image:wsug_graphics/related-last.png[{related-attrs}]::
 847   Last packet in a conversation.
 848
 849 image:wsug_graphics/related-request.png[{related-attrs}]::
 850   Request.
 851
 852 image:wsug_graphics/related-response.png[{related-attrs}]::
 853   Response.
 854
 855 image:wsug_graphics/related-ack.png[{related-attrs}]::
 856   The selected packet acknowledges this packet.
 857
 858 image:wsug_graphics/related-dup-ack.png[{related-attrs}]::
 859   The selected packet is a duplicate acknowledgement of this packet.
 860
 861 image:wsug_graphics/related-segment.png[{related-attrs}]::
 862   The selected packet is related to this packet in some other way, e.g. as part
 863   of reassembly.
 864
 865 The packet list has an _Intelligent Scrollbar_ which shows a miniature map of
 866 nearby packets. Each https://en.wikipedia.org/wiki/Raster_graphics[raster line]
 867 of the scrollbar corresponds to a single packet, so the number of packets shown
 868 in the map depends on your physical display and the height of the packet list. A
 869 tall packet list on a high-resolution (``Retina'') display will show you quite a
 870 few packets. In the image above the scrollbar shows the status of more than 500
 871 packets along with the 15 shown in the packet list itself.
 872
 873 Right clicking will show a context menu, described in
 874 <<ChWorkPacketListPanePopUpMenu>>.
 875
 876 [[ChUsePacketDetailsPaneSection]]
 877
 878 === The ``Packet Details'' pane
 879
 880 The packet details pane shows the current packet (selected in the ``Packet List''
 881 pane) in a more detailed form.
 882
 883 [[ChUseWiresharkDetailsPane]]
 884
 885 .The ``Packet Details'' pane
 886 image::wsug_graphics/ws-details-pane.png[{screenshot-attrs}]
 887
 888 This pane shows the protocols and protocol fields of the packet selected in the
 889 ``Packet List'' pane. The protocols and fields of the packet shown in a tree
 890 which can be expanded and collapsed.
 891
 892 There is a context menu (right mouse click) available. See details in
 893 <<ChWorkPacketDetailsPanePopUpMenu>>.
 894
 895 Some protocol fields have special meanings.
 896
 897 * *Generated fields.* Wireshark itself will generate additional protocol
 898   information which isn't present in the captured data. This information is
 899   enclosed in square brackets (`[' and `]'). Generated information includes
 900   response times, TCP analysis, GeoIP information, and checksum validation.
 901
 902 * *Links.* If Wireshark detects a relationship to another packet in the capture
 903   file it will generate a link to that packet. Links are underlined and
 904   displayed in blue. If you double-clicked on a link  Wireshark will jump to the
 905   corresponding packet.
 906
 907 [[ChUsePacketBytesPaneSection]]
 908
 909 === The ``Packet Bytes'' pane
 910
 911 The packet bytes pane shows the data of the current packet (selected in the
 912 ``Packet List'' pane) in a hexdump style.
 913
 914 [[ChUseWiresharkBytesPane]]
 915
 916 .The ``Packet Bytes'' pane
 917 image::wsug_graphics/ws-bytes-pane.png[{screenshot-attrs}]
 918
 919 The ``Packet Bytes'' pane shows a canonical
 920 https://en.wikipedia.org/wiki/Hex_dump[hex dump] of the packet data. Each line
 921 contains the data offset, sixteen hexadecimal bytes, and sixteen ASCII bytes.
 922 Non-printalbe bytes are replaced with a period (`.').
 923
 924 Depending on the packet data, sometimes more than one page is available, e.g.
 925 when Wireshark has reassembled some packets into a single chunk of data. (See
 926 <<ChAdvReassemblySection>> for details). In this case you can see each data
 927 source by clicking its corresponding tab at the bottom of the pane.
 928
 929 [[ChUseWiresharkBytesPaneTabs]]
 930 .The ``Packet Bytes'' pane with tabs
 931 image::wsug_graphics/ws-bytes-pane-tabs.png[{screenshot-attrs}]
 932
 933 Additional pages typically contain data reassembled from multiple packets or
 934 decrypted data.
 935
 936 The context menu (right mouse click) of the tab labels will show a list of all
 937 available pages. This can be helpful if the size in the pane is too small for
 938 all the tab labels.
 939
 940 [[ChUseStatusbarSection]]
 941
 942 === The Statusbar
 943
 944 The statusbar displays informational messages.
 945
 946 In general, the left side will show context related information, the middle part
 947 will show information about the current capture file, and the right side will
 948 show the selected configuration profile. Drag the handles between the text areas
 949 to change the size.
 950
 951 [[ChUseWiresharkStatusbarEmpty]]
 952 .The initial Statusbar
 953 image::wsug_graphics/ws-statusbar-empty.png[{statusbar-attrs}]
 954
 955 This statusbar is shown while no capture file is loaded, e.g. when Wireshark is started.
 956
 957 [[ChUseWiresharkStatusbarLoaded]]
 958 .The Statusbar with a loaded capture file
 959 image::wsug_graphics/ws-statusbar-loaded.png[{statusbar-attrs}]
 960
 961 * *The colorized bullet* on the left shows the highest expert info level found
 962   in the currently loaded capture file. Hovering the mouse over this icon will
 963   show a textual description of the expert info level, and clicking the icon
 964   will bring up the Expert Infos dialog box. For a detailed description of
 965   expert info, see <<ChAdvExpert>>.
 966
 967 * *The left side* shows information about the capture file, its name, its size
 968   and the elapsed time while it was being captured. Hovering over a file name
 969   will show its full path and size.
 970
 971 * *The middle part* shows the current number of packets in the capture file. The
 972   following values are displayed:
 973
 974   - _Packets:_ The number of captured packets.
 975
 976   - _Displayed:_ The number of packets currently being displayed.
 977
 978   - _Marked:_ The number of marked packets (only displayed if packets are
 979   marked).
 980
 981   - _Dropped:_ The number of dropped packets (only displayed if Wireshark was
 982   unable to capture all packets).
 983
 984   - _Ignored:_ The number of ignored packets (only displayed if packets are
 985   ignored).
 986
 987   - _Load time:_ The time it took to load the capture (wall clock time).
 988
 989 * *The right side* shows the selected configuration profile. Clicking in this
 990   part of the statusbar will bring up a menu with all available configuration
 991   profiles, and selecting from this list will change the configuration profile.
 992
 993 [[ChUseWiresharkStatusbarProfile]]
 994 .The Statusbar with a configuration profile menu
 995 image::wsug_graphics/ws-statusbar-profile.png[{pdf-scaledwidth},height=192]
 996
 997 For a detailed description of configuration profiles, see <<ChCustConfigProfilesSection>>.
 998
 999 [[ChUseWiresharkStatusbarSelected]]
1000 .The Statusbar with a selected protocol field
1001 image::wsug_graphics/ws-statusbar-selected.png[{statusbar-attrs}]
1002
1003 This is displayed if you have selected a protocol field from the ``Packet
1004 Details'' pane.
1005
1006
1007 [TIP]
1008 ====
1009 The value between the parentheses (in this example `ipv6.src') can be used as a
1010 display filter, representing the selected protocol field.
1011 ====
1012
1013 [[ChUseWiresharkStatusbarFilter]]
1014
1015 .The Statusbar with a display filter message
1016 image::wsug_graphics/ws-statusbar-filter.png[{statusbar-attrs}]
1017
1018 This is displayed if you are trying to use a display filter which may have
1019 unexpected results. For a detailed description, see
1020 <<ChWorkBuildDisplayFilterMistake>>.
1021
1022 ++++++++++++++++++++++++++++++++++++++
1023 <!-- End of WSUG Chapter 3 -->
1024 ++++++++++++++++++++++++++++++++++++++