times(2)                      System Calls Manual                     times(2)

NUME
       times - ob<?>ine timpii procesului

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <sys/times.h>

       clock_t times(struct tms *buf);

DESCRIERE
       times() stocheaza timpii procesului curent in struct tms la care indica
       buf. structl tms este definita in <sys/times.h>:

           struct tms {
               clock_t tms_utime;  /* timpul utilizatorului */
               clock_t tms_stime;  /* timpul sistemului */
               clock_t tms_cutime; /* timpul de utilizator al proceselor-copil */
               clock_t tms_cstime; /* timpul de sistem al proceselor-copil */
           };

       Campul tms_utime con<?>ine timpul petrecut de CPU in executarea
       instruc<?>iunilor procesului de apelare. Campul tms_stime con<?>ine
       timpul petrecut de CPU in timpul execu<?>iei in interiorul nucleului in
       timp ce efectueaza sarcini in numele procesului apelant.

       Campul tms_cutime con<?>ine suma valorilor tms_utime <?>i tms_cutime
       pentru toate procesele/firele-copil a<?>teptate sa se termine.  Campul
       tms_cstime con<?>ine suma valorilor tms_stime <?>i tms_cstime toate
       procesele/firele-copil a<?>teptate sa se termine.

       Timpii pentru copiii termina<?>i (<?>i pentru descenden<?>ii lor) sunt
       adauga<?>i in momentul in care wait(2) sau waitpid(2) returneaza ID-ul
       lor de proces. In special, timpii nepo<?>ilor pe care copiii nu i-au
       a<?>teptat nu sunt vazu<?>i niciodata.

       Toate duratele de timp raportate sunt exprimate in ,,tic-tacuri" de
       ceas.

VALOAREA RETURNATA
       times() returneaza numarul de ticuri de ceas care s-au scurs de la un
       punct arbitrar din trecut. Valoarea returnata poate depa<?>i intervalul
       posibil al tipului clock_t. In caz de eroare, se returneaza
       (clock_t) -1, iar errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EFAULT tms indica in afara spa<?>iului de adrese al procesului.

VERSIUNI
       In Linux, argumentul buf poate fi specificat ca fiind NULL, ceea ce
       inseamna ca times() returneaza doar un rezultat de func<?>ie. Cu toate
       acestea, POSIX nu specifica acest comportament, iar majoritatea
       celorlalte implementari UNIX necesita o valoare non-NULL pentru buf.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr4, 4.3BSD.

       In POSIX.1-1996, simbolul CLK_TCK (definit in <time.h>) este
       men<?>ionat ca fiind invechit. Acesta este invechit in prezent.

       Inainte de Linux 2.6.9, daca dispozi<?>ia lui SIGCHLD este stabilita la
       SIG_IGN, atunci timpii copiilor termina<?>i sunt automat inclu<?>i in
       campurile tms_cstime <?>i tms_cutime, de<?>i POSIX.1-2001 spune ca
       acest lucru ar trebui sa se intample numai daca procesul apelant
       efectueaza wait(2)s pe copiii sai. Aceasta neconformitate este
       rectificata in Linux 2.6.9 <?>i versiunile ulterioare.

       In Linux, punctul ,,arbitrar din trecut" de la care se masoara valoarea
       de intoarcere a times() a variat intre versiunile nucleului. In Linux
       2.4 <?>i versiunile anterioare, acest punct este momentul in care
       sistemul a fost ini<?>iat. a Incepand cu Linux 2.6, acest punct este
       (2^32/HZ) - 300 secunde inainte de momentul de pornire a sistemului.
       Aceasta variabilitate intre versiunile nucleului (<?>i intre
       implementarile UNIX), combinata cu faptul ca valoarea returnata poate
       depa<?>i intervalul clock_t, inseamna ca o aplica<?>ie portabila ar fi
       in<?>elept sa evite utilizarea acestei valori. Pentru a masura
       modificarile in timpul scurs, utiliza<?>i in schimb clock_gettime(2).

       SVr1-3 returneaza long, iar membrii structurii sunt de tip time_t,
       de<?>i stocheaza ticuri de ceas, nu secunde de la Epoca. V7 a folosit
       long pentru membrii structurilor, deoarece nu avea inca tipul time_t.

NOTE
       Numarul de ticuri de ceas pe secunda poate fi ob<?>inut folosind:

           sysconf(_SC_CLK_TCK);

       Re<?>ine<?>i ca clock(3) returneaza, de asemenea, o valoare de tip
       clock_t, dar aceasta valoare este masurata in unita<?>i de
       CLOCKS_PER_SEC, nu in ticuri de ceas utilizate de times().

ERORI
       O limitare a conven<?>iilor de apelare a sistemului Linux pe anumite
       arhitecturi (in special i386) inseamna ca pe Linux 2.6 exista o mica
       fereastra de timp (41 de secunde) imediat dupa pornire, cand times()
       poate returna -1, indicand in mod fals ca a avut loc o eroare.
       Aceea<?>i problema poate aparea atunci cand valoarea de returnare
       depa<?>e<?>te valoarea maxima care poate fi stocata in clock_t.

CONSULTA<?>I <?>I
       time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(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.06 31 octombrie 2023                      times(2)