xref: /aosp_15_r20/external/libpcap/doc/README.septel (revision 8b26181f966a6af5cf6981a6f474313de533bb28)
1*8b26181fSAndroid Build Coastguard WorkerThe following instructions apply if you have a Linux platform and want
2*8b26181fSAndroid Build Coastguard Workerlibpcap to support the Septel range of passive network monitoring cards
3*8b26181fSAndroid Build Coastguard Workerfrom Intel (https://www.intel.com)
4*8b26181fSAndroid Build Coastguard Worker
5*8b26181fSAndroid Build Coastguard Worker1) Install and build the Septel software distribution by following the
6*8b26181fSAndroid Build Coastguard Workerinstructions supplied with that package.
7*8b26181fSAndroid Build Coastguard Worker
8*8b26181fSAndroid Build Coastguard Worker2) Configure libcap. To allow the 'configure' script to locate the Septel
9*8b26181fSAndroid Build Coastguard Workersoftware distribution use the '--with-septel' option:
10*8b26181fSAndroid Build Coastguard Worker
11*8b26181fSAndroid Build Coastguard Worker        ./configure --with-septel=DIR
12*8b26181fSAndroid Build Coastguard Worker
13*8b26181fSAndroid Build Coastguard Workerwhere DIR is the root of the Septel software distribution, for example
14*8b26181fSAndroid Build Coastguard Worker/var/src/septel.
15*8b26181fSAndroid Build Coastguard Worker
16*8b26181fSAndroid Build Coastguard WorkerBy default (if you write only ./configure --with-septel) it takes
17*8b26181fSAndroid Build Coastguard Worker./../septel as argument for DIR.
18*8b26181fSAndroid Build Coastguard Worker
19*8b26181fSAndroid Build Coastguard WorkerIf the Septel software is correctly detected 'configure' will
20*8b26181fSAndroid Build Coastguard Workerreport:
21*8b26181fSAndroid Build Coastguard Worker
22*8b26181fSAndroid Build Coastguard Worker        checking whether we have Septel API... yes
23*8b26181fSAndroid Build Coastguard Worker
24*8b26181fSAndroid Build Coastguard WorkerIf 'configure' reports that there is no Septel API, the directory may have been
25*8b26181fSAndroid Build Coastguard Workerincorrectly specified or the Septel software was not built before configuring
26*8b26181fSAndroid Build Coastguard Workerlibpcap.
27*8b26181fSAndroid Build Coastguard Worker
28*8b26181fSAndroid Build Coastguard WorkerSee also the libpcap INSTALL.md file for further libpcap configuration
29*8b26181fSAndroid Build Coastguard Workeroptions.
30*8b26181fSAndroid Build Coastguard Worker
31*8b26181fSAndroid Build Coastguard WorkerBuilding libpcap at this stage will include support for both the native
32*8b26181fSAndroid Build Coastguard Workerpacket capture stream and for capturing from Septel cards.  To build
33*8b26181fSAndroid Build Coastguard Workerlibpcap with only Septel support specify the capture type as 'septel'
34*8b26181fSAndroid Build Coastguard Workerwhen configuring libpcap:
35*8b26181fSAndroid Build Coastguard Worker
36*8b26181fSAndroid Build Coastguard Worker        ./configure --with-septel=DIR --with-pcap=septel
37*8b26181fSAndroid Build Coastguard Worker
38*8b26181fSAndroid Build Coastguard WorkerApplications built with libpcap configured in this way will only detect Septel
39*8b26181fSAndroid Build Coastguard Workercards and will not capture from the native OS packet stream.
40*8b26181fSAndroid Build Coastguard Worker
41*8b26181fSAndroid Build Coastguard WorkerNote: As mentioned in pcap-septel.c we should first edit the system.txt
42*8b26181fSAndroid Build Coastguard Workerfile to change the user part example (UPE) module id to 0xdd instead of
43*8b26181fSAndroid Build Coastguard Worker0x2d for technical reason.  So this change in system.txt is crucial and
44*8b26181fSAndroid Build Coastguard Workerthings will go wrong if it's not done.  System.txt along with config.txt
45*8b26181fSAndroid Build Coastguard Workerare configuration files that are edited by the user before running the
46*8b26181fSAndroid Build Coastguard Workergctload program that uses these files for initialising modules and
47*8b26181fSAndroid Build Coastguard Workerconfiguring parameters.
48*8b26181fSAndroid Build Coastguard Worker
49*8b26181fSAndroid Build Coastguard Worker----------------------------------------------------------------------
50*8b26181fSAndroid Build Coastguard Workerfor more information please contact me : [email protected]
51