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; __u64 scoped; }; 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)). scoped este o masca de bii alcatuita din fanioane de domeniu (vezi Fanioane de domeniu 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 Returneaza cea mai recenta versiune Landlock ABI acceptata (incepand de la 1). Aceasta versiune poate fi utilizata pentru o abordare de securitate de tip ,,best-effort", (cel mai bun efort) recomandata atunci cand spaiul utilizator nu este fixat pe o versiune specifica a nucleului. Daca nu se specifica altfel, toate funciile descrise in aceste pagini de manual sunt disponibile incepand cu versiunea 1. LANDLOCK_CREATE_RULESET_ERRATA Returneaza o masca de bii a problemelor rezolvate pentru versiunea curenta a ABI-ului Landlock. Daca bitul N este activat (adica errata & (1 << (N - 1))), atunci erata N a fost rezolvata in nucleul care ruleaza. Pe langa versiunile ABI, mecanismul de erate al Landlock urmarete remedierea problemelor care pot afecta compatibilitatea cu versiunile anterioare sau care necesita o abordare specifica la nivelul spaiului de utilizator. Verificai lista de eratei doar daca aplicaia dumneavoastra se bazeaza in mod specific pe un comportament care s-a modificat ca urmare a remedierii. Lista completa a eratelor Landlock este disponibila la Acest fanion este disponibil in toate versiunile Linux in care au fost remediate erorile legate de Landlock. Aceasta include in mod specific toate cele mai recente versiuni de remediere a erorilor ale nucleelor stabile care accepta Landlock. Daca LANDLOCK_CREATE_RULESET_VERSION sau LANDLOCK_CREATE_RULESET_ERRATA este activate, atunci attr trebuie sa fie NULL, iar size trebuie sa fie 0. VALOAREA RETURNATA In caz de succes, landlock_create_ruleset() returneaza un nou descriptor de fiier de set de reguli Landlock, o versiune ABI Landlock,sau o masca de bii de erata 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: E2BIG dimensiunea este prea mare. EFAULT attr nu a fost o adresa valida. EINVAL fanioane necunoscut, sau acces necunoscut, sau domeniu necunoscut, sau dimensiunea prea mica. EINVAL Valoarea attr diferita de NULL sau valoarea dimensiunea diferita de zero, in combinaie cu LANDLOCK_CREATE_RULESET_VERSION sau LANDLOCK_CREATE_RULESET_ERRATA. ENOMSG Accese goale (de exemplu, attr nu a specificat niciun drept de acces care sa fie restricionat). EOPNOTSUPP Landlock este acceptat de nucleu, dar este dezactivat la pornire. 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.18 21 aprilie 2026 landlock_create_ruleset(2)