xref: /freebsd-src/contrib/libpcap/doc/README.septel (revision 6f9cba8f8b5efd16249633e52483ea351876b67b)
157e22627SCy SchubertThe following instructions apply if you have a Linux platform and want
257e22627SCy Schubertlibpcap to support the Septel range of passive network monitoring cards
3*6f9cba8fSJoseph Mingronefrom Intel (https://www.intel.com)
457e22627SCy Schubert
557e22627SCy Schubert1) Install and build the Septel software distribution by following the
657e22627SCy Schubertinstructions supplied with that package.
757e22627SCy Schubert
857e22627SCy Schubert2) Configure libcap. To allow the 'configure' script to locate the Septel
957e22627SCy Schubertsoftware distribution use the '--with-septel' option:
1057e22627SCy Schubert
1157e22627SCy Schubert        ./configure --with-septel=DIR
1257e22627SCy Schubert
1357e22627SCy Schubertwhere DIR is the root of the Septel software distribution, for example
1457e22627SCy Schubert/var/src/septel.
1557e22627SCy Schubert
1657e22627SCy SchubertBy default (if you write only ./configure --with-septel) it takes
1757e22627SCy Schubert./../septel as argument for DIR.
1857e22627SCy Schubert
1957e22627SCy SchubertIf the Septel software is correctly detected 'configure' will
2057e22627SCy Schubertreport:
2157e22627SCy Schubert
2257e22627SCy Schubert        checking whether we have Septel API... yes
2357e22627SCy Schubert
2457e22627SCy SchubertIf 'configure' reports that there is no Septel API, the directory may have been
2557e22627SCy Schubertincorrectly specified or the Septel software was not built before configuring
2657e22627SCy Schubertlibpcap.
2757e22627SCy Schubert
28*6f9cba8fSJoseph MingroneSee also the libpcap INSTALL.md file for further libpcap configuration
2957e22627SCy Schubertoptions.
3057e22627SCy Schubert
3157e22627SCy SchubertBuilding libpcap at this stage will include support for both the native
3257e22627SCy Schubertpacket capture stream and for capturing from Septel cards.  To build
3357e22627SCy Schubertlibpcap with only Septel support specify the capture type as 'septel'
3457e22627SCy Schubertwhen configuring libpcap:
3557e22627SCy Schubert
3657e22627SCy Schubert        ./configure --with-septel=DIR --with-pcap=septel
3757e22627SCy Schubert
3857e22627SCy SchubertApplications built with libpcap configured in this way will only detect Septel
3957e22627SCy Schubertcards and will not capture from the native OS packet stream.
4057e22627SCy Schubert
4157e22627SCy SchubertNote: As mentioned in pcap-septel.c we should first edit the system.txt
4257e22627SCy Schubertfile to change the user part example (UPE) module id to 0xdd instead of
4357e22627SCy Schubert0x2d for technical reason.  So this change in system.txt is crucial and
4457e22627SCy Schubertthings will go wrong if it's not done.  System.txt along with config.txt
4557e22627SCy Schubertare configuration files that are edited by the user before running the
4657e22627SCy Schubertgctload program that uses these files for initialising modules and
4757e22627SCy Schubertconfiguring parameters.
4857e22627SCy Schubert
4957e22627SCy Schubert----------------------------------------------------------------------
5057e22627SCy Schubertfor more information please contact me : gil_hoyek@hotmail.com
51