landlock_create_ruleset(2) System Calls Manual landlock_create_ruleset(2) NUME landlock_create_ruleset - creeaza un nou set de reguli Landlock BIBLIOTECA Biblioteca C standard (libc, -lc) SINOPSIS #include /* Definirea constantelor LANDLOCK_* */ #include /* Definirea constantelor SYS_* */ #include int syscall(SYS_landlock_create_ruleset, const struct landlock_ruleset_attr *attr, size_t dimensiunea , uint32_t fanioane); DESCRIERE Un set de reguli Landlock identifica un set de reguli (adica aciuni asupra obiectelor). Acest apel de sistem landlock_create_ruleset() creeaza un nou descriptor de fiier care identifica un set de reguli. Acest descriptor de fiier poate fi utilizat apoi de landlock_add_rule(2) i landlock_restrict_self(2). A se vedea landlock(7) pentru o prezentare generala. attr specifica proprietaile noului set de reguli. Acesta indica urmatoarea structura: struct landlock_ruleset_attr { __u64 handled_access_fs; __u64 handled_access_net; }; handled_access_fs este o masca de bii a aciunilor sistemului de fiiere gestionate (a se vedea Aciuni ale sistemului de fiiere in landlock(7)). handled_access_net este o masca de bii a aciunilor de reea gestionate (a se vedea Aciuni de reea in landlock(7)). Aceasta structura definete un set de drepturi de acces gestionate, un set de aciuni asupra diferitelor tipuri de obiecte, care ar trebui sa fie refuzate implicit atunci cand setul de reguli este pus in aplicare. Viceversa, drepturile de acces care nu sunt enumerate in mod specific aici nu vor fi refuzate de acest set de norme atunci cand este pus in aplicare. Din motive istorice, dreptul LANDLOCK_ACCESS_FS_REFER este intotdeauna refuzat implicit, chiar i atunci cand bitul sau nu este activat in handled_access_fs. Pentru a adauga reguli noi cu acest drept de acces, bitul trebuie totui activat explicit (a se vedea Aciuni ale sistemului de fiiere in landlock(7)). Listarea explicita a drepturilor de acces handled este necesara din motive de compatibilitate retroactiva. In majoritatea cazurilor de utilizare, procesele care utilizeaza Landlock vor avea o gama larga handle sau toate drepturile de acces despre care tiu la momentul construirii (i pe care le-au testat cu un nucleu care le accepta pe toate). Aceasta structura poate crete in viitoarele versiuni Landlock. dimensiunea trebuie sa fie specificata ca sizeof(struct landlock_ruleset_attr) din motive de compatibilitate. flanione trebuie sa fie 0 daca se utilizeaza attr. In caz contrar, fanioane poate fi stabilit la: LANDLOCK_CREATE_RULESET_VERSION Daca attr este NULL i dimensiunea este 0, atunci valoarea returnata este cea mai mare versiune ABI Landlock acceptata (incepand de la 1). Aceasta versiune poate fi utilizata pentru o abordare de securitate ,,best-effort" (cel mai bun efort), care este incurajata atunci cand spaiul utilizatorului nu este fixat pe o anumita versiune de nucleu. Toate caracteristicile documentate in aceste pagini de manual sunt disponibile cu versiunea 1. VALOAREA RETURNATA In caz de succes, landlock_create_ruleset() returneaza un nou descriptor de fiier de set de reguli Landlock sau o versiune ABI Landlock, in conformitate cu fanioane. In caz de eroare, se returneaza -1, iar errno este configurata pentru a indica eroarea. ERORI-IEIRE landlock_create_ruleset() poate eua din urmatoarele motive: EOPNOTSUPP Landlock este acceptat de nucleu, dar este dezactivat la pornire. EINVAL fanioane necunoscut, sau acces necunoscut, sau dimensiunea prea mica. E2BIG dimensiunea este prea mare. EFAULT attr nu a fost o adresa valida. ENOMSG Accese goale (de exemplu, attr nu a specificat niciun drept de acces care sa fie restricionat). STANDARDE Linux. ISTORIC Linux 5.13. EXEMPLE A se vedea landlock(7). CONSULTAI I landlock_add_rule(2), landlock_restrict_self(2), landlock(7) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . Pagini de manual de Linux 6.12 26 noiembrie 2024 landlock_create_ruleset(2)