PROCPS(3)                  Library Functions Manual                  PROCPS(3)

NUME
       procps - API (interfa<?>a de program) pentru a accesa informa<?>ii la
       nivel de sistem din sistemul de fi<?>iere ,,/proc"


REZUMAT
       Cinci interfe<?>e distincte sunt reprezentate in acest rezumat <?>i
       numite dupa fi<?>ierele pe care le acceseaza in pseudosistemul de
       fi<?>iere ,,/proc": diskstats, meminfo, slabinfo, stat <?>i vmstat.

           #include <libproc2/interfa<?>a_numita.h>

           int procps_new   (struct info **info);
           int procps_ref   (struct info  *info);
           int procps_unref (struct info **info);

           struct result *procps_get (
               struct info *info,
           [   const char *name,      ]   doar interfa<?>a programului diskstats
               enum item item);

           struct stack *procps_select (
               struct info *info,
           [   const char *name,      ]   doar interfa<?>a programului diskstats
               enum item *items,
               int numitems);

           struct reaped *procps_reap (
               struct info *info,
           [   enum reap_type what,   ]   doar interfa<?>a programului stat
               enum item *items,
               int numitems);

           struct stack **procps_sort (
               struct info *info,
               struct stack *stacks[],
               int numstacked,
               enum item sortitem,
               enum sort_order order);


           Func<?>iile <?>i structurile de mai sus sunt generice, dar
           specifica<?>ia interfa<?>a_numita ar fi, de asemenea, parte a
           oricaror identificatori.  De exemplu, ,,procps_new" ar fi de fapt
           ,,procps_meminfo_new" <?>i ,,info" ar fi cu adevarat
           ,,diskstats_info", etc.

           Acela<?>i nume de interfa<?>a_numita este folosit in fiecare nume
           de fi<?>ier antet cu un sufix `.h'.

           Legatura cu -lproc2.


DESCRIERE
   Prezentare generala
       Esen<?>ial pentru aceste interfe<?>e este o structura simpla de
       ,,rezultat" care reflecta un ,,element" plus valoarea acestuia (intr-o
       uniune cu tipuri de limbaj C standard ca membri).  Toate structurile
       ,,rezultat" sunt alocate <?>i furnizate automat de biblioteca.

       Prin specificarea unei matrice de ,,elemente", aceste structuri pot fi
       organizate ca o ,,stiva", cu poten<?>ialul de-a produce multe rezultate
       cu un singur apel catre func<?>ie.  Astfel, o ,,stiva" poate fi vazuta
       ca o inregistrare cu lungime variabila al carei con<?>inut <?>i ordine
       sunt determinate exclusiv de utilizator.

       Ca parte a fiecarei interfe<?>e exista doi enumeratori unici.
       Elementele ,,noop" <?>i ,,extra" exista pentru a pastra valorile
       utilizatorului.  Ele nu sunt niciodata definite de biblioteca, dar
       rezultatul ,,extra" va fi redus la zero cu fiecare interac<?>iune cu
       biblioteca.

       Documentul de baza in dezvoltarea unui program de utilizator va fi
       fi<?>ierul antet interfa<?>a_numita.  Acolo ve<?>i gasi elementele
       disponibile, tipul pe care acestea il returneaza (numele membrului
       structurii ,,rezultat)" <?>i sursa acestor valori.  Acolo sunt de
       asemenea documenta<?>i enumeratori <?>i structuri suplimentare.


   Utilizare
       Urmatoarele linii, ar fi o secven<?>a tipica de apeluri la aceste
       interfe<?>e.

       1. procps_new()
       2. procps_get(), procps_select() sau procps_reap()
       3. procps_unref()

       Func<?>ia get este folosita pentru a prelua o structura ,,rezultat"
       pentru un singur ,,element".  Alternativ, o macrocomanda GET este
       disponibila atunci cand doar valoarea returnata este de interes.

       Func<?>ia select poate prelua mai multe structuri ,,rezultat" intr-o
       singura ,,stiva".

       Pentru rezultate variabile imprevizibile, interfe<?>ele diskstats,
       slabinfo <?>i stat exporta o func<?>ie reap.  Este folosita pentru a
       prelua mai multe ,,stive" fiecare con<?>inand mai multe structuri
       ,,rezultat".  Op<?>ional, un utilizator poate alege sa sorteze acele
       rezultate.

       Pentru a exploata orice ,,stiva" <?>i pentru a accesa structuri
       ,,rezultat" individuale, este necesar un relative_enum, a<?>a cum se
       arata in macrocomanda VAL definita in fi<?>ierul antet.  Astfel de
       valori ar putea fi codificate ca: de la 0 la numitems-1.  Cu toate
       acestea, aceasta nevoie este de obicei satisfacuta prin crearea
       propriilor enumeratori corespunzatori ordinii matricei ,,elemente".


   Avertismente
       Func<?>iile new, ref, unref, get <?>i select sunt disponibile in toate
       cele cinci interfe<?>e.

       Pentru func<?>iile new <?>i unref, trebuie furnizata adresa unui
       indicator de structura info.  Cu new, acesta trebuie sa fi fost
       ini<?>ializat la NULL.  Cu unref va fi reini<?>ializat la NULL daca
       numarul de referin<?>e ajunge la zero.

       In cazul interfe<?>ei diskstats, un parametru name in func<?>iile get
       <?>i select identifica un nume de disc sau parti<?>ie

       Pentru interfa<?>a stat, un parametru what in func<?>ia reap identifica
       daca trebuie adunate date doar pentru CPU-uri sau atat pentru CPU-uri
       cat <?>i pentru nodurile NUMA.

       Cand se utilizeaza func<?>ia sort, parametrii staks <?>i numstacked ar
       fi in mod normal cei returna<?>i in structura ,,reaped".


VALOARE RETURNATA
   Func<?>ii care returneaza un ,,int" (numar intreg)
       O eroare va fi indicata printr-un numar negativ care este intotdeauna
       inversul unei valori binecunoscute a errno.h.

       Succesul este indicat de o valoare de returnare zero.  Cu toate
       acestea, func<?>iile ref <?>i unref returneaza numarul de referin<?>e
       curent al structurii info.


   Func<?>ii care returneaza o ,,adresa"
       O eroare va fi indicata printr-un indicator de returnare NULL cu
       motivul gasit in valoarea formala errno (numar eroare).

       Succesul este indicat de un indicator catre structura numita.


DEPANAREA
       Pentru a ajuta la dezvoltarea programului, este prevazuta o facilitate
       care poate ajuta la asigurarea faptului ca referin<?>ele la membrii
       ,,rezultate" sunt in concordan<?>a cu a<?>teptarile bibliotecii.
       Aceasta facilitate presupune ca macrocomanda furnizata in fi<?>ierul
       antet va fi utilizata pentru a accesa valoarea ,,rezultat".

       Aceasta caracteristica poate fi activata prin oricare dintre
       urmatoarele metode <?>i orice discrepan<?>e vor fi scrise la ie<?>irea
       standard de eroare.


       1) Adauga CFLAGS='-DXTRA_PROCPS_DEBUG' la orice alte op<?>iuni
          ./configure utilizate.


       2) Adauga #include <procps/xtra-procps-debug.h> la orice program dupa
          comenzile include ale interfe<?>elor numite.


       Aceasta caracteristica de verificare implica o suprasarcina
       substan<?>iala.  Prin urmare, este important ca aceasta sa nu fie
       activata pentru o versiune de produc<?>ie/lansare.


CONSULTA<?>I <?>I
       procps_misc(3), procps_pids(3), proc(5).

libproc2                          august 2022                        PROCPS(3)