Struct LandlockRuleset 

pub struct LandlockRuleset(/* private fields */);

Ruleset Landlock (cf. landlock_create_ruleset(2)).

Encapsule un FD ruleset Landlock qui accumule des règles d’accès filesystem avant d’être appliqué au thread courant via LandlockRuleset::restrict_self.

Les restrictions sont irréversibles : une fois restrict_self appelé, le thread ne peut plus voir les permissions augmenter (Landlock est monotone).

Implementations

impl LandlockRuleset

pub fn as_fd(&self) -> BorrowedFd<'_>

Vue empruntée du FD ruleset.

pub fn add_rule_path_beneath( &mut self, path: BorrowedFd<'_>, allowed_access: LandlockAccessFs, ) -> Result<(), Errno>

Ajoute une règle d’accès pour un chemin filesystem et ses descendants.

Wrappeur de landlock_add_rule(2) avec LANDLOCK_RULE_PATH_BENEATH. La règle s’applique au chemin référencé par path et à tous ses descendants. path doit être ouvert avec O_PATH | O_DIRECTORY (ou O_PATH seul pour un fichier).

Sémantique additive : les règles ne peuvent qu’étendre les accès autorisés au sein de ce ruleset. restrict_self appliquera l’intersection de tous les rulesets cumulés.

Parameters

• path : FD du chemin cible (typiquement ouvert avec O_PATH).
• allowed_access : permissions autorisées sur ce chemin et ses descendants.

Errors

• EINVAL : allowed_access contient un bit non géré par ce ruleset, ou path n’est pas un FD valide.
• ENOMEM : mémoire kernel insuffisante.
• EBADFD : path n’est pas un FD de fichier ou répertoire.
• EINTR : interruption par signal (ADR-021 convention 2 — remonté tel quel, sans retry automatique).

Examples

use air_sys_syscall::security::landlock_create_ruleset;
use air_sys_types::security::LandlockAccessFs;
use air_sys_types::fd::BorrowedFd;

let mut ruleset = landlock_create_ruleset(
    LandlockAccessFs::READ_FILE | LandlockAccessFs::EXECUTE,
).expect("create_ruleset");
ruleset.add_rule_path_beneath(path_fd, LandlockAccessFs::READ_FILE)
    .expect("add_rule");

pub fn restrict_self(&self) -> Result<(), Errno>

Applique le ruleset au thread courant.

Wrappeur de landlock_restrict_self(2). Irréversible. Après cet appel, le thread ne peut plus accéder aux chemins filesystem non couverts par les règles du ruleset (pour les accès dans handled_access du ruleset).

Prérequis : avoir appelé crate::process::set_no_new_privs ou posséder CAP_SYS_ADMIN.

Errors

• EPERM : no_new_privs non positionné et CAP_SYS_ADMIN absent.
• EINVAL : flags invalides.
• EINTR : interruption par signal (ADR-021 convention 2 — remonté tel quel, sans retry automatique).

Examples

use air_sys_syscall::security::landlock_create_ruleset;
use air_sys_syscall::process::set_no_new_privs;
use air_sys_types::security::LandlockAccessFs;

let ruleset = landlock_create_ruleset(LandlockAccessFs::READ_FILE)
    .expect("create_ruleset");
set_no_new_privs().expect("no_new_privs");
ruleset.restrict_self().expect("restrict_self");

Trait Implementations

impl Debug for LandlockRuleset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.