capget(2)                     System Calls Manual                    capget(2)

NUME
       capget, capset - stabile<?>te/ob<?>ine capacita<?>ile firului (firelor)

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <linux/capability.h> /* Definirea constantelor CAP_*
                                        <?>i _LINUX_CAPABILITY_* */
       #include <sys/syscall.h>      /* Definirea constantelor SYS_* */
       #include <unistd.h>

       int syscall(SYS_capget, cap_user_header_t hdrp,
                   cap_user_data_t datap);
       int syscall(SYS_capset, cap_user_header_t hdrp,
                   const cap_user_data_t datap);

       Nota: Nu exista nicio func<?>ie invaluitoare (wrapper) glibc pentru
       aceste apeluri de sistem astfel ca este necesara utilizarea a
       syscall(2).

DESCRIERE
       Aceste doua apeluri de sistem reprezinta interfa<?>a bruta a nucleului
       pentru ob<?>inerea <?>i definirea capacita<?>ilor firelor.  Nu numai ca
       aceste apeluri de sistem sunt specifice Linux-ului, dar API-ul
       nucleului este posibil sa se schimbe <?>i utilizarea acestor apeluri de
       sistem (in special formatul tipurilor cap_user_*_t) este supusa
       extinderii cu fiecare revizuire a nucleului, dar programele vechi vor
       continua sa func<?>ioneze.

       Interfe<?>ele portabile sunt cap_set_proc(3) <?>i cap_get_proc(3); daca
       este posibil, ar trebui sa utiliza<?>i aceste interfe<?>e in
       aplica<?>ii; a se vedea sec<?>iunea NOTE.

   Detalii actuale
       Acum ca a<?>i fost avertiza<?>i, cateva detalii despre nucleul curent.
       Structurile sunt definite dupa cum urmeaza.

           #define _LINUX_CAPABILITY_VERSION_1  0x19980330
           #define _LINUX_CAPABILITY_U32S_1     1

                   /* V2 adaugata in Linux 2.6.25; depreciata */
           #define _LINUX_CAPABILITY_VERSION_2  0x20071026
           #define _LINUX_CAPABILITY_U32S_2     2

                   /* V3 adaugata in Linux 2.6.26 */
           #define _LINUX_CAPABILITY_VERSION_3  0x20080522
           #define _LINUX_CAPABILITY_U32S_3     2

           typedef struct __user_cap_header_struct {
              __u32 version;
              int pid;
           } *cap_user_header_t;

           typedef struct __user_cap_data_struct {
              __u32 effective;
              __u32 permitted;
              __u32 inheritable;
           } *cap_user_data_t;

       Campurile effective, permitted <?>i inheritable sunt ma<?>ti de bi<?>i
       ale capacita<?>ilor definite in capabilities(7). Re<?>ine<?>i ca
       valorile CAP_* sunt indexuri de bi<?>i <?>i trebuie sa fie deplasate
       inainte de a fi adaugate in campurile de bi<?>i. Pentru a defini
       structurile care trebuie transmise apelului de sistem, trebuie sa
       utiliza<?>i numele struct __user_cap_header_struct <?>i struct
       __user_cap_data_struct deoarece typedefs sunt doar indicatori.

       Nucleele anterioare Linux 2.6.25 prefera capacita<?>ile pe 32 de bi<?>i
       cu versiunea _LINUX_CAPABILITY_VERSION_1.  Linux 2.6.25 a adaugat
       seturi de capacita<?>i pe 64 de bi<?>i, cu versiunea
       _LINUX_CAPABILITY_VERSION_2.  A existat, totu<?>i, o eroare API, iar
       Linux 2.6.26 a adaugat _LINUX_CAPABILITY_VERSION_3 pentru a rezolva
       problema.

       Re<?>ine<?>i ca capacita<?>ile pe 64 de bi<?>i utilizeaza datap[0] <?>i
       datap[1], in timp ce capacita<?>ile pe 32 de bi<?>i utilizeaza numai
       datap[0].

       Pe nucleele care ofera suport pentru capacita<?>ile fi<?>ierelor
       (suport pentru capacita<?>ile VFS), aceste apeluri de sistem se
       comporta u<?>or diferit. Acest suport a fost adaugat ca op<?>iune in
       Linux 2.6.24 <?>i a devenit fix (neop<?>ional) in Linux 2.6.33.

       Pentru apelurile capget(), se pot sonda capacita<?>ile oricarui proces
       prin specificarea ID-ului acestuia cu valoarea campului hdrp->pid.

       Pentru detalii privind datele, consulta<?>i capabilities(7).

   Cu suport pentru capacita<?>ile VFS
       Capacita<?>ile VFS utilizeaza un atribut extins de fi<?>ier (a se vedea
       xattr(7)) pentru a permite ata<?>area capacita<?>ilor la executabile.
       Acest model de privilegii elimina suportul nucleului pentru stabilirea
       asincrona de catre un proces a capacita<?>ilor altuia.  Adica, pe
       nucleele care accepta capacita<?>ile VFS, atunci cand se apeleaza
       capset(), singurele valori permise pentru hdrp->pid sunt 0 sau,
       echivalent, valoarea returnata de gettid(2).

   Fara suport pentru capacita<?>ile VFS
       In cazul nucleelor mai vechi care nu ofera suport pentru capacita<?>ile
       VFS, capset() poate fi utilizat, daca apelantul are capacitatea
       CAP_SETPCAP, pentru a modifica nu numai capacita<?>ile apelantului, ci
       <?>i capacita<?>ile altor fire. Apelul opereaza asupra capacita<?>ilor
       firului specificat de campul pid din hdrp atunci cand acesta este
       diferit de zero, sau asupra capacita<?>ilor firului apelant daca pid
       este 0. Daca pid se refera la un proces cu un singur fir, atunci pid
       poate fi specificat ca un ID de proces tradi<?>ional; operarea asupra
       unui fir al unui proces cu mai multe fire necesita un ID de fir de
       tipul celui returnat de gettid(2). Pentru capset(), pid poate fi de
       asemenea: -1, ceea ce inseamna efectuarea modificarii pe toate firele
       de execu<?>ie, cu excep<?>ia apelantului <?>i a lui init(1); sau o
       valoare mai mica decat -1, caz in care modificarea se aplica tuturor
       membrilor grupului de procese al carui ID este -pid.

