xref: /netbsd-src/external/bsd/libpcap/dist/doc/README.septel (revision 748408ed59e7aef1b0dd2f652356b3c051bb3440)
19185e895SchristosThe following instructions apply if you have a Linux platform and want
29185e895Schristoslibpcap to support the Septel range of passive network monitoring cards
3*748408edSchristosfrom Intel (https://www.intel.com)
49185e895Schristos
59185e895Schristos1) Install and build the Septel software distribution by following the
69185e895Schristosinstructions supplied with that package.
79185e895Schristos
89185e895Schristos2) Configure libcap. To allow the 'configure' script to locate the Septel
99185e895Schristossoftware distribution use the '--with-septel' option:
109185e895Schristos
119185e895Schristos        ./configure --with-septel=DIR
129185e895Schristos
139185e895Schristoswhere DIR is the root of the Septel software distribution, for example
149185e895Schristos/var/src/septel.
159185e895Schristos
169185e895SchristosBy default (if you write only ./configure --with-septel) it takes
179185e895Schristos./../septel as argument for DIR.
189185e895Schristos
199185e895SchristosIf the Septel software is correctly detected 'configure' will
209185e895Schristosreport:
219185e895Schristos
229185e895Schristos        checking whether we have Septel API... yes
239185e895Schristos
249185e895SchristosIf 'configure' reports that there is no Septel API, the directory may have been
259185e895Schristosincorrectly specified or the Septel software was not built before configuring
269185e895Schristoslibpcap.
279185e895Schristos
28*748408edSchristosSee also the libpcap INSTALL.md file for further libpcap configuration
299185e895Schristosoptions.
309185e895Schristos
319185e895SchristosBuilding libpcap at this stage will include support for both the native
329185e895Schristospacket capture stream and for capturing from Septel cards.  To build
339185e895Schristoslibpcap with only Septel support specify the capture type as 'septel'
349185e895Schristoswhen configuring libpcap:
359185e895Schristos
369185e895Schristos        ./configure --with-septel=DIR --with-pcap=septel
379185e895Schristos
389185e895SchristosApplications built with libpcap configured in this way will only detect Septel
399185e895Schristoscards and will not capture from the native OS packet stream.
409185e895Schristos
419185e895SchristosNote: As mentioned in pcap-septel.c we should first edit the system.txt
429185e895Schristosfile to change the user part example (UPE) module id to 0xdd instead of
439185e895Schristos0x2d for technical reason.  So this change in system.txt is crucial and
449185e895Schristosthings will go wrong if it's not done.  System.txt along with config.txt
459185e895Schristosare configuration files that are edited by the user before running the
469185e895Schristosgctload program that uses these files for initialising modules and
479185e895Schristosconfiguring parameters.
489185e895Schristos
499185e895Schristos----------------------------------------------------------------------
509185e895Schristosfor more information please contact me : gil_hoyek@hotmail.com
51