.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
.\" <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH clock_getcpuclockid 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" 
.SH NUME
clock_getcpuclockid \- obține ID\-ul ceasului de timp CPU al unui proces
.SH BIBLIOTECA
Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP), începând de la glibc 2.17
.PP
Înainte de glibc 2.17, biblioteca în timp real (\fIlibrt\fP, \fI\-lrt\fP)
.SH REZUMAT
\fB#include <time.h>\fP
.nf
.PP
\fBint clock_getcpuclockid(pid_t \fP\fIpid\fP\fB, clockid_t *\fP\fIclockid\fP\fB);\fP
.fi
.PP
.ad l
.RS -4
Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc
(consultați \fBfeature_test_macros\fP(7)):
.RE
.PP
\fBclock_getcpuclockid\fP():
.nf
    _POSIX_C_SOURCE >= 200112L
.fi
.SH DESCRIERE
Funcția \fBclock_getcpuclockid\fP() obține ID\-ul ceasului de timp CPU al
procesului al cărui ID este \fIpid\fP și îl returnează în locația indicată de
\fIclockid\fP.  Dacă \fIpid\fP este zero, atunci se returnează ID\-ul ceasului de
timp CPU al procesului care face apelul.
.SH "VALOAREA RETURNATĂ"
În caz de succes, \fBclock_getcpuclockid\fP() returnează 0; în caz de eroare,
returnează unul dintre numerele de eroare pozitive enumerate în ERORI.
.SH ERORI\-IEȘIRE
.TP 
\fBENOSYS\fP
Nucleul nu permite obținerea ceasului de timp CPU per proces al unui alt
proces, iar \fIpid\fP nu specifică procesul apelant.
.TP 
\fBEPERM\fP
Apelantul nu are permisiunea de a accesa ceasul de timp CPU al procesului
specificat de \fIpid\fP; (specificată în POSIX.1\-2001; nu apare în Linux, cu
excepția cazului în care nucleul nu permite obținerea ceasului de timp CPU
per proces al unui alt proces).
.TP 
\fBESRCH\fP
Nu există niciun proces cu ID\-ul \fIpid\fP.
.SH ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfață	Atribut	Valoare
T{
.na
.nh
\fBclock_getcpuclockid\fP()
T}	Siguranța firelor	MT\-Safe
.TE
.sp 1
.SH STANDARDE
POSIX.1\-2008.
.SH ISTORIC
glibc 2.2.  POSIX.1\-2001.
.SH NOTE
Apelarea \fBclock_gettime\fP(2) cu ID\-ul ceasului obținut printr\-un apel la
\fBclock_getcpuclockid\fP() cu un \fIpid\fP de 0, este același lucru cu utilizarea
ID\-ului ceasului \fBCLOCK_PROCESS_CPUTIME_ID\fP.
.SH EXEMPLE
Programul de exemplu de mai jos obține ID\-ul ceasului de timp CPU al
procesului al cărui ID este dat în linia de comandă și apoi utilizează
\fBclock_gettime\fP(2) pentru a obține ora de pe acel ceas.  Un exemplu de
execuție este următorul:
.PP
.in +4n
.EX
$\fB ./a.out 1\fP                 # Afișează ceasul CPU al procesului init
CPU\-time clock for PID 1 is 2.213466748 seconds
.EE
.in
.SS "Sursa programului"
.\" SRC BEGIN (clock_getcpuclockid.c)
\&
.EX
#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>\en", 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\en",
           argv[1], (intmax_t) ts.tv_sec, ts.tv_nsec);
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "CONSULTAȚI ȘI"
\fBclock_getres\fP(2), \fBtimer_create\fP(2), \fBpthread_getcpuclockid\fP(3),
\fBtime\fP(7)
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.PP
Această traducere este documentație gratuită; citiți
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licența publică generală GNU Versiunea 3
.UE
sau o versiune ulterioară cu privire la condiții privind drepturile de autor.
NU se asumă NICIO RESPONSABILITATE.
.PP
Dacă găsiți erori în traducerea acestui manual,
vă rugăm să trimiteți un e-mail la
.MT translation-team-ro@lists.sourceforge.net
.ME .