priv_sep
priv_sep is a library for privilege separation.
It is currently designed around pledge(2) and
unveil(2) for OpenBSD-stable—that is correct, -stable not -current—but
in the future may contain functionality for Linux's
seccomp(2).
Pledge
It is very rare to use the execpromises parameter, so pledge
only relies on Promises.
Unveil
Unlike pledge(2) which allows a large quantity of duplicate promises to be provided, unveil(2) allows a maximum
of four permissions to be passed. For this reason, there are dedicated functions for each quantity of
Permissions.
Errors
Any error returned from the underlying system call is propagated via
Error. Note for both pledge(2) and unveil(2) duplicates
are ignored, so it is not an error to pass in duplicate values for their corresponding functions in this crate.
Status
This package will be actively maintained to stay in-sync with the latest version of OpenBSD-stable; as a result,
the crate is only tested on the x86_64-unknown-openbsd target. While OpenBSD supports both the most recent
-release/-stable release as well as the previous version, only the most recent version will be supported by this
library. For that reason any removal of promises in subsequent releases of pledge(2) will lead to breaking
changes in this library as the corresponding Promise variant will be removed.
Building and testing
)
)
&& &&
)
)
)
; ; ; ; ;
; ; ; ; ;