VERIEXEC(5)

πŸ“¦ version 11.0, in nixpkgs unstable

okay so you're reading the veriexec(5) manual page β€” File Formats Manual energy, and it's literally all about the format for the Veriexec signatures file πŸŽ€

✨ NAME ✨

veriexec β€” format for the Veriexec signatures file πŸ’…

🌸 DESCRIPTION 🌸

Veriexec loads entries to the in-kernel database from a file describing files to be monitored and the type of monitoring. This file is often referred to as the β€œsignatures database” or β€œsignatures file” ✨

The signatures file can be easily created using veriexecgen(8) 🫢

πŸ¦‹ SIGNATURES DATABASE FORMAT πŸ¦‹

The signatures database has a line based structure, where each line has several fields separated by white-space (space, tabs, etc.) taking the following form:

path type fingerprint    flags

The description for each field is as follows:

  • path β€” The full path to the file. White-space characters can be escaped if prefixed with a \ πŸ’–
  • type β€” Type of fingerprinting algorithm used for the file.

Requires kernel support for the specified algorithm. List of fingerprinting algorithms supported by the kernel can be obtained by using the following command:

# sysctl kern.veriexec.algorithms
  • fingerprint β€” The fingerprint for the file. Can (usually) be generated using the following command:
% cksum -a <algorithm> <file>
  • flags β€” Optional listing of entry flags, separated by a comma. These may include:
    • direct β€” Allow direct execution only.

Execution of a program is said to be β€œdirect” when the program is invoked by the user (either in a script, manually typing it, etc.) via the execve(2) syscall. πŸ”₯

  • indirect β€” Allow indirect execution only.

Execution of a program is said to be β€œindirect” if it is invoked by the kernel to interpret a script (β€œhash-bang”). 🌈

  • file β€” Allow opening the file only, via the open(2) syscall (no execution is allowed). πŸŽ€
  • untrusted β€” Indicate that the file is located on untrusted storage and its fingerprint evaluation status should not be cached, but rather re-calculated each time it is accessed.

Fingerprints for untrusted files will always be evaluated on load. πŸ‘‘

To improve readability of the signatures file, the following aliases are provided:

  • program β€” An alias for β€œdirect”.
  • interpreter β€” An alias for β€œindirect”
  • script β€” An alias for both β€œdirect” and β€œfile”.
  • library β€” An alias for both β€œfile” and β€œindirect”.

If no flags are specified, β€œdirect” is assumed. πŸ’–

Comments begin with a # character and span to the end of the line.

πŸ’œ SEE ALSO πŸ’œ

veriexec(4), security(7), veriexec(8), veriexecctl(8), veriexecgen(8)

🌟 HISTORY 🌟

veriexec first appeared in NetBSD 2.0.

πŸ‘‘ AUTHORS πŸ‘‘

  • Brett Lymn <blymn@NetBSD.org>
  • Elad Efrat <elad@NetBSD.org>

sign-off time: this veriexec(5) page is from Debian, dated March 18, 2011 β€” periodt πŸ’…βœ¨

πŸ“¦ where this page comes from
  • nixpkgs unstable: netbsd-source 11.0
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms