Skip to content

Commit 291b55f

Browse files
🔖 Making release ready
1 parent 38c76af commit 291b55f

File tree

20 files changed

+43
-28
lines changed

20 files changed

+43
-28
lines changed

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
11
[workspace]
2-
members = ["feature-extraction-tool", "common", "xtask"]
2+
members = ["rustiflow", "common", "xtask"]

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,4 +38,4 @@ RUN cargo xtask ebpf-ipv6 --release
3838
RUN cargo build --release
3939

4040
# Command
41-
ENTRYPOINT ["./target/release/feature-extraction-tool"]
41+
ENTRYPOINT ["./target/release/rustiflow"]

README.md

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,41 @@ See the wiki for the different feature sets available.
2525

2626
![RustiFlow Architecture](arch.svg)
2727

28-
## Installation Guide
28+
## Using the release binary:
29+
30+
Copy the rustiflow binary that you can find in this repo in releases to a location of your choice or to the `/usr/local/bin` folder.
31+
You can then run the binary with the following commands:
32+
33+
See the [help menu](#usage-instructions) for the different options available.
34+
35+
```bash
36+
RUST_LOG=info rustiflow pcap basic-flow 60 /path/to/pcap.pcap print
37+
```
38+
39+
```bash
40+
sudo RUST_LOG=info rustiflow realtime enp5s0 cic-flow 60 csv /path/to/output.csv
41+
```
42+
43+
## Using the Container:
44+
45+
Make sure that you don't use docker desktop and that you don't have it installed on your machine. If you have this setup, it will not work as intended as the `--network host` will not link the container to the host network, but to the network of a VM that docker desktop uses.
46+
47+
- **Build the Container**:
48+
```bash
49+
docker build -t rustiflow .
50+
```
51+
- **Run the Container**:
52+
```bash
53+
docker run --network host -v /path/on/host:/app rustiflow [ARGS like you are used to]
54+
```
55+
Run it with the --privileged flag if you want to capture traffic in real-time.
56+
- **Example**:
57+
```bash
58+
docker run --network host -v /home/user/pcap:/app rustiflow pcap basic-flow 60 /app/pcap.pcap print
59+
docker run --privileged --network host -v /home/matisse/Documents:/app rustiflow realtime enp5s0 cic-flow 60 csv /app/output.csv
60+
```
61+
62+
## Installation Guide for development
2963

3064
### Prerequisites:
3165
- **libpcap-dev**:
@@ -72,25 +106,6 @@ See the wiki for the different feature sets available.
72106

73107
## Usage Instructions
74108

75-
### Using the Container:
76-
77-
Make sure that you don't use docker desktop and that you don't have it installed on your machine. If you have this setup, it will not work as intended as the `--network host` will not link the container to the host network, but to the network of a VM that docker desktop uses.
78-
79-
- **Build the Container**:
80-
```bash
81-
docker build -t rustiflow .
82-
```
83-
- **Run the Container**:
84-
```bash
85-
docker run --network host -v /path/on/host:/app rustiflow [ARGS like you are used to]
86-
```
87-
Run it with the --privileged flag if you want to capture traffic in real-time.
88-
- **Example**:
89-
```bash
90-
docker run --network host -v /home/user/pcap:/app rustiflow pcap basic-flow 60 /app/pcap.pcap print
91-
docker run --privileged --network host -v /home/matisse/Documents:/app rustiflow realtime enp5s0 cic-flow 60 csv /app/output.csv
92-
```
93-
94109
### Real-Time Traffic Capture:
95110
- **Command Help**:
96111
```bash
@@ -99,7 +114,7 @@ Make sure that you don't use docker desktop and that you don't have it installed
99114
```bash
100115
Real-time feature extraction
101116

102-
Usage: feature-extraction-tool realtime [OPTIONS] <INTERFACE> <FLOW_TYPE> <LIFESPAN> <METHOD> [EXPORT_PATH]
117+
Usage: rustiflow realtime [OPTIONS] <INTERFACE> <FLOW_TYPE> <LIFESPAN> <METHOD> [EXPORT_PATH]
103118

104119
Arguments:
105120
<INTERFACE>
@@ -150,7 +165,7 @@ Make sure that you don't use docker desktop and that you don't have it installed
150165
```bash
151166
Feature extraction from a pcap file
152167

153-
Usage: feature-extraction-tool pcap [OPTIONS] <FLOW_TYPE> <LIFESPAN> <PATH> <METHOD> [EXPORT_PATH]
168+
Usage: rustiflow pcap [OPTIONS] <FLOW_TYPE> <LIFESPAN> <PATH> <METHOD> [EXPORT_PATH]
154169

155170
Arguments:
156171
<FLOW_TYPE>
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[package]
2-
name = "nids-feature-extraction-tool"
2+
name = "rustiflow"
33
version = "0.1.0"
44
edition = "2021"
55
publish = false
@@ -27,11 +27,11 @@ bytes = "1"
2727
env_logger = "0.11"
2828
chrono = "0.4.34"
2929
dashmap = "5.5.3"
30-
pcap = "1.3.0"
30+
pcap = "2.0.0"
3131
pnet = "0.34.0"
3232
lazy_static = "1.4.0"
3333
libc = "0.2.153"
3434

3535
[[bin]]
36-
name = "feature-extraction-tool"
36+
name = "rustiflow"
3737
path = "src/main.rs"
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)