Revert "TODO tools/pidl/lib/Parse/Pidl/Wireshark/NDR.pm \@VALUEREF\@"
[wireshark-sm.git] / doc / wsug_src / wsug_messages.adoc
blob8890a8a5203a74696188063546f1716ec39b1841
1 // WSUG Appendix Messages
3 [#AppMessages]
5 [appendix]
6 == Wireshark Messages
8 Wireshark provides you with additional information generated out of the plain
9 packet data or it may need to indicate dissection problems. Messages generated
10 by Wireshark are usually placed in square brackets (“[]”).
12 [#AppMessagesList]
14 === Packet List Messages
16 These messages might appear in the packet list.
18 ==== [Malformed Packet]
20 Malformed packet means that the protocol dissector can’t dissect the contents of
21 the packet any further. There can be various reasons:
23 * __Wrong dissector__: Wireshark erroneously has chosen the wrong protocol
24   dissector for 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 to
26   circumvent this problem.
28 * __Packet not reassembled__: The packet is longer than a single frame and it is
29   not reassembled, see <<ChAdvReassemblySection>> for further details.
31 * __Packet is malformed__: The packet is actually wrong (malformed), meaning
32   that a part of the packet is just not as expected (not following the protocol
33   specifications).
35 * __Dissector is buggy__: The corresponding protocol dissector is simply buggy
36   or still incomplete.
38 Any of the above is possible. You’ll have to look into the specific situation to
39 determine the reason. You could disable the dissector by disabling the protocol
40 on the Analyze menu and check how Wireshark displays the packet then. You could
41 (if it’s TCP) enable reassembly for TCP and the specific dissector (if possible)
42 in the Edit|Preferences menu. You could check the packet contents yourself by
43 reading the packet bytes and comparing it to the protocol specification. This
44 could reveal a dissector bug. Or you could find out that the packet is indeed
45 wrong.
47 ==== [Packet size limited during capture]
49 The packet size was limited during capture, see “Limit each packet to n bytes”
50 at the <<ChCapCaptureOptions>>. While dissecting, the current protocol dissector
51 was simply running out of packet bytes and had to give up. There’s nothing else
52 you can do now, except to repeat the whole capture process again with a higher
53 (or no) packet size limitation.
55 [#AppMessagesDetails]
57 === Packet Details Messages
59 These messages might appear in the packet details.
61 ==== [Response in frame: 123]
63 The current packet is the request of a detected request/response pair. You can
64 directly jump to the corresponding response packet by double-clicking on
65 the message.
67 ==== [Request in frame: 123]
69 Same as “Response in frame: 123” above, but the other way round.
71 ==== [Time from request: 0.123 seconds]
73 The time between the request and the response packets.
75 ==== [Stream setup by PROTOCOL (frame 123)]
77 The session control protocol (SDP, H225, etc.) message which signaled the
78 creation of this session. You can directly jump to the corresponding packet
79 by double-clicking on this message.
81 // End of WSUG Appendix Messages