Quick Start - MacOS
This guide will help you install and build your first PcapPlusPlus application on MacOS in a few simple steps.
Table of contents
- Step 1 - install PcapPlusPlus
- Step 2 - create your first app
- Step 3 - create a Makefile
- Step 4 - build and run your app
Step 1 - install PcapPlusPlus
Before installing PcapPlusPlus make sure you have the prerequisites installed for MacOS.
The easiest way to get PcapPlusPlus is from Homebrew:
brew install pcapplusplus
If you prefer not to use Homebrew you can also found pre-compiled packages for various versions of MacOS and Xcode in the latest release page. After downloading and extracting the archive file go to:
/path/to/your/package/ and run the installation script:
Step 2 - create your first app
If you installed PcapPlusPlus using Homebrew go to the Hello World tutorial on GitHub and get the files in that directory.
If you downloaded a pre-compiled package go to:
If you built it from source go to:
Make sure you see the following files:
|-- main.cpp |-- 1_packet.pcap
main.cpp is the example application we’ll use.
1_packet.pcap is a pcap file the app reads from.
Step 3 - create a Makefile
If you downloaded a pre-compiled package you can find a Makefile in
/path/to/your/package/example-app. This Makefile is already configured.
If you built it from source or downloaded it from GitHub:
- go to the directory of the tutorial
Step 4 - build and run your app
make to build the app:
An executable file will be created which contains the compiled app. You can now run it and should be able to see the following output:
Source IP is '10.0.0.138'; Dest IP is '10.0.0.1'