.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH timer_settime 2 "2 مايو 2024" "صفحات دليل لينكس 6.9.1" .SH الاسم timer_settime, timer_gettime \- تسليح/نزع سلاح وجلب حالة مؤقت لكل عملية في POSIX .SH المكتبة مكتبة الوقت الحقيقي (\fIlibrt\fP، \fI\-lrt\fP) .SH موجز .nf \fB#include \fP .P \fBint timer_gettime(timer_t \fP\fItimerid\fP\fB, struct itimerspec *\fP\fIcurr_value\fP\fB);\fP \fBint timer_settime(timer_t \fP\fItimerid\fP\fB, int \fP\fIflags\fP\fB,\fP \fB const struct itimerspec *restrict \fP\fInew_value\fP\fB,\fP \fB struct itimerspec *_Nullable restrict \fP\fIold_value\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBtimer_settime\fP()، \fBtimer_gettime\fP(): .nf _POSIX_C_SOURCE >= 199309L .fi .SH الوصف \fBtimer_settime\fP() تسلح أو تنزع سلاح المؤقت المعرف بواسطة \fItimerid\fP. الوسيطة \fInew_value\fP هي مؤشر لبنية \fIitimerspec\fP تحدد القيمة الأولية الجديدة والفاصل الزمني الجديد للمؤقت. بنية \fIitimerspec\fP موصوفة في \fBitimerspec\fP(3type). .P كل من البنى الفرعية لبنية \fIitimerspec\fP هي بنية \fBtimespec\fP(3) تسمح بتحديد قيمة زمنية بالثواني والنانوثواني. تقاس هذه القيم الزمنية وفقًا للساعة التي حددت عند إنشاء المؤقت بواسطة \fBtimer_create\fP(2). .P إذا حدد \fInew_value\->it_value\fP قيمة غير صفرية (أي، أي حقل فرعي غير صفري)، فإن \fBtimer_settime\fP() تسلح (تبدأ) المؤقت، وتضبطه لينتهي مبدئيًا في الوقت المحدد. (إذا كان المؤقت مسلحًا بالفعل، فستُستبدل الإعدادات السابقة.) إذا حدد \fInew_value\->it_value\fP قيمة صفرية (أي، كلا الحقلين الفرعيين صفريين)، فسيُنزع سلاح المؤقت. .P حقل \fInew_value\->it_interval\fP يحدد فترة المؤقت، بالثواني والنانوثواني. إذا كان هذا الحقل غير صفري، ففي كل مرة ينتهي فيها مؤقت مسلح، يُعاد تحميل المؤقت من القيمة المحددة في \fInew_value\->it_interval\fP. إذا حدد \fInew_value\->it_interval\fP قيمة صفرية، فإن المؤقت ينتهي مرة واحدة فقط، في الوقت المحدد بواسطة \fIit_value\fP. .P .\" By experiment: the overrun count is set correctly, for CLOCK_REALTIME. مبدئيًا، يُفسر وقت الانتهاء الأولي المحدد في \fInew_value\->it_value\fP بالنسبة للوقت الحالي على ساعة المؤقت وقت الاستدعاء. يمكن تعديل ذلك بتحديد \fBTIMER_ABSTIME\fP في \fIflags\fP، وفي هذه الحالة يُفسر \fInew_value\->it_value\fP كقيمة مطلقة كما تُقاس على ساعة المؤقت؛ أي، سينتهي المؤقت عندما تصل قيمة الساعة إلى القيمة المحددة بواسطة \fInew_value\->it_value\fP. إذا كان الوقت المطلق المحدد قد مضى بالفعل، فإن المؤقت ينتهي فورًا، وسيُضبط عدد التجاوز (انظر \fBtimer_getoverrun\fP(2)) بشكل صحيح. .P .\" Similar remarks might apply with respect to process and thread CPU time .\" clocks, but these clocks are not currently (2.6.28) settable on Linux. إذا ضُبطت قيمة ساعة \fBCLOCK_REALTIME\fP أثناء تسليح مؤقت مطلق مبني على تلك الساعة، فسيُضبط انتهاء المؤقت بشكل مناسب. التعديلات على ساعة \fBCLOCK_REALTIME\fP ليس لها تأثير على المؤقتات النسبية المبنية على تلك الساعة. .P إذا لم يكن \fIold_value\fP NULL، فإنه يشير إلى مخزن مؤقت يُستخدم لإرجاع الفاصل الزمني السابق للمؤقت (في \fIold_value\->it_interval\fP) ومقدار الوقت حتى كان سينتهي المؤقت سابقًا في المرة التالية (في \fIold_value\->it_value\fP). .P \fBtimer_gettime\fP() تُرجع الوقت حتى الانتهاء التالي، والفاصل الزمني، للمؤقت المحدد بواسطة \fItimerid\fP، في المخزن المؤقت المشار إليه بواسطة \fIcurr_value\fP. الوقت المتبقي حتى انتهاء المؤقت التالي يُعاد في \fIcurr_value\->it_value\fP؛ هذه دائمًا قيمة نسبية، بغض النظر عما إذا كانت علامة \fBTIMER_ABSTIME\fP قد استُخدمت عند تسليح المؤقت. إذا كانت القيمة المعادة في \fIcurr_value\->it_value\fP صفرًا، فإن المؤقت حاليًا منزوع السلاح. يُعاد الفاصل الزمني للمؤقت في \fIcurr_value\->it_interval\fP. إذا كانت القيمة المعادة في \fIcurr_value\->it_interval\fP صفرًا، فهذا مؤقت "أحادي الطلقة". .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBtimer_settime\fP() و \fBtimer_gettime\fP() 0. عند الخطأ، يُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء قد تفشل هذه الدوال مع الأخطاء التالية: .TP \fBEFAULT\fP \fInew_value\fP، أو \fIold_value\fP، أو \fIcurr_value\fP ليس مؤشراً صالحاً. .TP \fBEINVAL\fP .\" FIXME . eventually: invalid value in flags \fItimerid\fP غير صالح. .P قد تفشل \fBtimer_settime\fP() مع الأخطاء التالية: .TP \fBEINVAL\fP \fInew_value.it_value\fP سالب؛ أو \fInew_value.it_value.tv_nsec\fP سالب أو أكبر من 999,999,999. .SH المعايير POSIX.1\-2008. .SH التاريخ لينكس 2.6. POSIX.1\-2001. .SH أمثلة انظر \fBtimer_create\fP(2). .SH "انظر أيضًا" \fBtimer_create\fP(2)، \fBtimer_getoverrun\fP(2)، \fBtimespec\fP(3)، \fBtime\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .