The instructions on this wiki page are outdated, see #3531 to resolve this.
See Wireshark for general installation and usage instructions related to Osmocom.
The WireShark packet sniffer normally doesn't support APCO P25. If you want to sniff P25 traffic using WireShark then you'll need to patch the sources and rebuild it.
You first need to obtain the source code for WireShark. The stable release of WireShark is available from the [http://www.wireshark.org/download.html downloads section of the WireShark web-site]. On that page you should be go to the "Get WireShark" for the stable release (1.8.5 at the time of writing). Click on "Source Code" to download the file.
To unpack the source tree you need to open a shell and execute the following commands:
mkdir -p SourceCode
tar xjvf ~/Downloads/wireshark-1.8.5.tar.bz2
(Remember your download directory may not be in ~/Downloads and the version number of WireShark you download maybe different to that used here).
Once you've downloaded the wireshark source tree, check out p25 plugin:
(cd plugins && svn checkout http://op25.osmocom.org/svn/trunk/wireshark/plugins/p25 p25)
This adds the necessary code to WireShark for it to decode APCO P25 messages. A few small changes also need to be made to the !WireShark tree outside of the plugins directory. To do this the easiest way is to apply the appropriate patch. This can be done as follows:
svn checkout http://op25.osmocom.org/svn/trunk/wireshark/patches
patch -p1 < patches/wireshark-1.8.5.patch
Of course, it is inevitable that you will download a WireShark version for which we haven't provided a patch. Don't fret - the patches will probably work for your version but if it fails to apply you may need to download one an earlier version of WireShark for which we have a patch or make the changes manually using the existing patch as a guide.
Building + Installing WireShark¶
You may need to install prerequisites beforehand. These are a minimum set for Ubuntu/Debian based systems:
sudo apt-get install bison flex libgtk2.0-dev libpcap-dev
The standard build for wireshark requires that ./autogen.sh be run first. To compile WireShark run the following commands:
./autogen.sh && ./configure && make clean && make
If it compiles cleanly then you can install it as follows:
sudo make install
Using WireShark to sniff P25¶
Now you've got a modified WireShark installed it should be a simple matter to start the receiver and use WireShark to capture its output. To do so simply sniff on your computer's network interface and use the following capture filter: "udp port 23456". At present all P25 traffic is sent to the multicast address 126.96.36.199 so it should be visible on other computers on your subnet - this allows you to sniff in one place and monitor from another.