TODO epan/dissectors/asn1/kerberos/packet-kerberos-template.c new GSS flags
[wireshark-sm.git] / doc / wsug_src / wsug_preface.adoc
blobc343a80547f026e2dcaa5fd9d6ab0e5904bacdb8
1 [#Preface]
2 ["preface",id="Preface"]
3 == Preface
5 [#PreForeword]
7 === Foreword
9 Wireshark is the world’s foremost network protocol analyzer,
10 but the rich feature set can be daunting for the unfamiliar.
11 This document is part of an effort by the Wireshark team to improve
12 Wireshark's usability.
13 We hope that you find it useful and look forward to your comments.
15 [#PreAudience]
17 === Who should read this document?
19 The intended audience of this book is anyone using Wireshark.
21 This book explains all of the basic and some advanced features
22 of Wireshark. As Wireshark has become a very complex program,
23 not every feature may be explained in this book.
25 This book is not intended to explain network sniffing in general and it
26 will not provide details about specific network protocols. A lot of
27 useful information regarding these topics can be found at the Wireshark
28 Wiki at link:{wireshark-wiki-url}[].
30 By reading this book, you will learn how to install Wireshark, how to use the
31 basic elements of the graphical user interface (such as the menu) and what’s
32 behind some of the advanced features that are not always obvious at first sight.
33 It will hopefully guide you around some common problems that frequently appear
34 for new (and sometimes even advanced) Wireshark users.
36 [#PreAck]
38 === Acknowledgements
40 The authors would like to thank the whole Wireshark team for their assistance.
41 In particular, the authors would like to thank:
43 * Gerald Combs, for initiating the Wireshark project and funding to do this
44   documentation.
46 * Guy Harris, for many helpful hints and a great deal of patience in reviewing
47   this document.
49 * Gilbert Ramirez, for general encouragement and helpful hints along the way.
51 The authors would also like to thank the following people for their helpful
52 feedback on this document:
54 * Pat Eyler, for his suggestions on improving the example on generating a backtrace.
56 * Martin Regner, for his various suggestions and corrections.
58 * Graeme Hewson, for many grammatical corrections.
60 The authors would like to acknowledge those man page and README authors for the
61 Wireshark project from who sections of this document borrow heavily:
63 * Scott Renfro from whose `mergecap` man page <<AppToolsmergecap>> is derived.
65 * Ashok Narayanan from whose `text2pcap` man page <<AppToolstext2pcap>> is derived.
67 [#PreAbout]
69 === About this document
71 This book was originally developed by mailto:{wsug-author-email2}[Richard
72 Sharpe] with funds provided from the Wireshark Fund. It was updated by
73 mailto:{wsug-author-email3}[Ed Warnicke] and more recently redesigned and
74 updated by mailto:{wsug-author-email}[Ulf Lamping].
76 It was originally written in DocBook/XML and converted to AsciiDoc by
77 Gerald Combs.
79 [#PreDownload]
81 === Where to get the latest copy of this document?
83 The latest copy of this documentation can always be found at
84 {wireshark-users-guide-url}.
86 [#PreFeedback]
88 === Providing feedback about this document
90 Should you have any feedback about this document, please send it to the
91 authors through mailto:{wireshark-dev-list-email}[].