docbook/wsug_src/WSUG_app_messages.xml

   1 <!-- WSUG Appendix Messages -->
   2 <!-- $Id$ -->
   3
   4 <appendix id="AppMessages">
   5   <title>Wireshark Messages</title>
   6   <para>
   7   Wireshark provides you with additional information generated out of
   8   the plain packet data or it may need to indicate dissection problems.
   9   Messages generated by Wireshark are usually placed in [] parentheses.
  10   </para>
  11   <section id="AppMessagesList"><title>Packet List Messages</title>
  12     <para>
  13         These messages might appear in the packet list.
  14     </para>
  15   <section><title>[Malformed Packet]</title>
  16     <para>
  17         Malformed packet means that the protocol dissector can't dissect the
  18         contents of the packet any further. There can be various reasons:
  19       <itemizedlist>
  20         <listitem>
  21           <para>
  22                 <command>Wrong dissector</command>:
  23             Wireshark erroneously has chosen the wrong protocol dissector for
  24                 this packet. This will happen e.g. if you are using a protocol
  25                 not on its well known TCP or UDP port. You may try Analyze|Decode As
  26                 to circumvent this problem.
  27           </para>
  28         </listitem>
  29         <listitem>
  30           <para>
  31                 <command>Packet not reassembled</command>:
  32                 The packet is longer than a single frame and it is not reassembled,
  33                 see     <xref linkend="ChAdvReassemblySection"/> for further details.
  34           </para>
  35         </listitem>
  36         <listitem>
  37           <para>
  38                 <command>Packet is malformed</command>:
  39             The packet is actually wrong (malformed), meaning that a part of the
  40                 packet is just not as expected (not following the protocol
  41                 specifications).
  42           </para>
  43         </listitem>
  44         <listitem>
  45           <para>
  46                 <command>Dissector is buggy</command>:
  47             The corresponding protocol dissector is simply buggy or still
  48                 incomplete.
  49           </para>
  50         </listitem>
  51       </itemizedlist>
  52     </para>
  53     <para>
  54         Any of the above is possible. You'll have to look into the specific
  55         situation to determine the reason.
  56         You could disable the dissector by disabling the
  57         protocol on the Analyze menu and check how Wireshark displays the packet
  58         then. You could (if it's TCP) enable reassembly for TCP and the specific
  59         dissector (if possible) in the Edit|Preferences menu. You could check the
  60         packet contents yourself by reading the packet bytes and comparing it to
  61         the protocol specification. This could reveal a dissector bug. Or you
  62         could find out that the packet is indeed wrong.
  63     </para>
  64   </section>
  65   <section><title>[Packet size limited during capture]</title>
  66     <para>
  67         The packet size was limited during capture, see "Limit each packet to n
  68         bytes" at the <xref linkend="ChCapCaptureOptions"/>.
  69         While dissecting, the current protocol
  70         dissector was simply running out of packet bytes and had to give up.
  71         There's nothing else you can do now, except to repeat the whole capture
  72         process again with a higher (or no) packet size limitation.
  73     </para>
  74   </section>
  75   </section>
  76
  77   <section id="AppMessagesDetails"><title>Packet Details Messages</title>
  78     <para>
  79         These messages might appear in the packet details.
  80     </para>
  81   <section><title>[Response in frame: 123]</title>
  82     <para>
  83         The current packet is the request of a detected request/response pair.
  84         You can directly jump to the corresponding response packet just
  85         by double clicking on this message.
  86     </para>
  87   </section>
  88   <section><title>[Request in frame: 123]</title>
  89     <para>
  90         Same as "Response in frame: 123" above, but the other way round.
  91     </para>
  92   </section>
  93   <section><title>[Time from request: 0.123 seconds]</title>
  94     <para>
  95         The time between the request and the response packets.
  96     </para>
  97   </section>
  98   <section><title>[Stream setup by PROTOCOL (frame 123)]</title>
  99     <para>
 100         The session control protocol (SDP, H225, etc) message which signaled
 101         the creation of this session. You can directly jump to the
 102         corresponding packet just by double clicking on this message.
 103     </para>
 104   </section>
 105   </section>
 106
 107 </appendix>
 108 <!-- End of WSUG Appendix Messages -->