forked from osmocom/wireshark
Finish converting the User's Guide to AsciiDoc.
As with the Developer's Guide, add user-guide-docinfo.xml, which lets us carry over DocBook front matter. Remove the meta_info chapter. Most of its contents are now in user-guide-docinfo.xml. Add a DocBook revision history based on hints from the Git/SVN/CVS revision history. Remove the various makefile targets for converting AsciiDoc files to DocBook chapters. Remove GPL_appendix.xml. We use the AsciiDoc version. Change-Id: I543fa2a92f2c735c5f00c97ec65cff2187e09e3a Reviewed-on: https://code.wireshark.org/review/5216 Petri-Dish: Gerald Combs <gerald@wireshark.org> Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org> Reviewed-by: Gerald Combs <gerald@wireshark.org>daniel/osmux
Gerald Combs
Gerald Combs
parent
055e4768ec
commit
62289300d6
|
|
@ -138,6 +138,7 @@ help/faq.txt
|
|||
pod2htm[di].tmp
|
||||
wireshark.pod
|
||||
docbook/developer-guide.xml
|
||||
docbook/user-guide.xml
|
||||
docbook/ws?g_src/WS?G_*.dbk
|
||||
docbook/*-guide-*.fo
|
||||
docbook/*-guide-*.pdf
|
||||
|
|
|
|||
|
|
@ -32,28 +32,6 @@ set(COMMON_GRAPHICS
|
|||
)
|
||||
|
||||
set(WSUG_FILES
|
||||
WSUG_app_files.xml
|
||||
WSUG_app_howitworks.xml
|
||||
WSUG_app_messages.xml
|
||||
WSUG_app_protocols.xml
|
||||
WSUG_app_tools.xml
|
||||
WSUG_chapter_advanced.xml
|
||||
WSUG_chapter_build_install.xml
|
||||
WSUG_chapter_capture.xml
|
||||
WSUG_chapter_customize.xml
|
||||
WSUG_chapter_introduction.xml
|
||||
WSUG_chapter_io.xml
|
||||
WSUG_chapter_statistics.xml
|
||||
WSUG_chapter_telephony.xml
|
||||
WSUG_chapter_troubleshoot.xml
|
||||
WSUG_chapter_use.xml
|
||||
WSUG_chapter_work.xml
|
||||
wsug_src/WSUG_meta_info.xml
|
||||
WSUG_preface.xml
|
||||
ws.css
|
||||
)
|
||||
|
||||
set(WSDG_ASCIIDOC_FILES
|
||||
wsug_src/WSUG_app_files.asciidoc
|
||||
wsug_src/WSUG_app_howitworks.asciidoc
|
||||
wsug_src/WSUG_app_protocols.asciidoc
|
||||
|
|
@ -72,6 +50,7 @@ set(WSDG_ASCIIDOC_FILES
|
|||
wsug_src/WSUG_chapter_work.asciidoc
|
||||
wsug_src/WSUG_preface.asciidoc
|
||||
wsluarm.asciidoc
|
||||
ws.css
|
||||
)
|
||||
|
||||
set(WSUG_GRAPHICS
|
||||
|
|
@ -230,7 +209,6 @@ set(WSDG_GRAPHICS
|
|||
set(WSUG_SOURCE
|
||||
user-guide.xml
|
||||
git_version.xml
|
||||
wsluarm
|
||||
${WSUG_FILES}
|
||||
${WSUG_GRAPHICS}
|
||||
)
|
||||
|
|
@ -271,72 +249,11 @@ MACRO( ASCIIDOC2DOCBOOK _asciidocsource _conf_files )
|
|||
DEPENDS
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/${_asciidocsource}
|
||||
${_conf_deps}
|
||||
${WSDG_GENERATED_FILES}
|
||||
)
|
||||
ENDMACRO()
|
||||
|
||||
ASCIIDOC2DOCBOOK( developer-guide.asciidoc "${ASCIIDOC_CONF_FILES}" )
|
||||
|
||||
SET( WSDG_GENERATED_FILES )
|
||||
# Convert an AsciiDoc document to a DocBook chapter
|
||||
# Used for chapter-by-chapter conversion from DocBook to AsciiDoc.
|
||||
# Can be removed after the User's Guide is converted.
|
||||
# .asciidoc -> whole book (.dbk) -> chapter (.xml)
|
||||
MACRO( ASCIIDOC2CHAPTER _asciidocsource _conf_files )
|
||||
GET_FILENAME_COMPONENT( _source_base_name ${_asciidocsource} NAME_WE )
|
||||
set( A2X_HTML_OPTS --stylesheet=ws.css )
|
||||
set( _output_xml ${_source_base_name}.xml )
|
||||
set( _output_dbk ${_source_base_name}.dbk )
|
||||
|
||||
set(_conf_opts_list)
|
||||
foreach(_conf_file ${_conf_files})
|
||||
set( _conf_opts_list ${_conf_opts_list} --conf-file=${CMAKE_CURRENT_SOURCE_DIR}/${_conf_file})
|
||||
endforeach()
|
||||
string(REPLACE ";" " " _conf_opts "${_conf_opts_list}")
|
||||
|
||||
set(_conf_deps)
|
||||
foreach(_conf_file ${_conf_files})
|
||||
set( _conf_deps ${_conf_deps} ${CMAKE_CURRENT_SOURCE_DIR}/${_conf_file})
|
||||
endforeach()
|
||||
|
||||
ADD_CUSTOM_COMMAND(
|
||||
OUTPUT
|
||||
${_output_xml} ${_output_dbk}
|
||||
# XXX - Output to a specific directory, e.g. wsdg_generated_src
|
||||
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
||||
COMMAND ${A2X_EXECUTABLE}
|
||||
--verbose
|
||||
--attribute=build_dir=${CMAKE_CURRENT_BINARY_DIR}
|
||||
--destination-dir=${CMAKE_CURRENT_BINARY_DIR}
|
||||
--asciidoc-opts=${_conf_opts}
|
||||
--no-xmllint
|
||||
--fop
|
||||
--format=docbook --doctype=book
|
||||
${A2X_HTML_OPTS}
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/${_asciidocsource}
|
||||
COMMAND mv
|
||||
${_output_xml}
|
||||
${_output_dbk}
|
||||
COMMAND ${XMLLINT_EXECUTABLE}
|
||||
--xpath '//chapter | //preface | //appendix'
|
||||
${_output_dbk}
|
||||
> ${_output_xml}
|
||||
DEPENDS
|
||||
${_outptudir}
|
||||
${CMAKE_CURRENT_SOURCE_DIR}/${_asciidocsource}
|
||||
${_conf_deps}
|
||||
)
|
||||
LIST( APPEND WSDG_GENERATED_FILES ${CMAKE_CURRENT_BINARY_DIR}/${_output_xml} )
|
||||
ENDMACRO()
|
||||
|
||||
FOREACH(ASCIIDOCFILE ${WSDG_ASCIIDOC_FILES})
|
||||
ASCIIDOC2CHAPTER(
|
||||
${ASCIIDOCFILE}
|
||||
"${ASCIIDOC_CONF_FILES}"
|
||||
)
|
||||
ENDFOREACH()
|
||||
|
||||
ADD_CUSTOM_TARGET( wsug_generated_src DEPENDS ${WSDG_GENERATED_FILES} )
|
||||
ASCIIDOC2DOCBOOK( user-guide.asciidoc "${ASCIIDOC_CONF_FILES}" )
|
||||
|
||||
# developer-guide.xml must be first in the list
|
||||
set(WSDG_SOURCE
|
||||
|
|
|
|||
|
|
@ -1,358 +0,0 @@
|
|||
<!-- Wireshark GPL Appendix -->
|
||||
<appendix id="AppGPL">
|
||||
<title>This Document's License (GPL)</title>
|
||||
<para>As with the original license and documentation distributed
|
||||
with Wireshark, this document is covered by the GNU General Public
|
||||
License (GNU GPL).</para>
|
||||
|
||||
<para>If you haven't read the GPL before, please do so. It
|
||||
explains all the things that you are allowed to do with this
|
||||
code and documentation.</para>
|
||||
|
||||
<para>
|
||||
<programlisting>
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 2, June 1991
|
||||
|
||||
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The licenses for most software are designed to take away your
|
||||
freedom to share and change it. By contrast, the GNU General Public
|
||||
License is intended to guarantee your freedom to share and change free
|
||||
software--to make sure the software is free for all its users. This
|
||||
General Public License applies to most of the Free Software
|
||||
Foundation's software and to any other program whose authors commit to
|
||||
using it. (Some other Free Software Foundation software is covered by
|
||||
the GNU Library General Public License instead.) You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
this service if you wish), that you receive source code or can get it
|
||||
if you want it, that you can change the software or use pieces of it
|
||||
in new free programs; and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to make restrictions that forbid
|
||||
anyone to deny you these rights or to ask you to surrender the rights.
|
||||
These restrictions translate to certain responsibilities for you if you
|
||||
distribute copies of the software, or if you modify it.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must give the recipients all the rights that
|
||||
you have. You must make sure that they, too, receive or can get the
|
||||
source code. And you must show them these terms so they know their
|
||||
rights.
|
||||
|
||||
We protect your rights with two steps: (1) copyright the software, and
|
||||
(2) offer you this license which gives you legal permission to copy,
|
||||
distribute and/or modify the software.
|
||||
|
||||
Also, for each author's protection and ours, we want to make certain
|
||||
that everyone understands that there is no warranty for this free
|
||||
software. If the software is modified by someone else and passed on, we
|
||||
want its recipients to know that what they have is not the original, so
|
||||
that any problems introduced by others will not reflect on the original
|
||||
authors' reputations.
|
||||
|
||||
Finally, any free program is threatened constantly by software
|
||||
patents. We wish to avoid the danger that redistributors of a free
|
||||
program will individually obtain patent licenses, in effect making the
|
||||
program proprietary. To prevent this, we have made it clear that any
|
||||
patent must be licensed for everyone's free use or not licensed at all.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
0. This License applies to any program or other work which contains
|
||||
a notice placed by the copyright holder saying it may be distributed
|
||||
under the terms of this General Public License. The "Program", below,
|
||||
refers to any such program or work, and a "work based on the Program"
|
||||
means either the Program or any derivative work under copyright law:
|
||||
that is to say, a work containing the Program or a portion of it,
|
||||
either verbatim or with modifications and/or translated into another
|
||||
language. (Hereinafter, translation is included without limitation in
|
||||
the term "modification".) Each licensee is addressed as "you".
|
||||
|
||||
Activities other than copying, distribution and modification are not
|
||||
covered by this License; they are outside its scope. The act of
|
||||
running the Program is not restricted, and the output from the Program
|
||||
is covered only if its contents constitute a work based on the
|
||||
Program (independent of having been made by running the Program).
|
||||
Whether that is true depends on what the Program does.
|
||||
|
||||
1. You may copy and distribute verbatim copies of the Program's
|
||||
source code as you receive it, in any medium, provided that you
|
||||
conspicuously and appropriately publish on each copy an appropriate
|
||||
copyright notice and disclaimer of warranty; keep intact all the
|
||||
notices that refer to this License and to the absence of any warranty;
|
||||
and give any other recipients of the Program a copy of this License
|
||||
along with the Program.
|
||||
|
||||
You may charge a fee for the physical act of transferring a copy, and
|
||||
you may at your option offer warranty protection in exchange for a fee.
|
||||
|
||||
2. You may modify your copy or copies of the Program or any portion
|
||||
of it, thus forming a work based on the Program, and copy and
|
||||
distribute such modifications or work under the terms of Section 1
|
||||
above, provided that you also meet all of these conditions:
|
||||
|
||||
a) You must cause the modified files to carry prominent notices
|
||||
stating that you changed the files and the date of any change.
|
||||
|
||||
b) You must cause any work that you distribute or publish, that in
|
||||
whole or in part contains or is derived from the Program or any
|
||||
part thereof, to be licensed as a whole at no charge to all third
|
||||
parties under the terms of this License.
|
||||
|
||||
c) If the modified program normally reads commands interactively
|
||||
when run, you must cause it, when started running for such
|
||||
interactive use in the most ordinary way, to print or display an
|
||||
announcement including an appropriate copyright notice and a
|
||||
notice that there is no warranty (or else, saying that you provide
|
||||
a warranty) and that users may redistribute the program under
|
||||
these conditions, and telling the user how to view a copy of this
|
||||
License. (Exception: if the Program itself is interactive but
|
||||
does not normally print such an announcement, your work based on
|
||||
the Program is not required to print an announcement.)
|
||||
|
||||
These requirements apply to the modified work as a whole. If
|
||||
identifiable sections of that work are not derived from the Program,
|
||||
and can be reasonably considered independent and separate works in
|
||||
themselves, then this License, and its terms, do not apply to those
|
||||
sections when you distribute them as separate works. But when you
|
||||
distribute the same sections as part of a whole which is a work based
|
||||
on the Program, the distribution of the whole must be on the terms of
|
||||
this License, whose permissions for other licensees extend to the
|
||||
entire whole, and thus to each and every part regardless of who wrote it.
|
||||
|
||||
Thus, it is not the intent of this section to claim rights or contest
|
||||
your rights to work written entirely by you; rather, the intent is to
|
||||
exercise the right to control the distribution of derivative or
|
||||
collective works based on the Program.
|
||||
|
||||
In addition, mere aggregation of another work not based on the Program
|
||||
with the Program (or with a work based on the Program) on a volume of
|
||||
a storage or distribution medium does not bring the other work under
|
||||
the scope of this License.
|
||||
|
||||
3. You may copy and distribute the Program (or a work based on it,
|
||||
under Section 2) in object code or executable form under the terms of
|
||||
Sections 1 and 2 above provided that you also do one of the following:
|
||||
|
||||
a) Accompany it with the complete corresponding machine-readable
|
||||
source code, which must be distributed under the terms of Sections
|
||||
1 and 2 above on a medium customarily used for software interchange; or,
|
||||
|
||||
b) Accompany it with a written offer, valid for at least three
|
||||
years, to give any third party, for a charge no more than your
|
||||
cost of physically performing source distribution, a complete
|
||||
machine-readable copy of the corresponding source code, to be
|
||||
distributed under the terms of Sections 1 and 2 above on a medium
|
||||
customarily used for software interchange; or,
|
||||
|
||||
c) Accompany it with the information you received as to the offer
|
||||
to distribute corresponding source code. (This alternative is
|
||||
allowed only for noncommercial distribution and only if you
|
||||
received the program in object code or executable form with such
|
||||
an offer, in accord with Subsection b above.)
|
||||
|
||||
The source code for a work means the preferred form of the work for
|
||||
making modifications to it. For an executable work, complete source
|
||||
code means all the source code for all modules it contains, plus any
|
||||
associated interface definition files, plus the scripts used to
|
||||
control compilation and installation of the executable. However, as a
|
||||
special exception, the source code distributed need not include
|
||||
anything that is normally distributed (in either source or binary
|
||||
form) with the major components (compiler, kernel, and so on) of the
|
||||
operating system on which the executable runs, unless that component
|
||||
itself accompanies the executable.
|
||||
|
||||
If distribution of executable or object code is made by offering
|
||||
access to copy from a designated place, then offering equivalent
|
||||
access to copy the source code from the same place counts as
|
||||
distribution of the source code, even though third parties are not
|
||||
compelled to copy the source along with the object code.
|
||||
|
||||
4. You may not copy, modify, sublicense, or distribute the Program
|
||||
except as expressly provided under this License. Any attempt
|
||||
otherwise to copy, modify, sublicense or distribute the Program is
|
||||
void, and will automatically terminate your rights under this License.
|
||||
However, parties who have received copies, or rights, from you under
|
||||
this License will not have their licenses terminated so long as such
|
||||
parties remain in full compliance.
|
||||
|
||||
5. You are not required to accept this License, since you have not
|
||||
signed it. However, nothing else grants you permission to modify or
|
||||
distribute the Program or its derivative works. These actions are
|
||||
prohibited by law if you do not accept this License. Therefore, by
|
||||
modifying or distributing the Program (or any work based on the
|
||||
Program), you indicate your acceptance of this License to do so, and
|
||||
all its terms and conditions for copying, distributing or modifying
|
||||
the Program or works based on it.
|
||||
|
||||
6. Each time you redistribute the Program (or any work based on the
|
||||
Program), the recipient automatically receives a license from the
|
||||
original licensor to copy, distribute or modify the Program subject to
|
||||
these terms and conditions. You may not impose any further
|
||||
restrictions on the recipients' exercise of the rights granted herein.
|
||||
You are not responsible for enforcing compliance by third parties to
|
||||
this License.
|
||||
|
||||
7. If, as a consequence of a court judgment or allegation of patent
|
||||
infringement or for any other reason (not limited to patent issues),
|
||||
conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot
|
||||
distribute so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you
|
||||
may not distribute the Program at all. For example, if a patent
|
||||
license would not permit royalty-free redistribution of the Program by
|
||||
all those who receive copies directly or indirectly through you, then
|
||||
the only way you could satisfy both it and this License would be to
|
||||
refrain entirely from distribution of the Program.
|
||||
|
||||
If any portion of this section is held invalid or unenforceable under
|
||||
any particular circumstance, the balance of the section is intended to
|
||||
apply and the section as a whole is intended to apply in other
|
||||
circumstances.
|
||||
|
||||
It is not the purpose of this section to induce you to infringe any
|
||||
patents or other property right claims or to contest validity of any
|
||||
such claims; this section has the sole purpose of protecting the
|
||||
integrity of the free software distribution system, which is
|
||||
implemented by public license practices. Many people have made
|
||||
generous contributions to the wide range of software distributed
|
||||
through that system in reliance on consistent application of that
|
||||
system; it is up to the author/donor to decide if he or she is willing
|
||||
to distribute software through any other system and a licensee cannot
|
||||
impose that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is believed to
|
||||
be a consequence of the rest of this License.
|
||||
|
||||
8. If the distribution and/or use of the Program is restricted in
|
||||
certain countries either by patents or by copyrighted interfaces, the
|
||||
original copyright holder who places the Program under this License
|
||||
may add an explicit geographical distribution limitation excluding
|
||||
those countries, so that distribution is permitted only in or among
|
||||
countries not thus excluded. In such case, this License incorporates
|
||||
the limitation as if written in the body of this License.
|
||||
|
||||
9. The Free Software Foundation may publish revised and/or new versions
|
||||
of the General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the Program
|
||||
specifies a version number of this License which applies to it and "any
|
||||
later version", you have the option of following the terms and conditions
|
||||
either of that version or of any later version published by the Free
|
||||
Software Foundation. If the Program does not specify a version number of
|
||||
this License, you may choose any version ever published by the Free Software
|
||||
Foundation.
|
||||
|
||||
10. If you wish to incorporate parts of the Program into other free
|
||||
programs whose distribution conditions are different, write to the author
|
||||
to ask for permission. For software which is copyrighted by the Free
|
||||
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||
make exceptions for this. Our decision will be guided by the two goals
|
||||
of preserving the free status of all derivatives of our free software and
|
||||
of promoting the sharing and reuse of software generally.
|
||||
|
||||
NO WARRANTY
|
||||
|
||||
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||
REPAIR OR CORRECTION.
|
||||
|
||||
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGES.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
convey the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program is interactive, make it output a short notice like this
|
||||
when it starts in an interactive mode:
|
||||
|
||||
Gnomovision version 69, Copyright (C) year name of author
|
||||
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, the commands you use may
|
||||
be called something other than `show w' and `show c'; they could even be
|
||||
mouse-clicks or menu items--whatever suits your program.
|
||||
|
||||
You should also get your employer (if you work as a programmer) or your
|
||||
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||
necessary. Here is a sample; alter the names:
|
||||
|
||||
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||
|
||||
<signature of Ty Coon>, 1 April 1989
|
||||
Ty Coon, President of Vice
|
||||
|
||||
This General Public License does not permit incorporating your program into
|
||||
proprietary programs. If your program is a subroutine library, you may
|
||||
consider it more useful to permit linking proprietary applications with the
|
||||
library. If this is what you want to do, use the GNU Library General
|
||||
Public License instead of this License.
|
||||
|
||||
</programlisting>
|
||||
</para>
|
||||
</appendix>
|
||||
|
|
@ -53,19 +53,6 @@ else
|
|||
@false
|
||||
endif
|
||||
|
||||
# Convert an AsciiDoc document to a DocBook chapter
|
||||
# Used for chapter-by-chapter conversion from DocBook to AsciiDoc.
|
||||
# Can be removed after the User's Guide is converted.
|
||||
# .asciidoc -> whole book (.dbk) -> chapter (.xml)
|
||||
wsug_src/%.xml : wsug_src/%.asciidoc
|
||||
$(A2X) --verbose \
|
||||
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoctor-asciidoc.conf" \
|
||||
--no-xmllint \
|
||||
--format=docbook --doctype=book \
|
||||
$<
|
||||
mv wsug_src/$*.xml wsug_src/$*.dbk
|
||||
xmllint --xpath '//chapter | //preface | //appendix' wsug_src/$*.dbk > $@
|
||||
|
||||
if HAVE_XSLTPROC
|
||||
ALL_TARGETS=git_version_check wsug wsdg release_notes
|
||||
else
|
||||
|
|
@ -95,6 +82,14 @@ endif
|
|||
|
||||
wsug: $(WSUG_TARGETS)
|
||||
|
||||
user-guide.xml: user-guide.asciidoc $(WSUG_FILES)
|
||||
$(A2X) --verbose \
|
||||
--attribute=docinfo \
|
||||
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoctor-asciidoc.conf" \
|
||||
--no-xmllint \
|
||||
--format=docbook \
|
||||
$<
|
||||
|
||||
# validate the content
|
||||
wsug.validated: $(WSUG_SOURCE)
|
||||
if HAVE_XMLLINT
|
||||
|
|
@ -169,7 +164,7 @@ wsdg: $(WSDG_TARGETS)
|
|||
developer-guide.xml: developer-guide.asciidoc $(WSDG_FILES)
|
||||
$(A2X) --verbose \
|
||||
--attribute=docinfo \
|
||||
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoc.conf" \
|
||||
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoctor-asciidoc.conf" \
|
||||
--no-xmllint \
|
||||
--format=docbook \
|
||||
$<
|
||||
|
|
|
|||
|
|
@ -17,28 +17,11 @@ WSUG_FILES = \
|
|||
wsug_src/WSUG_chapter_troubleshoot.asciidoc \
|
||||
wsug_src/WSUG_chapter_use.asciidoc \
|
||||
wsug_src/WSUG_chapter_work.asciidoc \
|
||||
wsug_src/WSUG_meta_info.xml \
|
||||
wsug_src/WSUG_preface.asciidoc \
|
||||
ws.css
|
||||
|
||||
WSUG_GENERATED_SOURCE = \
|
||||
wsug_src/WSUG_app_files.xml \
|
||||
wsug_src/WSUG_app_howitworks.xml \
|
||||
wsug_src/WSUG_app_messages.xml \
|
||||
wsug_src/WSUG_app_protocols.xml \
|
||||
wsug_src/WSUG_app_tools.xml \
|
||||
wsug_src/WSUG_chapter_advanced.xml \
|
||||
wsug_src/WSUG_chapter_build_install.xml \
|
||||
wsug_src/WSUG_chapter_capture.xml \
|
||||
wsug_src/WSUG_chapter_customize.xml \
|
||||
wsug_src/WSUG_chapter_introduction.xml \
|
||||
wsug_src/WSUG_chapter_io.xml \
|
||||
wsug_src/WSUG_chapter_telephony.xml \
|
||||
wsug_src/WSUG_chapter_troubleshoot.xml \
|
||||
wsug_src/WSUG_chapter_statistics.xml \
|
||||
wsug_src/WSUG_chapter_use.xml \
|
||||
wsug_src/WSUG_chapter_work.xml \
|
||||
wsug_src/WSUG_preface.xml
|
||||
user-guide.xml
|
||||
|
||||
WSUG_GRAPHICS = \
|
||||
wsug_graphics/captureOptions.png \
|
||||
|
|
@ -214,7 +197,7 @@ COMMON_GRAPHICS = \
|
|||
WSUG_DIST = \
|
||||
user-guide.xml \
|
||||
git_version.xml \
|
||||
GPL_appendix.xml \
|
||||
GPL_appendix.asciidoc \
|
||||
custom_layer_chm.xsl \
|
||||
custom_layer_pdf.xsl \
|
||||
Makefile.common \
|
||||
|
|
@ -252,7 +235,6 @@ CLEANFILES = \
|
|||
*.validated \
|
||||
$(WSDG_GENERATED_SOURCE) \
|
||||
$(WSUG_GENERATED_SOURCE) \
|
||||
wsug_src/*.dbk \
|
||||
wsdg_chm \
|
||||
wsdg_html.zip \
|
||||
wsdg_html_chunked.zip \
|
||||
|
|
|
|||
|
|
@ -31,25 +31,6 @@ A2X_TEXT_OPTS=$(A2X_TEXT_OPTS) --lynx
|
|||
|
||||
.SUFFIXES: .fo .pdf
|
||||
|
||||
# Convert an AsciiDoc document to a DocBook chapter
|
||||
# Used for chapter-by-chapter conversion from DocBook to AsciiDoc.
|
||||
# .asciidoc -> whole book (.dbk) -> chapter (.xml)
|
||||
# Can be removed after the User's Guide is converted.
|
||||
.asciidoc.xml:
|
||||
$(SH) <<
|
||||
PATH=/usr/bin
|
||||
PYTHONHOME=/
|
||||
$(A2X) --verbose \
|
||||
--asciidoc-opts="--conf-file=asciidoc.conf --conf-file=asciidoctor-asciidoc.conf" \
|
||||
--no-xmllint \
|
||||
--format=docbook --doctype=book \
|
||||
$<
|
||||
<<
|
||||
mv $*.xml $*.dbk
|
||||
xmllint --xpath "//chapter | //preface | //appendix" $*.dbk > $@
|
||||
|
||||
.SUFFIXES: .asciidoc .xml
|
||||
|
||||
# -- (Public) targets -------------------------------------------------------
|
||||
|
||||
# Make all (default)
|
||||
|
|
@ -91,6 +72,19 @@ git_version.xml: git_version_check
|
|||
|
||||
wsug_x: wsug_html_chunked wsug_html user-guide-a4.pdf user-guide-us.pdf user-guide.chm
|
||||
|
||||
user-guide.xml: user-guide.asciidoc $(WSUG_FILES)
|
||||
@ echo --- WSUG - XML ---
|
||||
$(SH) <<
|
||||
PATH=/usr/bin
|
||||
PYTHONHOME=/
|
||||
$(A2X) --verbose \
|
||||
--attribute=docinfo \
|
||||
--asciidoc-opts="--conf-file=asciidoc.conf --conf-file=asciidoctor-asciidoc.conf" \
|
||||
--no-xmllint \
|
||||
--format=docbook \
|
||||
user-guide.asciidoc
|
||||
<<
|
||||
|
||||
# validate the content
|
||||
wsug.validated: $(WSUG_SOURCE)
|
||||
@ echo --- WSUG - VALIDATING XML ---
|
||||
|
|
@ -164,7 +158,7 @@ wsluarm: make-wsluarm.pl $(WSLUA_MODULES)
|
|||
|
||||
wsdg_x: wsdg_html_chunked wsdg_html developer-guide-a4.pdf developer-guide-us.pdf developer-guide.chm
|
||||
|
||||
developer-guide.xml: developer-guide.asciidoc $(WSDG_FILES) wsluarm
|
||||
developer-guide.xml: developer-guide.asciidoc $(WSDG_FILES) wsluarm
|
||||
@ echo --- WSDG - XML ---
|
||||
$(SH) <<
|
||||
PATH=/usr/bin
|
||||
|
|
|
|||
|
|
@ -4,19 +4,26 @@
|
|||
|
||||
<!-- <title><inlinegraphic entityref="WiresharkLogo" valign="middle" format="PNG"/> &DocumentTitle;</title> -->
|
||||
|
||||
<!--
|
||||
<authorgroup>
|
||||
<author><firstname>&AuthorFirstName;</firstname><surname>&AuthorSurname;</surname>
|
||||
<affiliation><orgname>&AuthorOrgName;</orgname></affiliation>
|
||||
</author>
|
||||
</authorgroup>
|
||||
-->
|
||||
<authorgroup>
|
||||
|
||||
<!--<edition>&DocumentEdition;</edition>
|
||||
<pubdate>2008</pubdate>-->
|
||||
<copyright><year>2004-2014</year>
|
||||
<holder>Ulf Lamping</holder>
|
||||
</copyright>
|
||||
<author><firstname>Ulf</firstname><surname>Lamping</surname>
|
||||
<!-- <affiliation><orgname></orgname></affiliation> -->
|
||||
<email>ulf.lamping[AT]web.de</email>
|
||||
</author>
|
||||
|
||||
<author><firstname>Luis</firstname><othername>E.</othername><othername>Garcia</othername><surname>Ontanon</surname>
|
||||
<!-- <affiliation><orgname></orgname></affiliation> -->
|
||||
<email>luis[AT]ontanon.org</email>
|
||||
</author>
|
||||
|
||||
</authorgroup>
|
||||
|
||||
<!--<edition>&DocumentEdition;</edition>
|
||||
<pubdate>2008</pubdate>-->
|
||||
<copyright><year>2004-2014</year>
|
||||
<holder>Ulf Lamping</holder>
|
||||
<holder>Luis E. Garcia Ontanon</holder>
|
||||
</copyright>
|
||||
|
||||
<revhistory>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,4 @@
|
|||
= Wireshark Developer's Guide =
|
||||
Ulf Lamping <ulf.lamping[AT]web.de>
|
||||
= Wireshark Developer's Guide
|
||||
//v1.0, February 2014: Finished conversion from DocBook to AsciiDoc
|
||||
:doctype: book
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,149 @@
|
|||
<!-- Document information for the User's Guide. -->
|
||||
|
||||
<subtitle>For Wireshark 1.99</subtitle>
|
||||
|
||||
<!--
|
||||
<title><inlinegraphic entityref="WiresharkLogo" valign="middle" format="PNG"/> &DocumentTitle;</title>
|
||||
-->
|
||||
|
||||
<authorgroup>
|
||||
|
||||
<author><firstname>Ulf</firstname><surname>Lamping</surname>
|
||||
<!-- <affiliation><orgname></orgname></affiliation> -->
|
||||
<email>ulf.lamping[AT]web.de</email>
|
||||
</author>
|
||||
|
||||
<author><firstname>Richard</firstname><surname>Sharpe</surname>
|
||||
<affiliation><jobtitle>Director</jobtitle><orgname>NS Computer Software and Services P/L</orgname></affiliation>
|
||||
<email>rsharpe[AT]ns.aus.com</email>
|
||||
</author>
|
||||
|
||||
<author><firstname>Ed</firstname><surname>Warnicke</surname>
|
||||
<!-- <affiliation><orgname></orgname></affiliation> -->
|
||||
<email>hagbard[AT]physics.rutgers.edu</email>
|
||||
</author>
|
||||
|
||||
</authorgroup>
|
||||
|
||||
|
||||
<!-- Author information as listed in the old DocBook version. -->
|
||||
<!-- Author's Names -->
|
||||
<!--
|
||||
<!ENTITY AuthorFullName "Ulf Lamping">
|
||||
<!ENTITY AuthorFirstName "Ulf">
|
||||
<!ENTITY AuthorOtherName "">
|
||||
<!ENTITY AuthorSurname "Lamping">
|
||||
|
||||
<!ENTITY AuthorFullName2 "Richard Sharpe">
|
||||
<!ENTITY AuthorFirstName2 "Richard">
|
||||
<!ENTITY AuthorOtherName2 "">
|
||||
<!ENTITY AuthorSurname2 "Sharpe">
|
||||
|
||||
<!ENTITY AuthorFullName3 "Ed Warnicke">
|
||||
<!ENTITY AuthorFirstName3 "Ed">
|
||||
<!ENTITY AuthorOtherName3 "">
|
||||
<!ENTITY AuthorSurname3 "Warnicke">
|
||||
|
||||
<!ENTITY AuthorFullName4 "Luis E. Garcia Ontanon">
|
||||
<!ENTITY AuthorFirstName4 "Luis">
|
||||
<!ENTITY AuthorOtherName4 "Enrique">
|
||||
<!ENTITY AuthorSurname4 "Garcia Ontanon">
|
||||
-->
|
||||
|
||||
<!--Author's Affiliation -->
|
||||
<!--
|
||||
<!ENTITY AuthorShortAffiliation "">
|
||||
<!ENTITY AuthorJobTitle "">
|
||||
<!ENTITY AuthorOrgName "">
|
||||
<!ENTITY AuthorOrgDiv "">
|
||||
<!ENTITY AuthorEmail "ulf.lamping[AT]web.de">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation2 "">
|
||||
<!ENTITY AuthorJobTitle2 "Director">
|
||||
<!ENTITY AuthorOrgName2 "NS Computer Software and Services P/L">
|
||||
<!ENTITY AuthorOrgDiv2 "">
|
||||
<!ENTITY AuthorEmail2 "rsharpe[AT]ns.aus.com">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation3 "">
|
||||
<!ENTITY AuthorJobTitle3 "">
|
||||
<!ENTITY AuthorOrgName3 "">
|
||||
<!ENTITY AuthorOrgDiv3 "">
|
||||
<!ENTITY AuthorEmail3 "hagbard[AT]physics.rutgers.edu">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation4 "">
|
||||
<!ENTITY AuthorJobTitle4 "">
|
||||
<!ENTITY AuthorOrgName4 "">
|
||||
<!ENTITY AuthorOrgDiv4 "">
|
||||
<!ENTITY AuthorEmail4 "luis [at] ontanon.org">
|
||||
-->
|
||||
|
||||
<copyright><year>2004-2014</year>
|
||||
<holder>Ulf Lamping</holder>
|
||||
<holder>Richard Sharpe</holder>
|
||||
<holder>Ed Warnicke</holder>
|
||||
</copyright>
|
||||
|
||||
<revhistory>
|
||||
|
||||
<revision>
|
||||
<revnumber>3.2</revnumber>
|
||||
<date>9 Nov 2014</date>
|
||||
<authorinitials>gcc</authorinitials>
|
||||
<revremark>Converted from DocBook to AsciiDoc.</revremark>
|
||||
</revision>
|
||||
|
||||
<revision>
|
||||
<revnumber>3.1</revnumber>
|
||||
<date>2 Nov 2014</date>
|
||||
<authorinitials>gcc</authorinitials>
|
||||
<revremark>Moved Lua reference from User's Guide to Developer's Guide.</revremark>
|
||||
</revision>
|
||||
|
||||
<revision><!-- ge10e4fb -->
|
||||
<revnumber>3.0.2</revnumber>
|
||||
<date>31 May 2006</date>
|
||||
<authorinitials>jk</authorinitials>
|
||||
<revremark>Further cleanup of Wireshark User Guide</revremark>
|
||||
</revision>
|
||||
|
||||
<revision>
|
||||
<revnumber>2.0.2</revnumber>
|
||||
<date>29 Jan 2005</date>
|
||||
<authorinitials>ul</authorinitials>
|
||||
<revremark>Add links to wiki example pages</revremark>
|
||||
</revision>
|
||||
|
||||
<!-- We removed the protocol pages without incrementing revnumber -->
|
||||
|
||||
<revision>
|
||||
<revnumber>2.0</revnumber>
|
||||
<date>6 Aug 2004</date>
|
||||
<authorinitials>ul</authorinitials>
|
||||
<revremark>Review updates</revremark>
|
||||
</revision>
|
||||
|
||||
<!-- 1.91 - 1.94 were review updates. Should we include them? -->
|
||||
|
||||
<revision>
|
||||
<revnumber>1.90</revnumber>
|
||||
<date>19 Jul 2004</date>
|
||||
<authorinitials>ul</authorinitials>
|
||||
<revremark>Updated for Ethereal 0.10.5.</revremark>
|
||||
</revision>
|
||||
|
||||
<!-- Earlier versions in http://anonsvn.wireshark.org/wireshark-doc/ -->
|
||||
|
||||
</revhistory>
|
||||
|
||||
<legalnotice>
|
||||
<simpara>
|
||||
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.
|
||||
</simpara>
|
||||
<simpara>
|
||||
All logos and trademarks in this document are property of their
|
||||
respective owner.
|
||||
</simpara>
|
||||
</legalnotice>
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
= Wireshark User's Guide
|
||||
//v1.0, February 2014: Finished conversion from DocBook to AsciiDoc
|
||||
:doctype: book
|
||||
|
||||
[[Preface]]
|
||||
["preface",id="Preface"]
|
||||
== Preface
|
||||
|
||||
include::wsug_src/WSUG_preface.asciidoc[]
|
||||
|
||||
// Chapters
|
||||
include::wsug_src/WSUG_chapter_introduction.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_build_install.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_use.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_capture.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_io.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_work.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_advanced.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_statistics.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_telephony.asciidoc[]
|
||||
include::wsug_src/WSUG_chapter_customize.asciidoc[]
|
||||
// Needs to be reworked
|
||||
//include::wsug_src/WSUG_chapter_troubleshoot.asciidoc[]
|
||||
|
||||
// Appendices
|
||||
include::wsug_src/WSUG_app_messages.asciidoc[]
|
||||
include::wsug_src/WSUG_app_files.asciidoc[]
|
||||
include::wsug_src/WSUG_app_protocols.asciidoc[]
|
||||
// Needs to be reworked
|
||||
//include::wsug_src/WSUG_app_howitworks.asciidoc[]
|
||||
include::wsug_src/WSUG_app_tools.asciidoc[]
|
||||
|
||||
// License
|
||||
include::GPL_appendix.asciidoc[]
|
||||
|
|
@ -1,363 +0,0 @@
|
|||
<?xml version="1.0"?>
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
||||
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
||||
|
||||
|
||||
<!--
|
||||
BIOGRAPHICAL SECTION
|
||||
-Use this section to encode all biographical information
|
||||
-->
|
||||
|
||||
<!-- Author's Names -->
|
||||
<!ENTITY AuthorFullName "Ulf Lamping">
|
||||
<!ENTITY AuthorFirstName "Ulf">
|
||||
<!ENTITY AuthorOtherName "">
|
||||
<!ENTITY AuthorSurname "Lamping">
|
||||
|
||||
<!ENTITY AuthorFullName2 "Richard Sharpe">
|
||||
<!ENTITY AuthorFirstName2 "Richard">
|
||||
<!ENTITY AuthorOtherName2 "">
|
||||
<!ENTITY AuthorSurname2 "Sharpe">
|
||||
|
||||
<!ENTITY AuthorFullName3 "Ed Warnicke">
|
||||
<!ENTITY AuthorFirstName3 "Ed">
|
||||
<!ENTITY AuthorOtherName3 "">
|
||||
<!ENTITY AuthorSurname3 "Warnicke">
|
||||
|
||||
<!ENTITY AuthorFullName4 "Luis E. Garcia Ontanon">
|
||||
<!ENTITY AuthorFirstName4 "Luis">
|
||||
<!ENTITY AuthorOtherName4 "Enrique">
|
||||
<!ENTITY AuthorSurname4 "Garcia Ontanon">
|
||||
|
||||
<!--Author's Affiliation -->
|
||||
<!ENTITY AuthorShortAffiliation "">
|
||||
<!ENTITY AuthorJobTitle "">
|
||||
<!ENTITY AuthorOrgName "">
|
||||
<!ENTITY AuthorOrgDiv "">
|
||||
<!ENTITY AuthorEmail "ulf.lamping[AT]web.de">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation2 "">
|
||||
<!ENTITY AuthorJobTitle2 "Director">
|
||||
<!ENTITY AuthorOrgName2 "NS Computer Software and Services P/L">
|
||||
<!ENTITY AuthorOrgDiv2 "">
|
||||
<!ENTITY AuthorEmail2 "rsharpe[AT]ns.aus.com">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation3 "">
|
||||
<!ENTITY AuthorJobTitle3 "">
|
||||
<!ENTITY AuthorOrgName3 "">
|
||||
<!ENTITY AuthorOrgDiv3 "">
|
||||
<!ENTITY AuthorEmail3 "hagbard[AT]physics.rutgers.edu">
|
||||
|
||||
<!ENTITY AuthorShortAffiliation4 "">
|
||||
<!ENTITY AuthorJobTitle4 "">
|
||||
<!ENTITY AuthorOrgName4 "">
|
||||
<!ENTITY AuthorOrgDiv4 "">
|
||||
<!ENTITY AuthorEmail4 "luis [at] ontanon.org">
|
||||
|
||||
<!--
|
||||
DOCUMENT SECTION
|
||||
-Use this section to encode all document information
|
||||
-->
|
||||
|
||||
<!ENTITY DocumentTitle "<application>Wireshark</application> User's Guide">
|
||||
<!ENTITY DocumentSubTitle "for Wireshark &WiresharkCurrentVersion;">
|
||||
<!ENTITY DocumentTitleAbbreviation "WSUG">
|
||||
|
||||
<!ENTITY DocumentCopyrightHolder1 "Ulf Lamping ">
|
||||
<!ENTITY DocumentCopyrightHolder2 "Richard Sharpe ">
|
||||
<!ENTITY DocumentCopyrightHolder3 "Ed Warnicke ">
|
||||
<!ENTITY DocumentCopyrightYear "2004-2014">
|
||||
|
||||
<!ENTITY DocumentEdition "Third ">
|
||||
<!ENTITY DocumentVersion "V3.0.2">
|
||||
<!ENTITY DocumentPubDate "2008">
|
||||
|
||||
<!ENTITY % GitVersionFile SYSTEM "git_version.xml">
|
||||
%GitVersionFile;
|
||||
<!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>">
|
||||
|
||||
<!--
|
||||
Wireshark Info
|
||||
-->
|
||||
<!ENTITY WiresharkCurrentVersion "1.99">
|
||||
<!ENTITY WiresharkWebSite "https://www.wireshark.org">
|
||||
<!ENTITY WiresharkUsersGuidePage "&WiresharkWebSite;/docs/">
|
||||
<!ENTITY WiresharkDownloadPage "&WiresharkWebSite;/download.html">
|
||||
<!ENTITY WiresharkBinariesPage "&WiresharkWebSite;/download.html">
|
||||
<!ENTITY WiresharkAuthorsPage "&WiresharkWebSite;/about.html">
|
||||
<!ENTITY WiresharkProtocolsPage "&WiresharkWebSite;/docs/dfref/">
|
||||
<!ENTITY WiresharkFAQPage "&WiresharkWebSite;/faq.html">
|
||||
<!ENTITY WiresharkFAQPromiscPage "&WiresharkWebSite;/faq.html#promiscsniff">
|
||||
<!ENTITY WiresharkWikiPage "http://wiki.wireshark.org">
|
||||
<!ENTITY WiresharkMediaPage "&WiresharkWikiPage;/CaptureSetup/NetworkMedia">
|
||||
<!ENTITY WiresharkWikiCaptureFiltersPage "&WiresharkWikiPage;/CaptureFilters">
|
||||
<!ENTITY WiresharkWikiDisplayFiltersPage "&WiresharkWikiPage;/DisplayFilters">
|
||||
<!ENTITY WiresharkWikiColoringRulesPage "&WiresharkWikiPage;/ColoringRules">
|
||||
<!ENTITY WiresharkWikiPreferencesPage "&WiresharkWikiPage;/Preferences">
|
||||
<!ENTITY WiresharkWikiPcapNgPage "&WiresharkWikiPage;/Development/PcapNg">
|
||||
<!ENTITY WiresharkQASite "http://ask.wireshark.org">
|
||||
<!ENTITY WiresharkListsPage "&WiresharkWebSite;/lists/">
|
||||
|
||||
<!ENTITY WiresharkDevMailList "wireshark-dev[AT]wireshark.org">
|
||||
<!ENTITY WiresharkUsersMailList "wireshark-users[AT]wireshark.org">
|
||||
|
||||
<!--
|
||||
Winpcap Info
|
||||
-->
|
||||
<!ENTITY WinPcapWebsite "http://www.winpcap.org">
|
||||
<!ENTITY WinPcapDownloadWebsite "&WinPcapWebsite;/install/default.htm">
|
||||
|
||||
<!--
|
||||
Tcpdump Info
|
||||
-->
|
||||
<!ENTITY TcpdumpWebsite "http://www.tcpdump.org">
|
||||
<!ENTITY TcpdumpManpage "&TcpdumpWebsite;/tcpdump_man.html">
|
||||
|
||||
<!--
|
||||
Misc Info
|
||||
-->
|
||||
<!ENTITY SysFsUtils "http://linux-diag.sourceforge.net/Sysfsutils.html">
|
||||
|
||||
<!--
|
||||
Gnu info
|
||||
-->
|
||||
<!ENTITY GPLWebsite "http://www.gnu.org/copyleft/gpl.html">
|
||||
|
||||
<!--
|
||||
Timezone info
|
||||
-->
|
||||
<!ENTITY TimezoneGMTSite "http://wwp.greenwichmeantime.com/">
|
||||
<!ENTITY TimezoneWorldClockSite "http://www.timeanddate.com/worldclock/">
|
||||
<!ENTITY NTPSite "http://www.ntp.org/">
|
||||
<!ENTITY WikipediaWebsite "http://en.wikipedia.org">
|
||||
<!ENTITY WikipediaTimezone "&WikipediaWebsite;/wiki/Time_zone">
|
||||
<!ENTITY WikipediaDaylightSaving "&WikipediaWebsite;/wiki/Daylight_saving">
|
||||
<!ENTITY WikipediaUTC "&WikipediaWebsite;/wiki/Coordinated_Universal_Time">
|
||||
|
||||
<!--
|
||||
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 WiresharkLogo SYSTEM "./wsug_graphics/ws-logo.png" NDATA PNG>
|
||||
|
||||
<!-- 1st Chapter -->
|
||||
<!ENTITY WiresharkMain1 SYSTEM "./wsug_graphics/ws-main.png" NDATA PNG>
|
||||
|
||||
<!-- 2nd Chapter -->
|
||||
|
||||
<!-- Third Chapter -->
|
||||
<!ENTITY WiresharkEmpty SYSTEM "./wsug_graphics/ws-empty.png" NDATA PNG>
|
||||
<!ENTITY WiresharkThreePane1 SYSTEM "./wsug_graphics/ws-main.png" NDATA PNG>
|
||||
<!ENTITY WiresharkMenuOnly SYSTEM "./wsug_graphics/ws-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkMainToolbar SYSTEM "./wsug_graphics/ws-main-toolbar.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFilterToolbar SYSTEM "./wsug_graphics/ws-filter-toolbar.png" NDATA PNG>
|
||||
<!ENTITY WiresharkListPane SYSTEM "./wsug_graphics/ws-list-pane.png" NDATA PNG>
|
||||
<!ENTITY WiresharkDetailsPane SYSTEM "./wsug_graphics/ws-details-pane.png" NDATA PNG>
|
||||
<!ENTITY WiresharkBytesPane SYSTEM "./wsug_graphics/ws-bytes-pane.png" NDATA PNG>
|
||||
<!ENTITY WiresharkBytesPaneTabs SYSTEM "./wsug_graphics/ws-bytes-pane-tabs.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatusbarEmpty SYSTEM "./wsug_graphics/ws-statusbar-empty.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatusbarLoaded SYSTEM "./wsug_graphics/ws-statusbar-loaded.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatusbarProfile SYSTEM "./wsug_graphics/ws-statusbar-profile.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatusbarSelected SYSTEM "./wsug_graphics/ws-statusbar-selected.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatusbarFilter SYSTEM "./wsug_graphics/ws-statusbar-filter.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPacketSelected1 SYSTEM "./wsug_graphics/ws-packet-selected.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPacketSepView SYSTEM "./wsug_graphics/ws-packet-sep-win.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFilterTCP SYSTEM "./wsug_graphics/ws-display-filter-tcp.png" NDATA PNG>
|
||||
<!ENTITY WiresharkColoringRulesDialog SYSTEM "./wsug_graphics/ws-coloring-rules-dialog.png" NDATA PNG>
|
||||
<!ENTITY WiresharkColoringFields SYSTEM "./wsug_graphics/ws-coloring-fields.png" NDATA PNG>
|
||||
<!ENTITY WiresharkEditColorDialog SYSTEM "./wsug_graphics/ws-edit-color-rule-dialog.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExpertColoredTree SYSTEM "./wsug_graphics/ws-expert-colored-tree.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExpertColumn SYSTEM "./wsug_graphics/ws-expert-column.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExpertInfoDialog SYSTEM "./wsug_graphics/ws-expert-infos.png" NDATA PNG>
|
||||
<!ENTITY WiresharkChooseColorDialog SYSTEM "./wsug_graphics/ws-choose-color-rule.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFollowStream SYSTEM "./wsug_graphics/ws-follow-stream.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFindPacket SYSTEM "./wsug_graphics/ws-find-packet.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGoToPacket SYSTEM "./wsug_graphics/ws-goto-packet.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIPreferences SYSTEM "./wsug_graphics/ws-gui-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIInterfaceOptions SYSTEM "./wsug_graphics/ws-gui-interface-options.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUILayoutPreferences SYSTEM "./wsug_graphics/ws-gui-layout-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIColumnsPreferences SYSTEM "./wsug_graphics/ws-gui-columns-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIFontPreferences SYSTEM "./wsug_graphics/ws-gui-font-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIColorsPreferences SYSTEM "./wsug_graphics/ws-gui-colors-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGUIConfigProfiles SYSTEM "./wsug_graphics/ws-gui-config-profiles.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCapturePreferences SYSTEM "./wsug_graphics/ws-capture-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPrintingPreferences SYSTEM "./wsug_graphics/ws-printing-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkNameResolutionPreferences SYSTEM "./wsug_graphics/ws-nameresolution-preferences.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFilters SYSTEM "./wsug_graphics/ws-filters.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFileMenu SYSTEM "./wsug_graphics/ws-file-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkEditMenu SYSTEM "./wsug_graphics/ws-edit-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkViewMenu SYSTEM "./wsug_graphics/ws-view-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkGoMenu SYSTEM "./wsug_graphics/ws-go-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureMenu SYSTEM "./wsug_graphics/ws-capture-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkAnalyzeMenu SYSTEM "./wsug_graphics/ws-analyze-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatisticsMenu SYSTEM "./wsug_graphics/ws-statistics-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkTelephonyMenu SYSTEM "./wsug_graphics/ws-telephony-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolsMenu SYSTEM "./wsug_graphics/ws-tools-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkInternalsMenu SYSTEM "./wsug_graphics/ws-internals-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkHelpMenu SYSTEM "./wsug_graphics/ws-help-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkColumnHeaderPopupMenu SYSTEM "./wsug_graphics/ws-column-header-popup-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPacketPanePopupMenu SYSTEM "./wsug_graphics/ws-packet-pane-popup-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkDetailsPanePopupMenu SYSTEM "./wsug_graphics/ws-details-pane-popup-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkBytesPanePopupMenu SYSTEM "./wsug_graphics/ws-bytes-pane-popup-menu.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFilterAddExpression SYSTEM "./wsug_graphics/ws-filter-add-expression.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFilters2 SYSTEM "./wsug_graphics/ws-filters-2.png" NDATA PNG>
|
||||
<!ENTITY WiresharkTimeReference SYSTEM "./wsug_graphics/ws-time-reference.png" NDATA PNG>
|
||||
<!ENTITY WiresharkEnabledProtocols SYSTEM "./wsug_graphics/ws-enabled-protocols.png" NDATA PNG>
|
||||
<!ENTITY WiresharkDecodeAs SYSTEM "./wsug_graphics/ws-decode-as.png" NDATA PNG>
|
||||
<!ENTITY WiresharkDecodeAsShow SYSTEM "./wsug_graphics/ws-decode-as-show.png" NDATA PNG>
|
||||
|
||||
<!-- Third Chapter Toolbar-->
|
||||
<!ENTITY WiresharkToolbarCaptureInterfaces SYSTEM "./wsug_graphics/toolbar/capture_interfaces_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarCaptureOptions SYSTEM "./wsug_graphics/toolbar/capture_options_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarCaptureStart SYSTEM "./wsug_graphics/toolbar/capture_start_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarCaptureStop SYSTEM "./wsug_graphics/toolbar/capture_stop_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarCaptureRestart SYSTEM "./wsug_graphics/toolbar/capture_restart_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarCaptureFilters SYSTEM "./wsug_graphics/toolbar/capture_filter_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarDisplayFilters SYSTEM "./wsug_graphics/toolbar/display_filter_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarAdd SYSTEM "./wsug_graphics/toolbar/stock_add_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarApply SYSTEM "./wsug_graphics/toolbar/stock_apply_20.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarGoLast SYSTEM "./wsug_graphics/toolbar/stock_bottom_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarClear SYSTEM "./wsug_graphics/toolbar/stock_clear_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarClose SYSTEM "./wsug_graphics/toolbar/stock_close_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarColoringRules SYSTEM "./wsug_graphics/toolbar/stock_colorselector_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarHelp SYSTEM "./wsug_graphics/toolbar/stock_help_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarGoTo SYSTEM "./wsug_graphics/toolbar/stock_jump_to_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarGoBack SYSTEM "./wsug_graphics/toolbar/stock_left_arrow_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarOpen SYSTEM "./wsug_graphics/toolbar/stock_open_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarPreferences SYSTEM "./wsug_graphics/toolbar/stock_preferences_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarPrint SYSTEM "./wsug_graphics/toolbar/stock_print_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarProperties SYSTEM "./wsug_graphics/toolbar/stock_properties_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarReload SYSTEM "./wsug_graphics/toolbar/stock_refresh_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarGoForward SYSTEM "./wsug_graphics/toolbar/stock_right_arrow_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarSave SYSTEM "./wsug_graphics/toolbar/stock_save_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarSaveAs SYSTEM "./wsug_graphics/toolbar/stock_save_as_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarFind SYSTEM "./wsug_graphics/toolbar/stock_search_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarStop SYSTEM "./wsug_graphics/toolbar/stock_stop_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarGoFirst SYSTEM "./wsug_graphics/toolbar/stock_top_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarZoom100 SYSTEM "./wsug_graphics/toolbar/stock_zoom_1_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarZoomIn SYSTEM "./wsug_graphics/toolbar/stock_zoom_in_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarZoomOut SYSTEM "./wsug_graphics/toolbar/stock_zoom_out_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarColorize SYSTEM "./wsug_graphics/toolbar/colorize_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarAutoScroll SYSTEM "./wsug_graphics/toolbar/autoscroll_24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkToolbarResizeColumns SYSTEM "./wsug_graphics/toolbar/resize_columns_24.png" NDATA PNG>
|
||||
|
||||
<!-- Third Chapter Statistics -->
|
||||
<!ENTITY WiresharkStatsSummary SYSTEM "./wsug_graphics/ws-stats-summary.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsHierarchy SYSTEM "./wsug_graphics/ws-stats-hierarchy.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsEndpoints SYSTEM "./wsug_graphics/ws-stats-endpoints.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsConversations SYSTEM "./wsug_graphics/ws-stats-conversations.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsIOGraphs SYSTEM "./wsug_graphics/ws-stats-iographs.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsCompare SYSTEM "./wsug_graphics/ws-stats-compare.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsWLANTraffic SYSTEM "./wsug_graphics/ws-stats-wlan-traffic.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsLTEMACTraffic SYSTEM "./wsug_graphics/ws-stats-lte-mac-traffic.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsLTERLCTraffic SYSTEM "./wsug_graphics/ws-stats-lte-rlc-traffic.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsSrtDcerpcFilter SYSTEM "./wsug_graphics/ws-stats-srt-dcerpc-filter.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsSrtDcerpc SYSTEM "./wsug_graphics/ws-stats-srt-dcerpc.png" NDATA PNG>
|
||||
|
||||
<!-- Chapter Telephony -->
|
||||
<!ENTITY WiresharkTelRTPStreamAnalysis SYSTEM "./wsug_graphics/ws-tel-rtpstream-analysis.png" NDATA PNG>
|
||||
<!ENTITY WiresharkStatsLTEMACTraffic SYSTEM "./wsug_graphics/ws-stats-lte-mac-traffic.png" NDATA PNG>
|
||||
|
||||
<!-- Fourth Chapter -->
|
||||
<!ENTITY WiresharkCaptureInterfacesDialog SYSTEM "./wsug_graphics/ws-capture-interfaces.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureInterfacesDialogWin32 SYSTEM "./wsug_graphics/ws-capture-interfaces-win32.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureOptionsDialog SYSTEM "./wsug_graphics/ws-capture-options.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureEditInterfacesSettingsDialog SYSTEM "./wsug_graphics/ws-capture-options-settings.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureCompileSelectedBPFsDialog SYSTEM "./wsug_graphics/ws-capture-options-compile-selected-bpfs.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureManageInterfacesDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureManageInterfacesPipesDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-pipes.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureManageInterfacesLocalDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-local.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureManageInterfacesRemoteDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-remote.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureInterfaceDetailsDialog SYSTEM "./wsug_graphics/ws-capture-interface-details.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureInfoDialog SYSTEM "./wsug_graphics/ws-capture-info.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureOptionsRemoteInterfacesDialog SYSTEM "./wsug_graphics/ws-capture-options-manage-interfaces-remote-plus.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureOptionsRemoteCaptureDialog SYSTEM "./wsug_graphics/ws-capture-options-remote-capture.png" NDATA PNG>
|
||||
<!ENTITY WiresharkCaptureOptionsRemoteSettingsDialog SYSTEM "./wsug_graphics/ws-capture-options-remote-settings.png" NDATA PNG>
|
||||
|
||||
<!-- Fifth Chapter -->
|
||||
<!ENTITY WiresharkOpenDialog24 SYSTEM "./wsug_graphics/ws-open-gtk24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkSaveAsDialog24 SYSTEM "./wsug_graphics/ws-save-as-gtk24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkMergeDialog24 SYSTEM "./wsug_graphics/ws-merge-gtk24.png" NDATA PNG>
|
||||
<!ENTITY WiresharkOpenDialogWin32 SYSTEM "./wsug_graphics/ws-open-win32.png" NDATA PNG>
|
||||
<!ENTITY WiresharkSaveAsDialogWin32 SYSTEM "./wsug_graphics/ws-save-as-win32.png" NDATA PNG>
|
||||
<!ENTITY WiresharkMergeDialogWin32 SYSTEM "./wsug_graphics/ws-merge-win32.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFileImportDialog SYSTEM "./wsug_graphics/ws-file-import.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFileSetDialog SYSTEM "./wsug_graphics/ws-file-set-dialog.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportPlainDialog SYSTEM "./wsug_graphics/ws-export-plain.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportPSDialog SYSTEM "./wsug_graphics/ws-export-ps.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportPSMLDialog SYSTEM "./wsug_graphics/ws-export-psml.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportPDMLDialog SYSTEM "./wsug_graphics/ws-export-pdml.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportSelectedDialog SYSTEM "./wsug_graphics/ws-export-selected.png" NDATA PNG>
|
||||
<!ENTITY WiresharkExportObjectsDialog SYSTEM "./wsug_graphics/ws-export-objects.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPrint SYSTEM "./wsug_graphics/ws-print.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPacketRangeFrame SYSTEM "./wsug_graphics/ws-packet-range.png" NDATA PNG>
|
||||
<!ENTITY WiresharkPacketFormatFrame SYSTEM "./wsug_graphics/ws-packet-format.png" NDATA PNG>
|
||||
|
||||
<!-- Sixth Chapter -->
|
||||
|
||||
<!-- Appendices etc -->
|
||||
<!ENTITY WiresharkFormatError SYSTEM "./wsug_graphics/ws-error-open.png" NDATA PNG>
|
||||
<!ENTITY WiresharkFormatError SYSTEM "./wsug_graphics/ws-error-open.png" NDATA PNG>
|
||||
<!ENTITY WiresharkSaveError SYSTEM "./wsug_graphics/ws-save-error.png" NDATA PNG>
|
||||
|
||||
|
||||
<!-- These are the actual files that make up the document -->
|
||||
<!ENTITY BookMetaInformation SYSTEM "wsug_src/WSUG_meta_info.xml">
|
||||
<!ENTITY Preface SYSTEM "wsug_src/WSUG_preface.xml">
|
||||
<!ENTITY ChapterIntroduction SYSTEM "wsug_src/WSUG_chapter_introduction.xml">
|
||||
<!ENTITY ChapterBuildInstall SYSTEM "wsug_src/WSUG_chapter_build_install.xml">
|
||||
<!ENTITY ChapterUse SYSTEM "wsug_src/WSUG_chapter_use.xml">
|
||||
<!ENTITY ChapterCapture SYSTEM "wsug_src/WSUG_chapter_capture.xml">
|
||||
<!ENTITY ChapterIo SYSTEM "wsug_src/WSUG_chapter_io.xml">
|
||||
<!ENTITY ChapterWork SYSTEM "wsug_src/WSUG_chapter_work.xml">
|
||||
<!ENTITY ChapterAdvanced SYSTEM "wsug_src/WSUG_chapter_advanced.xml">
|
||||
<!ENTITY ChapterStatistics SYSTEM "wsug_src/WSUG_chapter_statistics.xml">
|
||||
<!ENTITY ChapterTelephony SYSTEM "wsug_src/WSUG_chapter_telephony.xml">
|
||||
<!ENTITY ChapterCustomize SYSTEM "wsug_src/WSUG_chapter_customize.xml">
|
||||
<!ENTITY ChapterTroubleshoot SYSTEM "wsug_src/WSUG_chapter_troubleshoot.xml">
|
||||
<!ENTITY AppMessages SYSTEM "wsug_src/WSUG_app_messages.xml">
|
||||
<!ENTITY AppFiles SYSTEM "wsug_src/WSUG_app_files.xml">
|
||||
<!ENTITY AppProtocols SYSTEM "wsug_src/WSUG_app_protocols.xml">
|
||||
<!ENTITY AppHowItWorks SYSTEM "wsug_src/WSUG_app_howitworks.xml">
|
||||
<!ENTITY AppTools SYSTEM "wsug_src/WSUG_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;
|
||||
&ChapterTelephony;
|
||||
&ChapterCustomize;
|
||||
|
||||
&AppFiles;
|
||||
&AppProtocols;
|
||||
&AppMessages;
|
||||
&AppTools;
|
||||
|
||||
&AppGPL;
|
||||
|
||||
<!-- Removed, as these chapters must be reworked
|
||||
&Glossary;
|
||||
&Index;
|
||||
&AppHowItWorks;
|
||||
&ChapterTroubleshoot;
|
||||
-->
|
||||
</book>
|
||||
|
|
@ -1,37 +0,0 @@
|
|||
|
||||
<bookinfo>
|
||||
<title><inlinegraphic entityref="WiresharkLogo" valign="middle" format="PNG"/> &DocumentTitle;</title>
|
||||
<subtitle>&DocumentSubTitle;</subtitle>
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname>&AuthorFirstName;</firstname>
|
||||
<surname>&AuthorSurname;</surname>
|
||||
<affiliation><orgname>&AuthorOrgName;</orgname></affiliation>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>&AuthorFirstName2;</firstname>
|
||||
<surname>&AuthorSurname2;</surname>
|
||||
<affiliation><orgname>&AuthorOrgName2;</orgname></affiliation>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>&AuthorFirstName3;</firstname>
|
||||
<surname>&AuthorSurname3;</surname>
|
||||
<affiliation><orgname>&AuthorOrgName3;</orgname></affiliation>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<!-- <edition>&DocumentEdition;</edition>
|
||||
<pubdate>&DocumentPubDate;</pubdate> -->
|
||||
<copyright>
|
||||
<year>&DocumentCopyrightYear;</year>
|
||||
<holder>&DocumentCopyrightHolder1;</holder>
|
||||
<holder>&DocumentCopyrightHolder2;</holder>
|
||||
<holder>&DocumentCopyrightHolder3;</holder>
|
||||
</copyright>
|
||||
|
||||
<graphic scale="100" entityref="WiresharkLogo" format="PNG"/>
|
||||
|
||||
<legalnotice>
|
||||
&DocumentLegalNotice;
|
||||
</legalnotice>
|
||||
|
||||
</bookinfo>
|
||||
|
|
@ -1,8 +1,6 @@
|
|||
[[Preface]]
|
||||
|
||||
[preface]
|
||||
|
||||
== Preface
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
<!-- WSUG Preface -->
|
||||
++++++++++++++++++++++++++++++++++++++
|
||||
|
||||
[[PreForeword]]
|
||||
|
||||
|
|
@ -15,7 +13,7 @@ Wireshark because of the lack of documentation.
|
|||
This document is part of an effort by the Wireshark team to improve the
|
||||
usability of Wireshark.
|
||||
|
||||
We hope that you find it useful and look forward to your comments.
|
||||
We hope that you find it useful and look forward to your comments.
|
||||
|
||||
[[PreAudience]]
|
||||
|
||||
|
|
@ -36,14 +34,14 @@ By reading this book, you will learn how to install Wireshark, how to use the
|
|||
basic elements of the graphical user interface (such as the menu) and what's
|
||||
behind some of the advanced features that are not always obvious at first sight.
|
||||
It will hopefully guide you around some common problems that frequently appear
|
||||
for new (and sometimes even advanced) users of Wireshark.
|
||||
for new (and sometimes even advanced) users of Wireshark.
|
||||
|
||||
[[PreAck]]
|
||||
|
||||
=== Acknowledgements
|
||||
|
||||
The authors would like to thank the whole Wireshark team for their assistance.
|
||||
In particular, the authors would like to thank:
|
||||
In particular, the authors would like to thank:
|
||||
|
||||
* Gerald Combs, for initiating the Wireshark project and funding to do this
|
||||
documentation.
|
||||
|
|
@ -51,23 +49,23 @@ In particular, the authors would like to thank:
|
|||
* Guy Harris, for many helpful hints and a great deal of patience in reviewing
|
||||
this document.
|
||||
|
||||
* Gilbert Ramirez, for general encouragement and helpful hints along the way.
|
||||
* Gilbert Ramirez, for general encouragement and helpful hints along the way.
|
||||
|
||||
The authors would also like to thank the following people for their helpful
|
||||
feedback on this document:
|
||||
feedback on this document:
|
||||
|
||||
* Pat Eyler, for his suggestions on improving the example on generating a backtrace.
|
||||
* Pat Eyler, for his suggestions on improving the example on generating a backtrace.
|
||||
|
||||
* Martin Regner, for his various suggestions and corrections.
|
||||
* Martin Regner, for his various suggestions and corrections.
|
||||
|
||||
* Graeme Hewson, for a lot of grammatical corrections.
|
||||
* Graeme Hewson, for a lot of grammatical corrections.
|
||||
|
||||
The authors would like to acknowledge those man page and README authors for the
|
||||
Wireshark project from who sections of this document borrow heavily:
|
||||
Wireshark project from who sections of this document borrow heavily:
|
||||
|
||||
* Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
|
||||
* Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
|
||||
|
||||
* Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
|
||||
* Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
|
||||
|
||||
[[PreAbout]]
|
||||
|
||||
|
|
@ -76,39 +74,39 @@ Wireshark project from who sections of this document borrow heavily:
|
|||
This book was originally developed by mailto:wsug-author-email2:[][Richard
|
||||
Sharpe] with funds provided from the Wireshark Fund. It was updated by
|
||||
mailto:wsug-author-email3:[][Ed Warnicke] and more recently redesigned and
|
||||
updated by mailto:wsug-author-email:[][Ulf Lamping].
|
||||
updated by mailto:wsug-author-email:[][Ulf Lamping].
|
||||
|
||||
It was originally written in DocBook/XML and converted to AsciiDoc by Gerald Combs.
|
||||
It was originally written in DocBook/XML and converted to AsciiDoc by Gerald Combs.
|
||||
|
||||
You will find some specially marked parts in this book:
|
||||
You will find some specially marked parts in this book:
|
||||
|
||||
[WARNING]
|
||||
.This is a warning
|
||||
====
|
||||
You should pay attention to a warning, otherwise data loss might occur.
|
||||
You should pay attention to a warning, otherwise data loss might occur.
|
||||
====
|
||||
|
||||
[NOTE]
|
||||
.This is a note
|
||||
====
|
||||
A note will point you to common mistakes and things that might not be obvious.
|
||||
A note will point you to common mistakes and things that might not be obvious.
|
||||
====
|
||||
|
||||
[TIP]
|
||||
.This is a tip
|
||||
====
|
||||
Tips are helpful for your everyday work using Wireshark.
|
||||
Tips are helpful for your everyday work using Wireshark.
|
||||
====
|
||||
|
||||
[[PreDownload]]
|
||||
|
||||
=== Where to get the latest copy of this document?
|
||||
|
||||
The latest copy of this documentation can always be found at wireshark-users-guide-url:[][].
|
||||
The latest copy of this documentation can always be found at wireshark-users-guide-url:[][].
|
||||
|
||||
[[PreFeedback]]
|
||||
|
||||
=== Providing feedback about this document
|
||||
|
||||
Should you have any feedback about this document, please send it to the authors
|
||||
through mailto:wireshark-dev-list-email:[][wireshark-dev-list-email:[]].
|
||||
through mailto:wireshark-dev-list-email:[][wireshark-dev-list-email:[]].
|
||||
|
|
|
|||
Loading…
Reference in New Issue