File: README.md

package info (click to toggle)
ceccomp 3.5-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,528 kB
  • sloc: ansic: 3,154; python: 653; makefile: 240; sh: 226
file content (68 lines) | stat: -rw-r--r-- 2,085 bytes parent folder | download
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 ⇒ [![AUR package](https://repology.org/badge/version-for-repo/aur/ceccomp.svg)](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