Filaments are bootstrapped via the fibratus run
command by specifying the filament name. Use the -f
or --filament.name
flags to indicate the filament you'd like to run.
$ fibratus run -f watch_files
The filament will keep running until the keyboard interrupt signal is received.
Filaments may require additional arguments to execute some conditional logic or set up a filter. Arguments are passed to a filament by specifying a list of comma-separated values after filament name:
$ fibratus run -f "watch_files,powershell.exe"
This populates the sys.argv list with the provided arguments, where sys.argv[0]
is the filament name.
By default, filaments reside within the %PROGRAMFILES%\Fibratus\Filaments
directory. It is possible to override this location by specifying an alternative directory via the --filament.path
flag or by editing the config file.
To list available filaments, run the below command.
$ fibratus list filaments
Engaging filters in filaments can be accomplished in two ways:
- the command line argument when running the filament
- the
kfilter
function during filament initialization
If the filter expression is supplied in both the CLI argument and the kfilter
function, the one set in the latter takes precedence.