User Guide

Table of Contents
Preface ............................................................................................................. viii
1. Foreword .............................................................................................. viii
2. Who should read this document? ................................................................. ix
3. Acknowledgements .................................................................................... x
4. About this document ................................................................................. xi
5. Where to get the latest copy of this document? .............................................. xii
6. Providing feedback about this document ..................................................... xiii
I. Wireshark Build Environment ............................................................................... 1
1. Introduction .............................................................................................. 2
1.1. Introduction ................................................................................... 2
1.2. What is Wireshark? ......................................................................... 3
1.3. Platforms Wireshark runs on ............................................................. 4
1.3.1. Unix ................................................................................... 4
1.3.2. Linux ................................................................................. 4
1.3.3. Microsoft Windows ............................................................... 5
1.4. Development and maintenance of Wireshark ........................................ 6
1.4.1. Programming language(s) used ................................................ 6
1.4.2. Open Source Software ........................................................... 6
1.5. Releases and distributions ................................................................. 8
1.5.1. Binary distributions ............................................................... 8
1.5.2. Source code distributions ....................................................... 8
1.6. Automated Builds (Buildbot) ............................................................. 9
1.6.1. Advantages .......................................................................... 9
1.6.2. What does the Buildbot do? .................................................... 9
1.7. Reporting problems and getting help ..................................................10
1.7.1. Website .............................................................................10
1.7.2. Wiki ..................................................................................10
1.7.3. FAQ ..................................................................................10
1.7.4. Other sources ......................................................................10
1.7.5. Mailing Lists ......................................................................10
1.7.6. Bug database (Bugzilla) ........................................................11
1.7.7. Reporting Problems ..............................................................11
1.7.8. Reporting Crashes on UNIX/Linux platforms ............................12
1.7.9. Reporting Crashes on Windows platforms ................................12
2. Quick Setup .............................................................................................14
2.1. UNIX: Installation ..........................................................................14
2.2. Win32: Step-by-Step Guide ..............................................................15
2.2.1. Install Microsoft C compiler and Platform SDK .........................15
2.2.2. Install Cygwin .....................................................................15
2.2.3. Install Python ......................................................................16
2.2.4. Install Subversion Client .......................................................16
2.2.5. Install and Prepare Sources ....................................................16
2.2.6. Prepare cmd.exe ..................................................................17
2.2.7. Verify installed tools ............................................................17
2.2.8. Install Libraries ...................................................................18
2.2.9. Distclean Sources ................................................................18
2.2.10. Build Wireshark .................................................................18
2.2.11. Debug Environment Setup (XXX) .........................................19
2.2.12. Optional: Create User's and Developer's Guide ........................19
2.2.13. Optional: Create a Wireshark Installer ....................................19
3. Work with the Wireshark sources .................................................................21
3.1. Introduction ..................................................................................21
3.2. The Wireshark Subversion repository .................................................22
3.2.1. The web interface to the Subversion repository ..........................22
3.3. Obtain the Wireshark sources ...........................................................24
3.3.1. Anonymous Subversion access ...............................................24
3.3.2. Anonymous Subversion web interface .....................................24
iv