Add wmem_map_steal
[metze/wireshark/wip.git] / docbook / wsug_src / WSUG_chapter_telephony.asciidoc
1 ++++++++++++++++++++++++++++++++++++++
2 <!-- WSUG Chapter Telephony -->
3 ++++++++++++++++++++++++++++++++++++++
4
5 [[ChTelephony]]
6
7 == Telephony
8
9 [[ChTelIntroduction]]
10
11 === Introduction
12
13 Wireshark provides a wide range of telephony related network statistics which
14 can be accessed via the menu:Telephony[] menu.
15
16 These statistics range from specific signaling protocols, to analysis of
17 signaling and media flows. If encoded in a compatible encoding the media flow
18 can even be played.
19
20 [[ChTelRTPAnalysis]]
21
22 === RTP Analysis
23
24 The RTP analysis function takes the selected RTP stream (and the reverse stream,
25 if possible) and generates a list of statistics on it.
26
27 .The ``RTP Stream Analysis'' window
28 image::wsug_graphics/ws-tel-rtpstream-analysis.png[{screenshot-attrs}]
29
30 Starting with basic data as packet number and sequence number, further
31 statistics are created based on arrival time, delay, jitter, packet size, etc.
32
33 Besides the per packet statistics, the lower pane shows the overall statistics,
34 with minimums and maximums for delta, jitter and clock skew. Also an indication
35 of lost packets is included.
36
37 The RTP Stream Analysis window further provides the option to save the RTP
38 payload (as raw data or, if in a PCM encoding, in an Audio file). Other options
39 a to export and plot various statistics on the RTP streams.
40
41 [[ChTelIAX2Analysis]]
42
43 === IAX2 Analysis
44
45 The ``IAX2 Analysis'' dialog shows statistics for the forward and reverse
46 streams of a selected IAX2 call along with a graph.
47
48 [[ChTelVoipCalls]]
49
50 === VoIP Calls
51
52 The VoIP Calls window shows a list of all detected VoIP calls in the captured
53 traffic. It finds calls by their signaling.
54
55 More details can be found on the {wireshark-wiki-url}VoIP_calls page.
56
57 [[ChTelRtpPlayer]]
58
59 The RTP Player window lets you play back RTP audio data. In order to use
60 this feature your version of Wireshark must support audio and the codecs
61 used by each RTP stream.
62
63 More details can be found on the
64 {wireshark-wiki-url}VoIP_calls page.
65
66 [[ChTelLTEMACTraffic]]
67
68 === LTE MAC Traffic Statistics
69
70 Statistics of the captured LTE MAC traffic. This window will summarize the LTE
71 MAC traffic found in the capture.
72
73 .The ``LTE MAC Traffic Statistics'' window
74 image::wsug_graphics/ws-stats-lte-mac-traffic.png[{screenshot-attrs}]
75
76 The top pane shows statistics for common channels. Each row in the middle pane
77 shows statistical highlights for exactly one UE/C-RNTI. In the lower pane, you
78 can see the for the currently selected UE/C-RNTI the traffic broken down by
79 individual channel.
80
81 [[ChTelLTERLCTraffic]]
82
83 === LTE RLC Traffic Statistics
84
85 Statistics of the captured LTE RLC traffic. This window will summarize the LTE
86 RLC traffic found in the capture.
87
88 .The ``LTE RLC Traffic Statistics'' window
89 image::wsug_graphics/ws-stats-lte-rlc-traffic.png[{screenshot-attrs}]
90
91 At the top, the check-box allows this window to include RLC PDUs found within
92 MAC PDUs or not. This will affect both the PDUs counted as well as the display
93 filters generated (see below).
94
95 The upper list shows summaries of each active UE. Each row in the lower list
96 shows statistical highlights for individual channels within the selected UE.
97
98 The lower part of the windows allows display filters to be generated and set for
99 the selected channel. Note that in the case of Acknowledged Mode channels, if a
100 single direction is chosen, the generated filter will show data in that
101 direction and control PDUs in the opposite direction.
102
103 [[ChTelXXX]]
104
105 === The protocol specific statistics windows
106
107 The protocol specific statistics windows display detailed information of
108 specific protocols and might be described in a later version of this document.
109
110 Some of these statistics are described at the
111 {wireshark-wiki-url}Statistics pages.
112
113 ++++++++++++++++++++++++++++++++++++++
114 <!-- End of WSUG Chapter Telephony -->
115 ++++++++++++++++++++++++++++++++++++++