VALOAREA RETURNATA
       In caz de succes, se returneaza zero. In caz de eroare, se returneaza
       -1, iar errno este configurata pentru a indica eroarea.

       Apelurile e<?>ueaza cu eroarea EINVAL <?>i definesc campul version din
       hdrp la valoarea preferata de nucleu _LINUX_CAPABILITY_VERSION_? atunci
       cand este specificata o valoare version neacceptata. In acest fel, se
       poate afla care este revizuirea curenta preferata a capacita<?>ii.

ERORI-IE<?>IRE
       EFAULT Adresa de memorie gre<?>ita. hdrp nu trebuie sa fie NULL.  datap
              poate fi NULL numai atunci cand utilizatorul incearca sa
              determine formatul preferat al versiunii capacita<?>ilor
              acceptate de nucleu.

       EINVAL Unul dintre argumente nu a fost valid.

       EPERM  S-a incercat adaugarea unei capacita<?>i la setul permis sau
              definirea unei capacita<?>i in setul efectiv care nu este in
              setul permis.

       EPERM  S-a incercat sa se adauge o capacitate la setul mo<?>tenit <?>i
              fie:

              o  capacitatea respectiva nu se afla in setul de limitare al
                 apelantului; fie

              o  capacitatea nu se afla in setul permis al apelantului <?>i
                 apelantul nu avea capacitatea CAP_SETPCAP in setul sau
                 efectiv.

       EPERM  Apelantul a incercat sa utilizeze capset() pentru a modifica
              capacita<?>ile unui alt fir de execu<?>ie decat el insu<?>i, dar
              nu avea suficiente privilegii.  Pentru nucleele care accepta
              capacita<?>ile VFS, acest lucru nu este permis niciodata. Pentru
              nucleele fara suport VFS, este necesara capacitatea CAP_SETPCAP.
              O eroare in nucleele anterioare Linux 2.6.11 a facut ca aceasta
              eroare sa poata aparea <?>i in cazul in care un fir fara aceasta
              capacitate incerca sa i<?>i schimbe propriile capacita<?>i
              specificand campul pid ca o valoare diferita de zero (adica
              valoarea returnata de getpid(2)) in loc de 0.

       ESRCH  Nu exista un astfel de fir.

STANDARDE
       Linux.

NOTE
       Interfa<?>a portabila pentru func<?>iile de interogare <?>i definire a
       capacita<?>ilor este oferita de biblioteca libcap <?>i este disponibila
       aici:
       <http://git.kernel.org/cgit/linux/kernel/git/morgan/libcap.git>

CONSULTA<?>I <?>I
       clone(2), gettid(2), capabilities(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.15    17 mai 2025                        capget(2)