clock_getcpuclockid(3)     Library Functions Manual     clock_getcpuclockid(3)

NUME
       clock_getcpuclockid - ob<?>ine ID-ul ceasului de timp CPU al unui
       proces

BIBLIOTECA
       Biblioteca C standard (libc, -lc), incepand de la glibc 2.17

       Inainte de glibc 2.17, biblioteca in timp real (librt, -lrt)

REZUMAT
       #include <time.h>

       int clock_getcpuclockid(pid_t pid, clockid_t *clockid);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       clock_getcpuclockid():
           _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Func<?>ia clock_getcpuclockid() ob<?>ine ID-ul ceasului de timp CPU al
       procesului al carui ID este pid <?>i il returneaza in loca<?>ia
       indicata de clockid.  Daca pid este zero, atunci se returneaza ID-ul
       ceasului de timp CPU al procesului care face apelul.

VALOAREA RETURNATA
       In caz de succes, clock_getcpuclockid() returneaza 0; in caz de eroare,
       returneaza unul dintre numerele de eroare pozitive enumerate in ERORI.

ERORI-IE<?>IRE
       ENOSYS Nucleul nu permite ob<?>inerea ceasului de timp CPU per proces
              al unui alt proces, iar pid nu specifica procesul apelant.

       EPERM  Apelantul nu are permisiunea de a accesa ceasul de timp CPU al
              procesului specificat de pid; (specificata in POSIX.1-2001; nu
              apare in Linux, cu excep<?>ia cazului in care nucleul nu permite
              ob<?>inerea ceasului de timp CPU per proces al unui alt proces).

       ESRCH  Nu exista niciun proces cu ID-ul pid.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |clock_getcpuclockid()                 | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.2.  POSIX.1-2001.

NOTE
       Apelarea clock_gettime(2) cu ID-ul ceasului ob<?>inut printr-un apel la
       clock_getcpuclockid() cu un pid de 0, este acela<?>i lucru cu
       utilizarea ID-ului ceasului CLOCK_PROCESS_CPUTIME_ID.

EXEMPLE
       Programul de exemplu de mai jos ob<?>ine ID-ul ceasului de timp CPU al
       procesului al carui ID este dat in linia de comanda <?>i apoi
       utilizeaza clock_gettime(2) pentru a ob<?>ine ora de pe acel ceas.  Un
       exemplu de execu<?>ie este urmatorul:

           $ ./a.out 1                 # Afi<?>eaza ceasul CPU al procesului init
           CPU-time clock for PID 1 is 2.213466748 seconds

   Sursa programului
       #define _XOPEN_SOURCE 600
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <time.h>
       #include <unistd.h>

       int
       main(int argc, char *argv[])
       {
           clockid_t clockid;
           struct timespec ts;

           if (argc != 2) {
               fprintf(stderr, "%s <process-ID>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           if (clock_getcpuclockid(atoi(argv[1]), &clockid) != 0) {
               perror("clock_getcpuclockid");
               exit(EXIT_FAILURE);
           }

           if (clock_gettime(clockid, &ts) == -1) {
               perror("clock_gettime");
               exit(EXIT_FAILURE);
           }

           printf("Ceasul de timp CPU pentru PID %s este de %jd.%09ld secunde\n",
                  argv[1], (intmax_t) ts.tv_sec, ts.tv_nsec);
           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       clock_getres(2), timer_create(2), pthread_getcpuclockid(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        clock_getcpuclockid(3)