Chapter 3. Work with the Wireshark sources

Table of Contents

3.1. Introduction
3.2. The Wireshark Git repository
3.2.1. The web interface to the Git repository
3.2.2. Git Naming Conventions
3.3. Obtain the Wireshark sources
3.3.1. Git over SSH or HTTPS
3.3.2. Git web interface
3.3.3. Buildbot Snapshots
3.3.4. Released sources
3.4. Update the Wireshark sources
3.4.1. Update Using Git
3.4.2. Update Using Source Archives
3.5. Build Wireshark
3.5.1. Building on Unix
3.5.2. Windows native
3.6. Run generated Wireshark
3.6.1. Unix-like platforms
3.6.2. Windows native
3.7. Debug Your Generated Wireshark
3.7.1. Unix-Like Platforms
3.7.2. Windows native
3.8. Make changes to the Wireshark sources
3.9. Contribute your changes
3.9.1. Some Tips For A Good Patch
3.9.2. Writing a Good Commit Message
3.9.3. Code Requirements
3.9.4. Uploading your changes
3.9.5. Backporting a change
3.10. Apply a patch from someone else
3.10.1. Using patch
3.11. Binary Packaging
3.11.1. Packaging Guidelines
3.11.2. Debian: .deb Packages
3.11.3. Red Hat: .rpm Packages
3.11.4. macOS: .dmg Packages
3.11.5. Windows: NSIS .exe Installer
3.11.6. Windows: PortableApps .paf.exe Package
3.12. Mime Types
3.12.1. Display Filter
3.12.2. Coloring Rules
3.12.3. Filter List
3.12.4. Column List

3.1. Introduction

This chapter will explain how to work with the Wireshark source code. It will show you how to:

  • Get the source
  • Compile it on your machine
  • Submit changes for inclusion in the official release

This chapter will not explain the source file contents in detail, such as where to find specific functionality. This is done in Section 7.1, “Source overview”.