aboutsummaryrefslogtreecommitdiffstats
path: root/docbook/user-guide.xml
blob: 4ac0d9838aa5907ab0650d3724a6b0e82f477cb7 (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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!-- $Id$ -->

<!--
BIOGRAPHICAL SECTION
-Use this section to encode all biographical information
-->

<!-- Author's Names -->
  <!ENTITY AuthorFullName "Richard Sharpe">
  <!ENTITY AuthorFirstName "Richard">
  <!ENTITY AuthorOtherName "">
  <!ENTITY AuthorSurname "Sharpe">

  <!ENTITY AuthorFullName2 "Ed Warnicke">
  <!ENTITY AuthorFirstName2 "Ed">
  <!ENTITY AuthorOtherName2 "">
  <!ENTITY AuthorSurname2 "Warnicke">

  <!ENTITY AuthorFullName3 "Ulf Lamping">
  <!ENTITY AuthorFirstName3 "Ulf">
  <!ENTITY AuthorOtherName3 "">
  <!ENTITY AuthorSurname3 "Lamping">

<!--Author's Affiliation -->
  <!ENTITY AuthorShortAffiliation "">
  <!ENTITY AuthorJobTitle "Director">
  <!ENTITY AuthorOrgName "NS Computer Software and Services P/L">
  <!ENTITY AuthorOrgDiv "">
  <!ENTITY AuthorEmail "rsharpe[AT]ns.aus.com">

  <!ENTITY AuthorShortAffiliation2 "">
  <!ENTITY AuthorJobTitle2 "">
  <!ENTITY AuthorOrgName2 "">
  <!ENTITY AuthorOrgDiv2 "">
  <!ENTITY AuthorEmail2 "hagbard[AT]physics.rutgers.edu">

  <!ENTITY AuthorShortAffiliation3 "">
  <!ENTITY AuthorJobTitle3 "">
  <!ENTITY AuthorOrgName3 "">
  <!ENTITY AuthorOrgDiv3 "">
  <!ENTITY AuthorEmail3 "ulf.lamping[AT]web.de">


  

<!--
DOCUMENT SECTION
-Use this section to encode all document information
-->

  <!ENTITY DocumentTitle "<application>Ethereal</application> User's Guide">
  <!ENTITY DocumentSubTitle "&DocumentVersion; for Ethereal &EtherealCurrentVersion;">
  <!ENTITY DocumentTitleAbbreviation "EUG">

  <!ENTITY DocumentCopyrightHolder1 "Richard Sharpe">
  <!ENTITY DocumentCopyrightHolder2 "Ed Warnicke">
  <!ENTITY DocumentCopyrightHolder3 "Ulf Lamping">
  <!ENTITY DocumentCopyrightYear "2004-2005">

  <!ENTITY DocumentEdition "Third ">
  <!ENTITY DocumentVersion "V2.0.2">
  <!ENTITY DocumentPubDate "2005">

<!ENTITY DocumentLegalNotice "<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.</para><para>All logos and trademarks in this document are property of their respective owner.</para>">

<!--
Ethereal Info
-->
  <!ENTITY EtherealCurrentVersion "0.10.9">
  <!ENTITY EtherealWebSite "http://www.ethereal.com">
  <!ENTITY EtherealUsersGuidePage "&EtherealWebSite;/docs/#usersguide">
  <!ENTITY EtherealDownloadPage "&EtherealWebSite;/download.html">
  <!ENTITY EtherealBinariesPage "&EtherealWebSite;/download.html#releases">
  <!ENTITY EtherealAuthorsPage "&EtherealWebSite;/introduction.html#authors">
  <!ENTITY EtherealProtocolsPage "&EtherealWebSite;/docs/dfref/">
  <!ENTITY EtherealFAQPage "&EtherealWebSite;/faq.html">
  <!ENTITY EtherealFAQPromiscPage "&EtherealWebSite;/faq#promiscsniff">
  <!ENTITY EtherealMediaPage "&EtherealWebSite;/media.html">
  <!ENTITY EtherealWikiPage "http://wiki.ethereal.com">
  <!ENTITY EtherealWikiCaptureFiltersPage "&EtherealWikiPage;/CaptureFilters">
  <!ENTITY EtherealWikiDisplayFiltersPage "&EtherealWikiPage;/DisplayFilters">
  <!ENTITY EtherealWikiPreferencesPage "&EtherealWikiPage;/Preferences">
  <!ENTITY EtherealWikiColoringRulesPage "&EtherealWikiPage;/ColoringRules">
  <!ENTITY EtherealWikiPreferencesPage "&EtherealWikiPage;/Preferences">

  <!ENTITY EtherealDevMailList "ethereal-dev[AT]ethereal.com">
  <!ENTITY EtherealUsersMailList "ethereal-users[AT]ethereal.com">

  
<!--
Winpcap Info
-->
  <!ENTITY WinPcapWebsite "http://winpcap.polito.it">
  <!ENTITY WinPcapDownloadWebsite "http://winpcap.polito.it/install/Default.htm">

<!--
Gnu info
-->
  <!ENTITY GPLWebsite "http://www.gnu.org/copyleft/gpl.html">

<!--
FILE SECTION
-Use this section to specify the files that make up the book. Use FPI (public identifiers)
-->
<!-- These refer to graphics files and figures contained in the document -->
  <!-- -->
  <!ENTITY EtherealLogo SYSTEM "./graphics/ethereal-logo.png" NDATA PNG>
  
  <!-- 1st Chapter -->
  <!ENTITY EtherealMain1 SYSTEM "./graphics/ethereal-main.png" NDATA PNG>

  <!-- 2nd Chapter -->

  <!-- Third Chapter -->
  <!ENTITY EtherealEmpty SYSTEM "./graphics/ethereal-empty.png" NDATA PNG>
  <!ENTITY EtherealThreePane1 SYSTEM "./graphics/ethereal-3pane.png" NDATA PNG>
  <!ENTITY EtherealMenuOnly SYSTEM "./graphics/ethereal-menu.png" NDATA PNG>
  <!ENTITY EtherealMainToolbar SYSTEM "./graphics/ethereal-main-toolbar.png" NDATA PNG>
  <!ENTITY EtherealFilterToolbar SYSTEM "./graphics/ethereal-filter-toolbar.png" NDATA PNG>
  <!ENTITY EtherealListPane SYSTEM "./graphics/ethereal-list-pane.png" NDATA PNG>
  <!ENTITY EtherealDetailsPane SYSTEM "./graphics/ethereal-details-pane.png" NDATA PNG>
  <!ENTITY EtherealBytesPane SYSTEM "./graphics/ethereal-bytes-pane.png" NDATA PNG>
  <!ENTITY EtherealBytesPaneTabs SYSTEM "./graphics/ethereal-bytes-pane-tabs.png" NDATA PNG>
  <!ENTITY EtherealStatusbarEmpty SYSTEM "./graphics/ethereal-statusbar-empty.png" NDATA PNG>
  <!ENTITY EtherealStatusbarLoaded SYSTEM "./graphics/ethereal-statusbar-loaded.png" NDATA PNG>
  <!ENTITY EtherealStatusbarSelected SYSTEM "./graphics/ethereal-statusbar-selected.png" NDATA PNG>
  <!ENTITY EtherealSaveAs SYSTEM "./graphics/ethereal-save-as.png" NDATA PNG>
  <!ENTITY EtherealOpen SYSTEM "./graphics/ethereal-open.png" NDATA PNG> 
  <!ENTITY EtherealPacketSelected1 SYSTEM "./graphics/ethereal-packet-selected.png" NDATA PNG>
  <!ENTITY EtherealPacketSepView SYSTEM "./graphics/ethereal-packet-sep-win.png" NDATA PNG>
  <!ENTITY EtherealFilterTCP SYSTEM "./graphics/ethereal-display-filter-tcp.png" NDATA PNG>  
  <!ENTITY EtherealColoringRulesDialog SYSTEM "./graphics/ethereal-coloring-rules-dialog.png" NDATA PNG>
  <!ENTITY EtherealEditColorDialog SYSTEM "./graphics/ethereal-edit-color-rule-dialog.png" NDATA PNG>
  <!ENTITY EtherealChooseColorDialog SYSTEM "./graphics/ethereal-choose-color-rule.png" NDATA PNG>
  <!ENTITY EtherealFollowStream SYSTEM "./graphics/ethereal-follow-stream.png" NDATA PNG>
  <!ENTITY EtherealFindPacket SYSTEM "./graphics/ethereal-find-packet.png" NDATA PNG>  
  <!ENTITY EtherealGoToPacket SYSTEM "./graphics/ethereal-goto-packet.png" NDATA PNG>  
  <!ENTITY EtherealPrint SYSTEM "./graphics/ethereal-print.png" NDATA PNG>
  <!ENTITY EtherealGUIPreferences SYSTEM "./graphics/ethereal-gui-preferences.png" NDATA PNG>
  <!ENTITY EtherealGUILayoutPreferences SYSTEM "./graphics/ethereal-gui-layout-preferences.png" NDATA PNG>
  <!ENTITY EtherealGUIColumnsPreferences SYSTEM "./graphics/ethereal-gui-columns-preferences.png" NDATA PNG>
  <!ENTITY EtherealGUIFontPreferences SYSTEM "./graphics/ethereal-gui-font-preferences.png" NDATA PNG>
  <!ENTITY EtherealGUIColorsPreferences SYSTEM "./graphics/ethereal-gui-colors-preferences.png" NDATA PNG>
  <!ENTITY EtherealCapturePreferences SYSTEM "./graphics/ethereal-capture-preferences.png" NDATA PNG>
  <!ENTITY EtherealPrintingPreferences SYSTEM "./graphics/ethereal-printing-preferences.png" NDATA PNG>
  <!ENTITY EtherealNameResolutionPreferences SYSTEM "./graphics/ethereal-nameresolution-preferences.png" NDATA PNG>
  <!ENTITY EtherealFilters SYSTEM "./graphics/ethereal-filters.png" NDATA PNG>
  <!ENTITY EtherealFileMenu SYSTEM "./graphics/ethereal-file-menu.png" NDATA PNG>
  <!ENTITY EtherealEditMenu SYSTEM "./graphics/ethereal-edit-menu.png" NDATA PNG>
  <!ENTITY EtherealViewMenu SYSTEM "./graphics/ethereal-view-menu.png" NDATA PNG>
  <!ENTITY EtherealGoMenu SYSTEM "./graphics/ethereal-go-menu.png" NDATA PNG>
  <!ENTITY EtherealCaptureMenu SYSTEM "./graphics/ethereal-capture-menu.png" NDATA PNG>
  <!ENTITY EtherealAnalyzeMenu SYSTEM "./graphics/ethereal-analyze-menu.png" NDATA PNG>
  <!ENTITY EtherealStatisticsMenu SYSTEM "./graphics/ethereal-statistics-menu.png" NDATA PNG>
  <!ENTITY EtherealHelpMenu SYSTEM "./graphics/ethereal-help-menu.png" NDATA PNG>
  <!ENTITY EtherealPacketPanePopupMenu SYSTEM "./graphics/ethereal-packet-pane-popup-menu.png" NDATA PNG>
  <!ENTITY EtherealDetailsPanePopupMenu SYSTEM "./graphics/ethereal-details-pane-popup-menu.png" NDATA PNG>
  <!ENTITY EtherealBytesPanePopupMenu SYSTEM "./graphics/ethereal-bytes-pane-popup-menu.png" NDATA PNG>
  <!ENTITY EtherealFilterAddExpression SYSTEM "./graphics/ethereal-filter-add-expression.png" NDATA PNG>
  <!ENTITY EtherealFilters2 SYSTEM "./graphics/ethereal-filters-2.png" NDATA PNG>
  <!ENTITY EtherealExportPlainDialog SYSTEM "./graphics/ethereal-export-plain.png" NDATA PNG>
  <!ENTITY EtherealExportPSDialog SYSTEM "./graphics/ethereal-export-ps.png" NDATA PNG>
  <!ENTITY EtherealExportPSMLDialog SYSTEM "./graphics/ethereal-export-psml.png" NDATA PNG>
  <!ENTITY EtherealExportPDMLDialog SYSTEM "./graphics/ethereal-export-pdml.png" NDATA PNG>
  <!ENTITY EtherealExportSelectedDialog SYSTEM "./graphics/ethereal-export-selected.png" NDATA PNG>
  <!ENTITY EtherealCaptureInterfacesDialog SYSTEM "./graphics/ethereal-capture-interfaces.png" NDATA PNG>
  <!ENTITY EtherealCaptureOptionsDialog SYSTEM "./graphics/ethereal-capture-options.png" NDATA PNG>
  <!ENTITY EtherealCaptureInfoDialog SYSTEM "./graphics/ethereal-capture-info.png" NDATA PNG>
  <!ENTITY EtherealMergeDialog SYSTEM "./graphics/ethereal-merge.png" NDATA PNG>
  <!ENTITY EtherealPacketRangeFrame SYSTEM "./graphics/ethereal-packet-range.png" NDATA PNG>
  <!ENTITY EtherealPacketFormatFrame SYSTEM "./graphics/ethereal-packet-format.png" NDATA PNG>
  <!ENTITY EtherealTimeReference SYSTEM "./graphics/ethereal-time-reference.png" NDATA PNG>
  <!ENTITY EtherealEnabledProtocols SYSTEM "./graphics/ethereal-enabled-protocols.png" NDATA PNG>
  <!ENTITY EtherealDecodeAs SYSTEM "./graphics/ethereal-decode-as.png" NDATA PNG>
  <!ENTITY EtherealDecodeAsShow SYSTEM "./graphics/ethereal-decode-as-show.png" NDATA PNG>

  <!-- Third Chapter Toolbar-->
  <!ENTITY EtherealToolbarCapture SYSTEM "./graphics/toolbar/capture_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarCaptureFilters SYSTEM "./graphics/toolbar/cfilter_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarDisplayFilters SYSTEM "./graphics/toolbar/dfilter_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarAdd SYSTEM "./graphics/toolbar/stock_add_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarGoLast SYSTEM "./graphics/toolbar/stock_bottom_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarClose SYSTEM "./graphics/toolbar/stock_close_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarColoringRules SYSTEM "./graphics/toolbar/stock_colorselector_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarHelp SYSTEM "./graphics/toolbar/stock_help_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarGoTo SYSTEM "./graphics/toolbar/stock_jump_to_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarFindPrevious SYSTEM "./graphics/toolbar/stock_left_arrow_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarOpen SYSTEM "./graphics/toolbar/stock_open_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarPreferences SYSTEM "./graphics/toolbar/stock_preferences_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarPrint SYSTEM "./graphics/toolbar/stock_print_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarProperties SYSTEM "./graphics/toolbar/stock_properties_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarReload SYSTEM "./graphics/toolbar/stock_refresh_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarFindNext SYSTEM "./graphics/toolbar/stock_right_arrow_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarSave SYSTEM "./graphics/toolbar/stock_save_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarSaveAs SYSTEM "./graphics/toolbar/stock_save_as_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarFind SYSTEM "./graphics/toolbar/stock_search_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarStop SYSTEM "./graphics/toolbar/stock_stop_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarGoFirst SYSTEM "./graphics/toolbar/stock_top_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarZoom100 SYSTEM "./graphics/toolbar/stock_zoom_1_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarZoomIn SYSTEM "./graphics/toolbar/stock_zoom_in_24.png" NDATA PNG>
  <!ENTITY EtherealToolbarZoomOut SYSTEM "./graphics/toolbar/stock_zoom_out_24.png" NDATA PNG>

  <!-- Third Chapter Statistics -->
  <!ENTITY EtherealStatsSummary SYSTEM "./graphics/ethereal-stats-summary.png" NDATA PNG>
  <!ENTITY EtherealStatsHierarchy SYSTEM "./graphics/ethereal-stats-hierarchy.png" NDATA PNG>
  <!ENTITY EtherealStatsEndpoints SYSTEM "./graphics/ethereal-stats-endpoints.png" NDATA PNG>
  <!ENTITY EtherealStatsConversations SYSTEM "./graphics/ethereal-stats-conversations.png" NDATA PNG>
  <!ENTITY EtherealStatsIOGraphs SYSTEM "./graphics/ethereal-stats-iographs.png" NDATA PNG>
  <!ENTITY EtherealStatsSrtDcerpcFilter SYSTEM "./graphics/ethereal-stats-srt-dcerpc-filter.png" NDATA PNG>
  <!ENTITY EtherealStatsSrtDcerpc SYSTEM "./graphics/ethereal-stats-srt-dcerpc.png" NDATA PNG>

  <!-- Fifth Chapter -->

  <!-- Sixth Chapter -->

  <!-- Appendices etc -->
  <!ENTITY EtherealFormatError SYSTEM "./graphics/ethereal-error-open.png" NDATA PNG>
  <!ENTITY EtherealFormatError SYSTEM "./graphics/ethereal-error-open.png" NDATA PNG>
  <!ENTITY EtherealSaveError SYSTEM "./graphics/ethereal-save-error.png" NDATA PNG>


<!-- These are the actual files that make up the document -->
  <!ENTITY BookMetaInformation SYSTEM "eug_src/EUG_meta_info.xml">
  <!ENTITY Preface SYSTEM  "eug_src/EUG_preface.xml">
  <!ENTITY ChapterIntroduction SYSTEM "eug_src/EUG_chapter_introduction.xml">
  <!ENTITY ChapterBuildInstall SYSTEM "eug_src/EUG_chapter_build_install.xml">
  <!ENTITY ChapterUse SYSTEM "eug_src/EUG_chapter_use.xml">
  <!ENTITY ChapterCapture SYSTEM "eug_src/EUG_chapter_capture.xml">
  <!ENTITY ChapterIo SYSTEM "eug_src/EUG_chapter_io.xml">
  <!ENTITY ChapterWork SYSTEM "eug_src/EUG_chapter_work.xml">
  <!ENTITY ChapterAdvanced SYSTEM "eug_src/EUG_chapter_advanced.xml">
  <!ENTITY ChapterStatistics SYSTEM "eug_src/EUG_chapter_statistics.xml">
  <!ENTITY ChapterCustomize SYSTEM "eug_src/EUG_chapter_customize.xml">
  <!ENTITY ChapterTroubleshoot SYSTEM "eug_src/EUG_chapter_troubleshoot.xml">
  <!ENTITY AppMessages SYSTEM "eug_src/EUG_app_messages.xml">
  <!ENTITY AppFiles SYSTEM "eug_src/EUG_app_files.xml">
  <!ENTITY AppProtocols SYSTEM   "eug_src/EUG_app_protocols.xml">
  <!ENTITY AppHowItWorks SYSTEM "eug_src/EUG_app_howitworks.xml">
  <!ENTITY AppTools SYSTEM "eug_src/EUG_app_tools.xml">
  <!ENTITY AppGPL SYSTEM    "GPL_appendix.xml">

]>

<book>
  <title>&DocumentTitle;</title>
  <subtitle>&DocumentSubTitle;</subtitle>
  <!-- -->
  &BookMetaInformation;
  &Preface;
  &ChapterIntroduction;
  &ChapterBuildInstall;
  &ChapterUse;
  &ChapterCapture;
  &ChapterIo;
  &ChapterWork;
  &ChapterAdvanced;
  <!-- -->
  &ChapterStatistics;  
  &ChapterCustomize;

  <!-- Removed, as this chapter has to be reworked first -->
  <!-- &ChapterTroubleshoot; -->
  
  <!-- Removed, as this chapter is much too long and should form it's own document -->
  <!-- &FilterFields; -->

  <!-- Removed, as there are a lot more of warnings and messages right now, and 
  the warnings and messages should be self explanatory. -->
  <!-- &AppMessages; -->
  
  &AppFiles;
  &AppProtocols;
  &AppTools;
  <!-- Removed, as this chapter is not finished
  &AppHowItWorks;
  -->
  &AppGPL;
  <!-- Removed, as these chapters must be reworked -->
  <!--
  &Glossary;
  &Index;  -->
</book>