Give more information about time zones - several capture file formats
[obnox/wireshark/wip.git] / docbook / user-guide.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5 <!-- $Id$ -->
6
7 <!--
8 BIOGRAPHICAL SECTION
9 -Use this section to encode all biographical information
10 -->
11
12 <!-- Author's Names -->
13   <!ENTITY AuthorFullName "Ulf Lamping">
14   <!ENTITY AuthorFirstName "Ulf">
15   <!ENTITY AuthorOtherName "">
16   <!ENTITY AuthorSurname "Lamping">
17
18   <!ENTITY AuthorFullName2 "Richard Sharpe">
19   <!ENTITY AuthorFirstName2 "Richard">
20   <!ENTITY AuthorOtherName2 "">
21   <!ENTITY AuthorSurname2 "Sharpe">
22
23   <!ENTITY AuthorFullName3 "Ed Warnicke">
24   <!ENTITY AuthorFirstName3 "Ed">
25   <!ENTITY AuthorOtherName3 "">
26   <!ENTITY AuthorSurname3 "Warnicke">
27
28 <!--Author's Affiliation -->
29   <!ENTITY AuthorShortAffiliation "">
30   <!ENTITY AuthorJobTitle "">
31   <!ENTITY AuthorOrgName "">
32   <!ENTITY AuthorOrgDiv "">
33   <!ENTITY AuthorEmail "ulf.lamping[AT]web.de">
34
35   <!ENTITY AuthorShortAffiliation2 "">
36   <!ENTITY AuthorJobTitle2 "Director">
37   <!ENTITY AuthorOrgName2 "NS Computer Software and Services P/L">
38   <!ENTITY AuthorOrgDiv2 "">
39   <!ENTITY AuthorEmail2 "rsharpe[AT]ns.aus.com">
40
41   <!ENTITY AuthorShortAffiliation3 "">
42   <!ENTITY AuthorJobTitle3 "">
43   <!ENTITY AuthorOrgName3 "">
44   <!ENTITY AuthorOrgDiv3 "">
45   <!ENTITY AuthorEmail3 "hagbard[AT]physics.rutgers.edu">
46
47
48
49   
50
51 <!--
52 DOCUMENT SECTION
53 -Use this section to encode all document information
54 -->
55
56   <!ENTITY DocumentTitle "<application>Ethereal</application> User's Guide">
57   <!ENTITY DocumentSubTitle "&SvnVersion; for Ethereal &EtherealCurrentVersion;">
58   <!ENTITY DocumentTitleAbbreviation "EUG">
59
60   <!ENTITY DocumentCopyrightHolder1 "Ulf Lamping ">
61   <!ENTITY DocumentCopyrightHolder2 "Richard Sharpe ">
62   <!ENTITY DocumentCopyrightHolder3 "Ed Warnicke ">
63   <!ENTITY DocumentCopyrightYear "2004-2005">
64
65   <!ENTITY DocumentEdition "Third ">
66   <!ENTITY DocumentVersion "V2.0.2">
67   <!ENTITY DocumentPubDate "2005">
68
69   <!ENTITY % SvnVersionFile SYSTEM "svn_version.xml">
70   %SvnVersionFile;
71 <!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>">
72
73 <!--
74 Ethereal Info
75 -->
76   <!ENTITY EtherealCurrentVersion "0.10.14">
77   <!ENTITY EtherealWebSite "http://www.ethereal.com">
78   <!ENTITY EtherealUsersGuidePage "&EtherealWebSite;/docs/#usersguide">
79   <!ENTITY EtherealDownloadPage "&EtherealWebSite;/download.html">
80   <!ENTITY EtherealBinariesPage "&EtherealWebSite;/download.html#releases">
81   <!ENTITY EtherealAuthorsPage "&EtherealWebSite;/introduction.html#authors">
82   <!ENTITY EtherealProtocolsPage "&EtherealWebSite;/docs/dfref/">
83   <!ENTITY EtherealFAQPage "&EtherealWebSite;/faq.html">
84   <!ENTITY EtherealFAQPromiscPage "&EtherealWebSite;/faq#promiscsniff">
85   <!ENTITY EtherealMediaPage "&EtherealWebSite;/media.html">
86   <!ENTITY EtherealWikiPage "http://wiki.ethereal.com">
87   <!ENTITY EtherealWikiCaptureFiltersPage "&EtherealWikiPage;/CaptureFilters">
88   <!ENTITY EtherealWikiDisplayFiltersPage "&EtherealWikiPage;/DisplayFilters">
89   <!ENTITY EtherealWikiPreferencesPage "&EtherealWikiPage;/Preferences">
90   <!ENTITY EtherealWikiColoringRulesPage "&EtherealWikiPage;/ColoringRules">
91   <!ENTITY EtherealWikiPreferencesPage "&EtherealWikiPage;/Preferences">
92
93   <!ENTITY EtherealDevMailList "ethereal-dev[AT]ethereal.com">
94   <!ENTITY EtherealUsersMailList "ethereal-users[AT]ethereal.com">
95
96   
97 <!--
98 Winpcap Info
99 -->
100   <!ENTITY WinPcapWebsite "http://www.winpcap.org">
101   <!ENTITY WinPcapDownloadWebsite "http://www.winpcap.org/install/default.htm">
102
103 <!--
104 Tcpdump Info
105 -->
106   <!ENTITY TcpdumpManpage "http://www.tcpdump.org/tcpdump_man.html">
107
108 <!--
109 Gnu info
110 -->
111   <!ENTITY GPLWebsite "http://www.gnu.org/copyleft/gpl.html">
112
113 <!--
114 Timezone info
115 -->
116   <!ENTITY TimezoneGMTSite "http://wwp.greenwichmeantime.com/">
117   <!ENTITY TimezoneWorldClockSite "http://www.timeanddate.com/worldclock/">
118   <!ENTITY NTPSite "http://www.ntp.org/">
119   <!ENTITY WikipediaTimezone "http://en.wikipedia.org/wiki/Time_zone">
120   <!ENTITY WikipediaDaylightSaving "http://en.wikipedia.org/wiki/Daylight_saving">
121   <!ENTITY WikipediaUTC "http://en.wikipedia.org/wiki/Coordinated_Universal_Time">
122
123 <!--
124 FILE SECTION
125 -Use this section to specify the files that make up the book. Use FPI (public identifiers)
126 -->
127 <!-- These refer to graphics files and figures contained in the document -->
128   <!-- -->
129   <!ENTITY EtherealLogo SYSTEM "./graphics/ethereal-logo.png" NDATA PNG>
130   
131   <!-- 1st Chapter -->
132   <!ENTITY EtherealMain1 SYSTEM "./graphics/ethereal-main.png" NDATA PNG>
133
134   <!-- 2nd Chapter -->
135
136   <!-- Third Chapter -->
137   <!ENTITY EtherealEmpty SYSTEM "./graphics/ethereal-empty.png" NDATA PNG>
138   <!ENTITY EtherealThreePane1 SYSTEM "./graphics/ethereal-main.png" NDATA PNG>
139   <!ENTITY EtherealMenuOnly SYSTEM "./graphics/ethereal-menu.png" NDATA PNG>
140   <!ENTITY EtherealMainToolbar SYSTEM "./graphics/ethereal-main-toolbar.png" NDATA PNG>
141   <!ENTITY EtherealFilterToolbar SYSTEM "./graphics/ethereal-filter-toolbar.png" NDATA PNG>
142   <!ENTITY EtherealListPane SYSTEM "./graphics/ethereal-list-pane.png" NDATA PNG>
143   <!ENTITY EtherealDetailsPane SYSTEM "./graphics/ethereal-details-pane.png" NDATA PNG>
144   <!ENTITY EtherealBytesPane SYSTEM "./graphics/ethereal-bytes-pane.png" NDATA PNG>
145   <!ENTITY EtherealBytesPaneTabs SYSTEM "./graphics/ethereal-bytes-pane-tabs.png" NDATA PNG>
146   <!ENTITY EtherealStatusbarEmpty SYSTEM "./graphics/ethereal-statusbar-empty.png" NDATA PNG>
147   <!ENTITY EtherealStatusbarLoaded SYSTEM "./graphics/ethereal-statusbar-loaded.png" NDATA PNG>
148   <!ENTITY EtherealStatusbarSelected SYSTEM "./graphics/ethereal-statusbar-selected.png" NDATA PNG>
149   <!ENTITY EtherealSaveAs SYSTEM "./graphics/ethereal-save-as.png" NDATA PNG>
150   <!ENTITY EtherealOpen SYSTEM "./graphics/ethereal-open.png" NDATA PNG> 
151   <!ENTITY EtherealPacketSelected1 SYSTEM "./graphics/ethereal-packet-selected.png" NDATA PNG>
152   <!ENTITY EtherealPacketSepView SYSTEM "./graphics/ethereal-packet-sep-win.png" NDATA PNG>
153   <!ENTITY EtherealFilterTCP SYSTEM "./graphics/ethereal-display-filter-tcp.png" NDATA PNG>  
154   <!ENTITY EtherealColoringRulesDialog SYSTEM "./graphics/ethereal-coloring-rules-dialog.png" NDATA PNG>
155   <!ENTITY EtherealEditColorDialog SYSTEM "./graphics/ethereal-edit-color-rule-dialog.png" NDATA PNG>
156   <!ENTITY EtherealChooseColorDialog SYSTEM "./graphics/ethereal-choose-color-rule.png" NDATA PNG>
157   <!ENTITY EtherealFollowStream SYSTEM "./graphics/ethereal-follow-stream.png" NDATA PNG>
158   <!ENTITY EtherealFindPacket SYSTEM "./graphics/ethereal-find-packet.png" NDATA PNG>  
159   <!ENTITY EtherealGoToPacket SYSTEM "./graphics/ethereal-goto-packet.png" NDATA PNG>  
160   <!ENTITY EtherealPrint SYSTEM "./graphics/ethereal-print.png" NDATA PNG>
161   <!ENTITY EtherealGUIPreferences SYSTEM "./graphics/ethereal-gui-preferences.png" NDATA PNG>
162   <!ENTITY EtherealGUILayoutPreferences SYSTEM "./graphics/ethereal-gui-layout-preferences.png" NDATA PNG>
163   <!ENTITY EtherealGUIColumnsPreferences SYSTEM "./graphics/ethereal-gui-columns-preferences.png" NDATA PNG>
164   <!ENTITY EtherealGUIFontPreferences SYSTEM "./graphics/ethereal-gui-font-preferences.png" NDATA PNG>
165   <!ENTITY EtherealGUIColorsPreferences SYSTEM "./graphics/ethereal-gui-colors-preferences.png" NDATA PNG>
166   <!ENTITY EtherealCapturePreferences SYSTEM "./graphics/ethereal-capture-preferences.png" NDATA PNG>
167   <!ENTITY EtherealPrintingPreferences SYSTEM "./graphics/ethereal-printing-preferences.png" NDATA PNG>
168   <!ENTITY EtherealNameResolutionPreferences SYSTEM "./graphics/ethereal-nameresolution-preferences.png" NDATA PNG>
169   <!ENTITY EtherealFilters SYSTEM "./graphics/ethereal-filters.png" NDATA PNG>
170   <!ENTITY EtherealFileMenu SYSTEM "./graphics/ethereal-file-menu.png" NDATA PNG>
171   <!ENTITY EtherealEditMenu SYSTEM "./graphics/ethereal-edit-menu.png" NDATA PNG>
172   <!ENTITY EtherealViewMenu SYSTEM "./graphics/ethereal-view-menu.png" NDATA PNG>
173   <!ENTITY EtherealGoMenu SYSTEM "./graphics/ethereal-go-menu.png" NDATA PNG>
174   <!ENTITY EtherealCaptureMenu SYSTEM "./graphics/ethereal-capture-menu.png" NDATA PNG>
175   <!ENTITY EtherealAnalyzeMenu SYSTEM "./graphics/ethereal-analyze-menu.png" NDATA PNG>
176   <!ENTITY EtherealStatisticsMenu SYSTEM "./graphics/ethereal-statistics-menu.png" NDATA PNG>
177   <!ENTITY EtherealHelpMenu SYSTEM "./graphics/ethereal-help-menu.png" NDATA PNG>
178   <!ENTITY EtherealPacketPanePopupMenu SYSTEM "./graphics/ethereal-packet-pane-popup-menu.png" NDATA PNG>
179   <!ENTITY EtherealDetailsPanePopupMenu SYSTEM "./graphics/ethereal-details-pane-popup-menu.png" NDATA PNG>
180   <!ENTITY EtherealBytesPanePopupMenu SYSTEM "./graphics/ethereal-bytes-pane-popup-menu.png" NDATA PNG>
181   <!ENTITY EtherealFilterAddExpression SYSTEM "./graphics/ethereal-filter-add-expression.png" NDATA PNG>
182   <!ENTITY EtherealFilters2 SYSTEM "./graphics/ethereal-filters-2.png" NDATA PNG>
183   <!ENTITY EtherealExportPlainDialog SYSTEM "./graphics/ethereal-export-plain.png" NDATA PNG>
184   <!ENTITY EtherealExportPSDialog SYSTEM "./graphics/ethereal-export-ps.png" NDATA PNG>
185   <!ENTITY EtherealExportPSMLDialog SYSTEM "./graphics/ethereal-export-psml.png" NDATA PNG>
186   <!ENTITY EtherealExportPDMLDialog SYSTEM "./graphics/ethereal-export-pdml.png" NDATA PNG>
187   <!ENTITY EtherealExportSelectedDialog SYSTEM "./graphics/ethereal-export-selected.png" NDATA PNG>
188   <!ENTITY EtherealCaptureInterfacesDialog SYSTEM "./graphics/ethereal-capture-interfaces.png" NDATA PNG>
189   <!ENTITY EtherealCaptureOptionsDialog SYSTEM "./graphics/ethereal-capture-options.png" NDATA PNG>
190   <!ENTITY EtherealCaptureInfoDialog SYSTEM "./graphics/ethereal-capture-info.png" NDATA PNG>
191   <!ENTITY EtherealMergeDialog SYSTEM "./graphics/ethereal-merge.png" NDATA PNG>
192   <!ENTITY EtherealPacketRangeFrame SYSTEM "./graphics/ethereal-packet-range.png" NDATA PNG>
193   <!ENTITY EtherealPacketFormatFrame SYSTEM "./graphics/ethereal-packet-format.png" NDATA PNG>
194   <!ENTITY EtherealTimeReference SYSTEM "./graphics/ethereal-time-reference.png" NDATA PNG>
195   <!ENTITY EtherealEnabledProtocols SYSTEM "./graphics/ethereal-enabled-protocols.png" NDATA PNG>
196   <!ENTITY EtherealDecodeAs SYSTEM "./graphics/ethereal-decode-as.png" NDATA PNG>
197   <!ENTITY EtherealDecodeAsShow SYSTEM "./graphics/ethereal-decode-as-show.png" NDATA PNG>
198
199   <!-- Third Chapter Toolbar-->
200   <!ENTITY EtherealToolbarCaptureInterfaces SYSTEM "./graphics/toolbar/capture_interfaces_24.png" NDATA PNG>
201   <!ENTITY EtherealToolbarCaptureOptions SYSTEM "./graphics/toolbar/capture_options_24.png" NDATA PNG>
202   <!ENTITY EtherealToolbarCaptureStart SYSTEM "./graphics/toolbar/capture_start_24.png" NDATA PNG>
203   <!ENTITY EtherealToolbarCaptureStop SYSTEM "./graphics/toolbar/capture_stop_24.png" NDATA PNG>
204   <!ENTITY EtherealToolbarCaptureRestart SYSTEM "./graphics/toolbar/capture_restart_24.png" NDATA PNG>
205   <!ENTITY EtherealToolbarCaptureFilters SYSTEM "./graphics/toolbar/capture_filter_24.png" NDATA PNG>
206   <!ENTITY EtherealToolbarDisplayFilters SYSTEM "./graphics/toolbar/display_filter_24.png" NDATA PNG>
207   <!ENTITY EtherealToolbarAdd SYSTEM "./graphics/toolbar/stock_add_24.png" NDATA PNG>
208   <!ENTITY EtherealToolbarGoLast SYSTEM "./graphics/toolbar/stock_bottom_24.png" NDATA PNG>
209   <!ENTITY EtherealToolbarClose SYSTEM "./graphics/toolbar/stock_close_24.png" NDATA PNG>
210   <!ENTITY EtherealToolbarColoringRules SYSTEM "./graphics/toolbar/stock_colorselector_24.png" NDATA PNG>
211   <!ENTITY EtherealToolbarHelp SYSTEM "./graphics/toolbar/stock_help_24.png" NDATA PNG>
212   <!ENTITY EtherealToolbarGoTo SYSTEM "./graphics/toolbar/stock_jump_to_24.png" NDATA PNG>
213   <!ENTITY EtherealToolbarGoBack SYSTEM "./graphics/toolbar/stock_left_arrow_24.png" NDATA PNG>
214   <!ENTITY EtherealToolbarOpen SYSTEM "./graphics/toolbar/stock_open_24.png" NDATA PNG>
215   <!ENTITY EtherealToolbarPreferences SYSTEM "./graphics/toolbar/stock_preferences_24.png" NDATA PNG>
216   <!ENTITY EtherealToolbarPrint SYSTEM "./graphics/toolbar/stock_print_24.png" NDATA PNG>
217   <!ENTITY EtherealToolbarProperties SYSTEM "./graphics/toolbar/stock_properties_24.png" NDATA PNG>
218   <!ENTITY EtherealToolbarReload SYSTEM "./graphics/toolbar/stock_refresh_24.png" NDATA PNG>
219   <!ENTITY EtherealToolbarGoForward SYSTEM "./graphics/toolbar/stock_right_arrow_24.png" NDATA PNG>
220   <!ENTITY EtherealToolbarSave SYSTEM "./graphics/toolbar/stock_save_24.png" NDATA PNG>
221   <!ENTITY EtherealToolbarSaveAs SYSTEM "./graphics/toolbar/stock_save_as_24.png" NDATA PNG>
222   <!ENTITY EtherealToolbarFind SYSTEM "./graphics/toolbar/stock_search_24.png" NDATA PNG>
223   <!ENTITY EtherealToolbarStop SYSTEM "./graphics/toolbar/stock_stop_24.png" NDATA PNG>
224   <!ENTITY EtherealToolbarGoFirst SYSTEM "./graphics/toolbar/stock_top_24.png" NDATA PNG>
225   <!ENTITY EtherealToolbarZoom100 SYSTEM "./graphics/toolbar/stock_zoom_1_24.png" NDATA PNG>
226   <!ENTITY EtherealToolbarZoomIn SYSTEM "./graphics/toolbar/stock_zoom_in_24.png" NDATA PNG>
227   <!ENTITY EtherealToolbarZoomOut SYSTEM "./graphics/toolbar/stock_zoom_out_24.png" NDATA PNG>
228   <!ENTITY EtherealToolbarColorize SYSTEM "./graphics/toolbar/colorize_24.png" NDATA PNG>
229   <!ENTITY EtherealToolbarAutoScroll SYSTEM "./graphics/toolbar/autoscroll_24.png" NDATA PNG>
230   <!ENTITY EtherealToolbarResizeColumns SYSTEM "./graphics/toolbar/resize_columns_24.png" NDATA PNG>
231
232   <!-- Third Chapter Statistics -->
233   <!ENTITY EtherealStatsSummary SYSTEM "./graphics/ethereal-stats-summary.png" NDATA PNG>
234   <!ENTITY EtherealStatsHierarchy SYSTEM "./graphics/ethereal-stats-hierarchy.png" NDATA PNG>
235   <!ENTITY EtherealStatsEndpoints SYSTEM "./graphics/ethereal-stats-endpoints.png" NDATA PNG>
236   <!ENTITY EtherealStatsConversations SYSTEM "./graphics/ethereal-stats-conversations.png" NDATA PNG>
237   <!ENTITY EtherealStatsIOGraphs SYSTEM "./graphics/ethereal-stats-iographs.png" NDATA PNG>
238   <!ENTITY EtherealStatsSrtDcerpcFilter SYSTEM "./graphics/ethereal-stats-srt-dcerpc-filter.png" NDATA PNG>
239   <!ENTITY EtherealStatsSrtDcerpc SYSTEM "./graphics/ethereal-stats-srt-dcerpc.png" NDATA PNG>
240
241   <!-- Fifth Chapter -->
242
243   <!-- Sixth Chapter -->
244
245   <!-- Appendices etc -->
246   <!ENTITY EtherealFormatError SYSTEM "./graphics/ethereal-error-open.png" NDATA PNG>
247   <!ENTITY EtherealFormatError SYSTEM "./graphics/ethereal-error-open.png" NDATA PNG>
248   <!ENTITY EtherealSaveError SYSTEM "./graphics/ethereal-save-error.png" NDATA PNG>
249
250
251 <!-- These are the actual files that make up the document -->
252   <!ENTITY BookMetaInformation SYSTEM "eug_src/EUG_meta_info.xml">
253   <!ENTITY Preface SYSTEM  "eug_src/EUG_preface.xml">
254   <!ENTITY ChapterIntroduction SYSTEM "eug_src/EUG_chapter_introduction.xml">
255   <!ENTITY ChapterBuildInstall SYSTEM "eug_src/EUG_chapter_build_install.xml">
256   <!ENTITY ChapterUse SYSTEM "eug_src/EUG_chapter_use.xml">
257   <!ENTITY ChapterCapture SYSTEM "eug_src/EUG_chapter_capture.xml">
258   <!ENTITY ChapterIo SYSTEM "eug_src/EUG_chapter_io.xml">
259   <!ENTITY ChapterWork SYSTEM "eug_src/EUG_chapter_work.xml">
260   <!ENTITY ChapterAdvanced SYSTEM "eug_src/EUG_chapter_advanced.xml">
261   <!ENTITY ChapterStatistics SYSTEM "eug_src/EUG_chapter_statistics.xml">
262   <!ENTITY ChapterCustomize SYSTEM "eug_src/EUG_chapter_customize.xml">
263   <!ENTITY ChapterTroubleshoot SYSTEM "eug_src/EUG_chapter_troubleshoot.xml">
264   <!ENTITY AppMessages SYSTEM "eug_src/EUG_app_messages.xml">
265   <!ENTITY AppFiles SYSTEM "eug_src/EUG_app_files.xml">
266   <!ENTITY AppProtocols SYSTEM   "eug_src/EUG_app_protocols.xml">
267   <!ENTITY AppHowItWorks SYSTEM "eug_src/EUG_app_howitworks.xml">
268   <!ENTITY AppTools SYSTEM "eug_src/EUG_app_tools.xml">
269   <!ENTITY AppGPL SYSTEM    "GPL_appendix.xml">
270
271 ]>
272
273 <book>
274   <title>&DocumentTitle;</title>
275   <subtitle>&DocumentSubTitle;</subtitle>
276   <!--
277   -->
278   &BookMetaInformation;
279   &Preface;
280   &ChapterIntroduction;
281   &ChapterBuildInstall;
282   &ChapterUse;
283   &ChapterCapture;
284   &ChapterIo;
285   &ChapterWork;
286   &ChapterAdvanced;
287   &ChapterStatistics;  
288   &ChapterCustomize;
289
290   <!-- Removed, as this chapter has to be reworked first
291   &ChapterTroubleshoot; 
292   -->
293   
294   &AppFiles;
295   &AppProtocols;
296   &AppMessages;  
297   &AppTools;
298   <!-- Removed, as this chapter is not finished 
299   &AppHowItWorks;
300   -->
301   
302   &AppGPL;
303   <!-- Removed, as these chapters must be reworked
304   &Glossary;
305   &Index;
306   -->
307 </book>