1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
|
# Ceccomp
A tool to analyze seccomp filters like `seccomp-tools`, written in C
# Doc
[English Version](docs/ceccomp.adoc) | [中文文档](docs/ceccomp-cn.adoc)
# Install
- Arch Linux users:
Install via AUR, build `ceccomp` package ⇒ [](https://repology.org/project/ceccomp/versions)
Or install via `archlinuxcn` repo if you have it set in you `pacman.conf`.
- Stable installation:
Clone the whole repo, then run `./configure`. Add `--without-doc` flag if you don't have `asciidoctor`,
and add `--without-i18n` flag if you don't have `gettext` package.
```sh
git clone https://github.com/dbgbgtf1/Ceccomp.git
cd Ceccomp
./configure
./configure # run this again if Makefile is not generated
make
make install # install at /usr/bin
```
- Testing installation:
Clone the whole repo, and then run `./configure --devmode`.
```sh
git clone https://github.com/dbgbgtf1/Ceccomp.git
cd Ceccomp
./configure --devmode
make
```
# Run Test
Run configure and make, then invoke `scripts/check.sh` from repo root. We expect the script could pass all checks.
If you find some checks failed, please submit an issue to report your case.
`check.sh` stops if any error occurs by default, you can override this behavior by adding a `--tolerant` flag,
which allows `check.sh` to run through the whole test.
To run the test, you need 3 extra packages: `pkgconf` (required by `pkg-config`), `diffutils` (required by `diff`)
and `procps` (required by `pgrep` and `pkill`).
# CheatSheet
<img width="1185" height="649" alt="image" src="https://github.com/user-attachments/assets/7868a8ed-e6a9-42fa-a2f1-5955be358013" />
# I need You
Any Issue or Pr are welcome!
# Credits
- [seccomp-tools](https://github.com/david942j/seccomp-tools): The tool in Ruby inspires us to write ceccomp
- [Bootswatch](https://bootswatch.com/slate/): Provides awesome css for html doc under MIT
# License
Copyright (C) 2025-present, ceccomp contributors, distributed under GNU General Public License v3.0 or Later
|