Skip to content

CaT Scripts

Tânia Esteves edited this page Oct 21, 2021 · 3 revisions

CaT Installation Script

The script "install_cat.sh" allows the installation of the different components of CaT's pipeline.

To install all CaT's components

  • CaTracers, Falcon-Solver, CaSolvers, Falcon-Visualizer:
./install_cat.sh install_cat

To install CaTracers:

  • To install only CatBpf:
./install_cat.sh install_catbpf
  • To install only CatStace:
./install_cat.sh install_catstrace
  • To install the two CaTracers:
./install_cat.sh install_catracers

To install the remaining pipeline:

  • To install all analysis components (Falcon-Solver, both CaTracers, Falcon-Visualizer) :
./install_cat.sh install_cat_pipeline
  • To install Falcon-Solver:
./install_cat.sh install_falcon_solver
  • To install only CaSolver-Go:
./install_cat.sh install_casolver_go
  • To install only CaSolver-Py:
./install_cat.sh install_casolver_py
  • To install only the two CaSolvers:
./install_cat.sh install_casolvers
  • To install only Falcon-Visualizer:
./install_cat.sh install_falcon_visualizer

Note: Do not forget to run the command source ~/.bashrc.

CaT Pipeline Execution Script

The script "run_cat_pipeline.sh" allows for running the CaT's analysis pipeline for a given input file.

How to run:

./run_cat_pipeline.sh [options] [arguments]
Options:
  • use flag -h to show brief help"
  • use flag -t to indicate the CaTracer used to capture the events (catbpf or catstrace)
  • use flag -f to indicate the file to be analyzed (it can be passed multiple times)
  • use flag -g to group events by host (default: group events by thread).
Example:
./run_cat_pipeline.sh -t catbpf -f CATLog-client.json -f CATLog-server.json -g

Clone this wiki locally