.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH clock_getcpuclockid 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
clock_getcpuclockid \- الحصول على معرف ساعة وقت وحدة المعالجة المركزية لعملية
.SH المكتبة
مكتبة C القياسية (\fIlibc\fP,\ \fI\-lc\fP)، منذ glibc 2.17
.P
قبل glibc 2.17، مكتبة الوقت الحقيقي (\fIlibrt\fP،\ \fI\-lrt\fP)
.SH موجز
\fB#include <time.h>\fP
.nf
.P
\fBint clock_getcpuclockid(pid_t \fP\fIpid\fP\fB, clockid_t *\fP\fIclockid\fP\fB);\fP
.fi
.P
.ad l
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBclock_getcpuclockid\fP():
.nf
    _POSIX_C_SOURCE >= 200112L
.fi
.SH الوصف
الدالة \fBclock_getcpuclockid\fP() تحصل على معرف ساعة وقت وحدة المعالجة
المركزية للعملية التي معرفها \fIpid\fP، وتعيده في الموقع المشار إليه بواسطة
\fIclockid\fP. إذا كان \fIpid\fP صفرًا، يُعاد معرف ساعة وقت وحدة المعالجة المركزية
للعملية المستدعية.
.SH "قيمة الإرجاع"
عند النجاح، تُعيد \fBclock_getcpuclockid\fP() 0؛ عند الخطأ، تُعيد أحد أرقام
الأخطاء الموجبة المدرجة في الأخطاء.
.SH الأخطاء
.TP 
\fBENOSYS\fP
لا يدعم النواة الحصول على ساعة وقت وحدة المعالجة المركزية لكل عملية لعملية
أخرى، ولا يحدد \fIpid\fP العملية المستدعية.
.TP 
\fBEPERM\fP
لا يملك المستدعي صلاحية الوصول إلى ساعة وقت وحدة المعالجة المركزية للعملية
المحددة بواسطة \fIpid\fP. (محدد في POSIX.1\-2001؛ لا يحدث على لينكس ما لم يدعم
النواة الحصول على ساعة وقت وحدة المعالجة المركزية لكل عملية لعملية أخرى.)
.TP 
\fBESRCH\fP
لا توجد عملية بالمعرف \fIpid\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBclock_getcpuclockid\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
glibc 2.2.  POSIX.1\-2001.
.SH ملاحظات
استدعاء \fBclock_gettime\fP(2) مع معرف الساعة الذي حُصل عليه باستدعاء
\fBclock_getcpuclockid\fP() مع \fIpid\fP بقيمة 0، هو نفسه استخدام معرف الساعة
\fBCLOCK_PROCESS_CPUTIME_ID\fP.
.SH أمثلة
البرنامج المثالي أدناه يحصل على معرف ساعة وقت وحدة المعالجة المركزية للعملية
التي معرفها معطى في سطر الأوامر، ثم يستخدم \fBclock_gettime\fP(2) للحصول على
الوقت على تلك الساعة. مثال تشغيل هو التالي:
.P
.in +4n
.EX
$\fB ./a.out 1\fP                 # Show CPU clock of init process
CPU\-time clock for PID 1 is 2.213466748 seconds
.EE
.in
.SS "مصدر البرنامج"
.\" 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>\[rs]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("CPU\-time clock for PID %s is %jd.%09ld seconds\[rs]n",
           argv[1], (intmax_t) ts.tv_sec, ts.tv_nsec);
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "انظر أيضًا"
\fBclock_getres\fP(2), \fBtimer_create\fP(2), \fBpthread_getcpuclockid\fP(3),
\fBtime\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .