PROCPS_MISC(3)             Library Functions Manual             PROCPS_MISC(3)

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

REZUMAT
       #include <libproc2/misc.h>

       Detalii platforma

           long         procps_cpu_count (void);
           long         procps_hertz_get (void);
           unsigned int procps_pid_length (void);
           int          procps_linux_version (void);

       Detalii privind timpul de execu<?>ie

           int   procps_container_uptime (double *uptime_secs);
           int   procps_loadavg (double *av1, double *av5, double *av15);
           int   procps_uptime (double *uptime_secs, double *idle_secs);
           int   procps_uptime_snprint ( char *restrict str, size_t size, double uptime_secs, const int pretty);
           char *procps_uptime_sprint (void);
           char *procps_uptime_sprint_short (void);
           int   procps_users (void);

       Detalii despre spa<?>iul de nume

           int         procps_ns_get_id (const char *name);
           const char *procps_ns_get_name (int id);
           int         procps_ns_read_pid (int pid, struct procps_ns *nsp);

       Rezolvarea numelui ma<?>tii

           int procps_sigmask_names (char *const str, size_t size , const char *sigmask);
           int procps_capmask_names (char *const str, size_t size,  const char *capmask);

       Legatura cu -lproc2.

DESCRIERE
       procps_cpu_count()  returneaza numarul de procesoare care sunt in
       prezent active ca sysconf(_SC_NPROCESSORS_ONLY) sau un presupus 1.

       procps_hertz_get() returneaza numarul de cicluri de ceas pe secunda ca
       sysconf(_SC_CLK_TCK) sau se presupunu o valoare de 100.  Impar<?>irea
       ciclurilor la aceasta valoare genereaza secunde.

       procps_pid_length()  returneaza lungimea maxima a <?>irului pentru un
       PID activ al sistemului. De exemplu, daca cea mai mare valoare posibila
       de PID activ a fost 123, atunci lungimea ar fi 3. Daca fi<?>ierul
       /proc/sys/kernel/pid_max nu poate fi citit, se presupune ca valoarea
       este 5.

       procps_linux_version()  returneaza versiunea curenta a nucleului Linux
       ca un intreg codificat. Pe sistemele non-Linux care au un sistem de
       fi<?>iere proc emulat, aceasta func<?>ie returneaza versiunea emularii
       Linux.  Versiunea consta din trei numere intregi pozitive reprezentand
       nivelurile major, minor <?>i plasture(patch). Urmatoarele macrocomenzi
       sunt furnizate pentru a codifica o anumita versiune Linux sau pentru a
       separa componentele versiunii curente.

           LINUX_VERSION( major , minor , patch )

           LINUX_VERSION_MAJOR( ver )

           LINUX_VERSION_MINOR( ver )

           LINUX_VERSION_PATCH( ver )

       procps_loadavg()  preia media de incarcare a sistemului <?>i plaseaza
       mediile de 1, 5 <?>i 15 minute in loca<?>iile specificate de orice
       indicator care nu este NULL.

       procps_uptime() returneaza timpul de func<?>ionare <?>i/sau secundele
       de inactivitate in loca<?>iile specificate de orice indicator care nu
       este NULL. Utilizarea formatului sprint returneaza un <?>ir care poate
       fi citit de om in una dintre cele doua forme.

           $ ps -o etimes 1
           ELAPSED
           12345

       Nu exista conceptul de timp inactiv intr-un container, astfel incat
       procps_container_uptime() nu are acest parametru.

       procps_uptime()  returneaza timpul de func<?>ionare <?>i/sau secundele
       de inactivitate in loca<?>iile specificate de orice indicator care nu
       este NULL.  Utilizarea formatului sprint returneaza un <?>ir care poate
       fi citit de om in una dintre cele doua forme.

           HH:MM:SS up HH:MM, # users, load average: 1, 5, 15 MM averages

           up HH, MM

       procps_uptime_snprint() Utilizeaza memoria tampon data str de lungime
       size pentru a completa <?>irul uptime in locul unei memorii tampon
       alocate static. Func<?>ia necesita valoarea uptime_secs, care poate fi
       ob<?>inuta din procps_uptime() sau procps_container_uptime(), iar
       fanionul pretty determina daca ie<?>irea este standard sau
       ,,pretty/short".

       procps_users() returneaza numarul de utilizatori din sistem. Aceasta
       valoare provine din sd_get_sessions(3) <?>i numararea sesiunilor din
       clasa user, user-early <?>i user-incomplete sau enumerarea prin
       getutent(3).

       procps_ns_get_id() returneaza id-ul intreg (enum namespace_type) al
       spa<?>iului de nume pentru spa<?>iul de nume dat nume.

       procps_ns_get_name() returneaza numele spa<?>iului de nume pentru id-ul
       dat (enum namespace_type).

       procps_ns_read_pid() returneaza nodul-i pentru spa<?>iile de nume ale
       procesului dat in structura procps_ns indicata de nsp.  Acele noduri-i
       vor aparea in ordinea prescrisa de enumerarea namespace_type.

           enum namespace_type {
               PROCPS_NS_CGROUP,
               PROCPS_NS_IPC,
               PROCPS_NS_MNT,
               PROCPS_NS_NET,
               PROCPS_NS_PID,
               PROCPS_NS_TIME,
               PROCPS_NS_USER,
               PROCPS_NS_UTS
           };

       procps_sigmask_names() Completeaza str cu un <?>ir de text lizibil de
       pana la size octe<?>i al semnalelor stabilite in masca de semnal
       hexazecimal sigmask, a se vedea signal(7).  Daca lista de semnale
       depa<?>e<?>te size octe<?>i, <?>irul va fi trunchiat <?>i se va termina
       cu un ,,+". Depinde de programul apelant sa se asigure ca str este
       alocat corect cu cel pu<?>in size octe<?>i.

       procps_capmask_names() Completeaza str cu un <?>ir de text lizibil de
       pana la size octe<?>i din capacita<?>ile stabilite in masca
       hexazecimala de capacita<?>i capmask, a se vedea capabilities(7). Daca
       lista de capacita<?>i depa<?>e<?>te size octe<?>i, <?>irul va fi
       trunchiat <?>i se va termina cu un ,,+". Depinde de programul apelant
       sa se asigure ca str este alocat corect cu cel pu<?>in size octe<?>i.

       Pentru un proces care nu are capacita<?>i sau are toate capacita<?>ile,
       <?>irul va fi ,,-" <?>i, respectiv, ,,full".


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

   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).

FI<?>IERE
       /proc/loadavg
              Valorile brute pentru media de incarcare.

       /proc/sys/kernel/osrelease
              Con<?>ine versiunea de lansare a nucleului Linux sau a
              sistemului de fi<?>iere proc.

       /proc/sys/kernel/pid_max
              Con<?>ine valoarea la care se incadreaza PID-urile, cu una mai
              mare decat valoarea PID maxima.

       /proc/uptime
              Valorile brute pentru timpul de func<?>ionare al sistemului <?>i
              timpul de inactivitate.

       /proc/PID/ns
              con<?>ine setul de spa<?>ii de nume pentru un anumit PID.

CONSULTA<?>I <?>I
       procps(3), procps_pids(3), getutent(3), sd_get_sessions(3), proc(5),
       capabilities(7), signal(7).

procps-ng                         06.07.2024                    PROCPS_MISC(3)