aboutsummaryrefslogtreecommitdiffstats
path: root/docbook/wsug_src/WSUG_app_messages.xml
blob: 67f42974b4d70f67c7e6e624e46ed42193b15ed0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
<!-- WSUG Appendix Messages -->

<appendix id="AppMessages">
  <title>Wireshark Messages</title>
  <para>
  Wireshark provides you with additional information generated out of 
  the plain packet data or it may need to indicate dissection problems.
  Messages generated by Wireshark are usually placed in [] parentheses.
  </para>
  <section id="AppMessagesList"><title>Packet List Messages</title>
    <para>
    These messages might appear in the packet list.
    </para>
  <section><title>[Malformed Packet]</title>
    <para>
    Malformed packet means that the protocol dissector can't dissect the 
    contents of the packet any further. There can be various reasons:
      <itemizedlist>
    <listitem>
      <para>
        <command>Wrong dissector</command>:
        Wireshark erroneously has chosen the wrong protocol dissector for 
        this packet. This will happen e.g. if you are using a protocol  
        not on its well known TCP or UDP port. You may try Analyze|Decode As 
        to circumvent this problem.
      </para>
    </listitem>
    <listitem>
      <para>
        <command>Packet not reassembled</command>:
        The packet is longer than a single frame and it is not reassembled,
        see    <xref linkend="ChAdvReassemblySection"/> for further details.
      </para>
    </listitem>
    <listitem>
      <para>
        <command>Packet is malformed</command>:
        The packet is actually wrong (malformed), meaning that a part of the 
        packet is just not as expected (not following the protocol 
        specifications).
      </para>
    </listitem>
    <listitem>
      <para>
        <command>Dissector is buggy</command>:
        The corresponding protocol dissector is simply buggy or still
        incomplete.
      </para>
    </listitem>
      </itemizedlist>
    </para>
    <para>
    Any of the above is possible. You'll have to look into the specific 
    situation to determine the reason. 
    You could disable the dissector by disabling the
    protocol on the Analyze menu and check how Wireshark displays the packet
    then. You could (if it's TCP) enable reassembly for TCP and the specific
    dissector (if possible) in the Edit|Preferences menu. You could check the
    packet contents yourself by reading the packet bytes and comparing it to
    the protocol specification. This could reveal a dissector bug. Or you
    could find out that the packet is indeed wrong.
    </para>
  </section>
  <section><title>[Packet size limited during capture]</title>
    <para>
    The packet size was limited during capture, see "Limit each packet to n 
    bytes" at the <xref linkend="ChCapCaptureOptions"/>. 
    While dissecting, the current protocol 
    dissector was simply running out of packet bytes and had to give up.
    There's nothing else you can do now, except to repeat the whole capture 
    process again with a higher (or no) packet size limitation.
    </para>
  </section>
  </section>

  <section id="AppMessagesDetails"><title>Packet Details Messages</title>
    <para>
    These messages might appear in the packet details.
    </para>
  <section><title>[Response in frame: 123]</title>
    <para>
    The current packet is the request of a detected request/response pair. 
    You can directly jump to the corresponding response packet just 
    by double clicking on this message.
    </para>
  </section>
  <section><title>[Request in frame: 123]</title>
    <para>
    Same as "Response in frame: 123" above, but the other way round.
    </para>
  </section>
  <section><title>[Time from request: 0.123 seconds]</title>
    <para>
    The time between the request and the response packets.
    </para>
  </section>
  <section><title>[Stream setup by PROTOCOL (frame 123)]</title>
    <para>
    The session control protocol (SDP, H225, etc) message which signaled 
    the creation of this session. You can directly jump to the 
    corresponding packet just by double clicking on this message.
    </para>
  </section>
  </section>

</appendix>
<!-- End of WSUG Appendix Messages -->