wt/finit
1
0 Fork 0
mirror of https://github.com/troglobit/finit.git synced 2026-11-14 19:03:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #522 from firasuke/master

Browse Source 
doc: list libcap as a dependency
This commit is contained in:
Joachim Wiberg authored and GitHub committed 2026-11-14 12:14:04 +01:00
2 parents f15e95d1cc e280569941
commit 8451c4087a
2 files changed
+13 -2
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

doc/build.md
+10
View File
@@ -15,6 +15,10 @@ and `/dev/disk/by-label/` symlinks after. keventd is enabled by
default, so this is a hard requirement unless you build with default, so this is a hard requirement unless you build with
`--without-keventd`. `--without-keventd`.
Linux capabilities support for services is also built by default. It needs
[libcap][] (-lcap); the build falls back to no capabilities support when that
library is missing, or with `--disable-libcap`.
PAM session support for services is built by default. It needs PAM session support for services is built by default. It needs
[Linux-PAM][] (-lpam); the build falls back to no PAM support when that [Linux-PAM][] (-lpam); the build falls back to no PAM support when that
library is missing. A static build, `--enable-static`, disables PAM library is missing. A static build, `--enable-static`, disables PAM
@@ -37,6 +41,7 @@ version of the above mentioned libraries. Currently required versions:
- libuEv v2.2.0, or later - libuEv v2.2.0, or later
- libConfuse v3.3, or later - libConfuse v3.3, or later
- libblkid, any version, when keventd is enabled - libblkid, any version, when keventd is enabled
- libcap, any version, unless `--disable-libcap` is given
Configure Configure
@@ -59,6 +64,10 @@ Below are a few of the main switches to configure:
built-ins (.o files) and all external libraries, except the C library built-ins (.o files) and all external libraries, except the C library
will be linked statically. will be linked statically.
* `--disable-libcap`: Opt out of Finit's built-in Linux capabilities support,
enabled by default. Needs libcap, and falls back to disabled when it is
missing. See [Linux Capabilities](config/capabilities.md)
* `--disable-pam`: Opt out of Finit's built-in PAM session support, * `--disable-pam`: Opt out of Finit's built-in PAM session support,
enabled by default, which lets a service declare `pam = "name"` and enabled by default, which lets a service declare `pam = "name"` and
run inside a session set up from `/etc/pam.d/name`. Needs libpam, run inside a session set up from `/etc/pam.d/name`. Needs libpam,
@@ -298,4 +307,5 @@ it only for debugging start up issues when Finit crashes.
[libite]: https://github.com/troglobit/libite [libite]: https://github.com/troglobit/libite
[libConfuse]: https://github.com/libconfuse/libconfuse [libConfuse]: https://github.com/libconfuse/libconfuse
[util-linux]: https://github.com/util-linux/util-linux [util-linux]: https://github.com/util-linux/util-linux
[libcap]: https://sites.google.com/site/fullycapable/
[Linux-PAM]: https://github.com/linux-pam/linux-pam [Linux-PAM]: https://github.com/linux-pam/linux-pam
doc/config/capabilities.md
+3 -2
View File
@@ -169,8 +169,9 @@ ps -o user,pid,cmd -p $(pidof nginx)
- Linux kernel 4.3+ (for ambient capabilities support) - Linux kernel 4.3+ (for ambient capabilities support)
- libcap library installed - libcap library installed
- Finit built with `--enable-libcap`, otherwise a `capabilities` list is - Finit built with libcap support (enabled by default unless `--disable-libcap`
ignored, with a warning is given or libcap was missing at build time), otherwise a `capabilities` list
is ignored, with a warning
## Limitations ## Limitations