Skip to content

Commit 4770c2f

Browse files
committed
Merge branch 'master' of github.com:D4-project/analyzer-d4-pibs
2 parents bc3e724 + 6871de5 commit 4770c2f

File tree

1 file changed

+14
-15
lines changed

1 file changed

+14
-15
lines changed

README.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,13 @@
1-
# Passive Identification of BackScatter
1+
# Passive Identification of BackScatter (pibs)
2+
23
Read a pcap file and display potential backscatter traffic on standard output
34

45
This is very early stage and subject to change.
56

6-
77
# Install dependencies
88

9-
As there were some changes in libwiretap, at least the version 2.6.3-1 is needed.
9+
As there were some changes in libwiretap, at least the version 2.6.3-1 is required.
10+
1011
``` shell
1112
apt-get install libwiretap-dev
1213
apt-get install libhiredis-dev
@@ -16,12 +17,11 @@ apt-get install libglib2.0-dev
1617
make
1718
```
1819

19-
# How to use
20+
# How to use pibs
2021

21-
``` shell
22-
./pibs -r pcapfile.cap -b
22+
`./pibs -r pcapfile.cap -b`
2323

24-
./pibs -u e344c4fb-442e-45a6-92b9-d8e30aeef448 -z 127.0.0.1 -p 6379 -y 2
24+
`./pibs -u e344c4fb-442e-45a6-92b9-d8e30aeef448 -z 127.0.0.1 -p 6379 -y 2`
2525

2626
Consumes the files from the worker queue and write potential backscatter on
2727
standard output. The worker queue should include absolute filenames.
@@ -30,39 +30,38 @@ The redis database 2 is used as specified with the -y option.
3030
The string e344c4fb-442e-45a6-92b9-d8e30aeef448 is the uuid that must be inline with the
3131
worker.
3232

33-
pibs -r source.cap.gz -w backscatter.cap
33+
`pibs -r source.cap.gz -w backscatter.cap`
3434

3535
Read the file source.cap.gz, identify potential backscatter and store it in the
3636
file backscatter.cap to be further analysed with other tools such as wireshark
37-
```
3837

39-
pibs -r pcapfile.cap -s
38+
`pibs -r pcapfile.cap -s`
4039

4140
Read the file source.cap, identify potential backscatter and display the
4241
usage of the used internal hash table. Feature for debugging purpose.
4342

44-
pibs -r pcapfile.cap -d
43+
`pibs -r pcapfile.cap -d`
4544

4645
Dump the internal data structures for debugging purposes from the processing
4746
of the pcapfile.
4847

49-
pibs -n
48+
`pibs -n`
5049

5150
Create fresh internal data structure as shared memory for multi processing
5251
purposes. The segment id is displayed on standard output.
5352

54-
pibs -n -i myinstance.shm
53+
`pibs -n -i myinstance.shm`
5554

5655
Create a shared memory and store the segment identifier in the file
5756
myinstance.shm
5857

59-
pibs -r pcapfile.cap.gz -a -i instance.shm
58+
`pibs -r pcapfile.cap.gz -a -i instance.shm`
6059

6160
Read pcapfile.cap.gz identify potential backscatter and store it in the
6261
shared memory segment with the identifier stored in the file instance.shm.
6362
The previous states are taken into account.
6463

65-
pibs -i instance.shm -a -s
64+
`pibs -i instance.shm -a -s`
6665

6766
Display the usage of the internal hash table from the shared memory segment
6867
specified in the file instance.shm. This command can be executed in parallel

0 commit comments

Comments
 (0)