aegis-dos-protection/doc/usage.md

51 lines
1.9 KiB
Markdown

# Configuration
### config.json
The following configuration points are to be set in the config.json file in the root
directory of this project.
* `number_of_worker_threads` : Number of threads that should run through the aegis-pipeline in parallel.
* type: string
* Default: the maximum number of threads (aka dpdk-lcores) possible is chosen.
* if you want the default value to be set simply remove this key-value pair from the config.json file.
* Minimum: 1.
* Maximum: Number of available dpdk-lcores (most likely available Threads) on the system minus 1.
### Command Line Options
The following command line arguments are supported:
* `--config -c` => Location to config file. Default => **/etc/aegis/aegis.conf**.
* `--dpdk_version` => print version of dpdk version installed
* `--help -h` => Print help menu for command line options.
* `--ifname` => list all interfaces with name
* `--keep_files` => should generated files be kept after exit
* `--list -l` => List all filtering rules/settings scanned from config file.
* `--meson_bin` => print location of the meson binary
* `--log_level` => set logging level
* `--test_list` => test rules list for errors
Commandline instructions will overwrite the configration file settings!
#### Example
```bash
aegis --keep-files --log_level 3
aegis --ifname
aegis --list
```
### Usage
How to use AEGIS:
#### Compile your own AEGIS
To compile your AEGIS you need to have all requirements installed; refer to [Getting Started](/getting_started.md).
1. Run `meson build` in your root folder of AEGIS. Meson will collect all necesarry files for you.
2. `cd build` into your build folder
3. Run `ninja` to compile all source code to your system specifiy binaries
#### Simple usage
Call `aegis` to run the AEGIS CLI and start your service. The CLI will guide you trough all possibilities.