.\" -*- coding: UTF-8 -*- .\" Copyright 1980-1991, The Regents of the University of California. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getpriority 2 "23 يناير 2026" "صفحات دليل لينكس 6.18" .SH الاسم getpriority, setpriority \- الحصول/تعيين أولوية جدولة البرنامج .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint getpriority(int \fP\fIwhich\fP\fB, id_t \fP\fIwho\fP\fB);\fP \fBint setpriority(int \fP\fIwhich\fP\fB, id_t \fP\fIwho\fP\fB, int \fP\fIprio\fP\fB);\fP .fi .SH الوصف أولوية الجدولة للعملية، أو مجموعة العمليات، أو المستخدم، كما هو موضح بواسطة \fIwhich\fP و \fIwho\fP، يتم الحصول عليها باستدعاء \fBgetpriority\fP() وتعيينها باستدعاء \fBsetpriority\fP(). سمة العملية التي تتعامل معها استدعاءات النظام هذه هي نفس السمة (المعروفة أيضًا بقيمة "nice") التي يتعامل معها \fBnice\fP(2). .P القيمة \fIwhich\fP هي إحدى \fBPRIO_PROCESS\fP أو \fBPRIO_PGRP\fP أو \fBPRIO_USER\fP، ويتم تفسير \fIwho\fP بالنسبة إلى \fIwhich\fP (معرف عملية لـ \fBPRIO_PROCESS\fP، ومعرف مجموعة عمليات لـ \fBPRIO_PGRP\fP، ومعرف مستخدم لـ \fBPRIO_USER\fP). القيمة الصفرية لـ \fIwho\fP تشير (على التوالي) إلى العملية المستدعية، أو مجموعة العمليات للعملية المستدعية، أو معرف المستخدم الحقيقي للعملية المستدعية. .P الوسيطة \fIprio\fP هي قيمة في النطاق \-20 إلى 19 (ولكن انظر الملاحظات أدناه)، حيث \-20 هي أعلى أولوية و 19 هي أدنى أولوية. محاولات تعيين أولوية خارج هذا النطاق يتم تقييدها بصمت إلى النطاق. الأولوية المبدئية هي 0؛ القيم الأقل تعطي العملية أولوية جدولة أعلى. .P استدعاء \fBgetpriority\fP() يعيد أعلى أولوية (أقل قيمة عددية) تتمتع بها أي من العمليات المحددة. استدعاء \fBsetpriority\fP() يعين أولويات جميع العمليات المحددة إلى القيمة المحددة. .P تقليديًا، كانت العملية المتميزة فقط هي التي يمكنها خفض قيمة nice (أي ضبط أولوية أعلى). ومع ذلك، فمنذ لينكس 2.6.12، يمكن لعملية غير متميزة تقليل قيمة nice لعملية مستهدفة لها حد مرن مناسب لـ \fBRLIMIT_NICE\fP؛ انظر \fBgetrlimit\fP(2) لمزيد من التفاصيل. .SH "قيمة الإرجاع" عند النجاح، يعيد \fBgetpriority\fP() قيمة nice للخيط المستدعي، والتي قد تكون رقمًا سالبًا. عند الخطأ، يعيد \-1 ويضبط \fIerrno\fP للإشارة إلى الخطأ. .P نظرًا لأن الاستدعاء الناجح لـ \fBgetpriority\fP() يمكن أن يعيد بشكل شرعي القيمة \-1، فمن الضروري مسح \fIerrno\fP قبل الاستدعاء، ثم التحقق من \fIerrno\fP بعد ذلك لتحديد ما إذا كانت \-1 خطأ أم قيمة شرعية. .P \fBsetpriority\fP() يعيد 0 عند النجاح. عند الفشل، يعيد \-1 ويضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEACCES\fP حاول المستدعي تعيين قيمة nice أقل (أي أولوية عملية أعلى)، لكنه لم يكن لديه الامتياز المطلوب (على لينكس: لم يكن لديه القدرة \fBCAP_SYS_NICE\fP). .TP \fBEINVAL\fP \fIwhich\fP لم تكن واحدة من \fBPRIO_PROCESS\fP أو \fBPRIO_PGRP\fP أو \fBPRIO_USER\fP. .TP \fBEPERM\fP تم تحديد موقع عملية، لكن معرف المستخدم الفعال الخاص بها لم يطابق المعرف الفعال أو الحقيقي للمستخدم المستدعي، ولم تكن مميزة (على لينكس: لم يكن لديها القدرة \fBCAP_SYS_NICE\fP). ولكن انظر التاريخ أدناه. .TP \fBESRCH\fP لم يتم تحديد موقع أي عملية باستخدام قيم \fIwhich\fP و \fIwho\fP المحددة. .SH المعايير POSIX.1\-2024. .SH التاريخ 4.2BSD, SVr4, SUSv1, POSIX.1\-2001 XSI. .P .\" تفاصيل حالة \fBEPERM\fP تعتمد على النظام. الوصف أعلاه هو ما يقوله POSIX.1\-2001، ويبدو أنه متبع في جميع الأنظمة الشبيهة بـ System\ V. أنوية لينكس قبل لينكس 2.6.12 تطلبت أن يتطابق معرف المستخدم الحقيقي أو الفعال للمستدعي مع المستخدم الحقيقي للعملية \fIwho\fP (بدلاً من معرف المستخدم الفعال الخاص بها). لينكس 2.6.12 والإصدارات الأحدث تتطلب أن يتطابق معرف المستخدم الفعال للمستدعي مع معرف المستخدم الحقيقي أو الفعال للعملية \fIwho\fP. جميع الأنظمة الشبيهة بـ BSD (SunOS 4.1.3, Ultrix 4.2, 4.3BSD, FreeBSD 4.3, OpenBSD\-2.5, ...) تتصرف بنفس طريقة لينكس 2.6.12 والإصدارات الأحدث. .SH ملاحظات لمزيد من التفاصيل حول قيمة اللطافة (nice value)، راجع \fBsched\fP(7). .P \fIملاحظة\fP: إضافة ميزة "التجميع الآلي" في لينكس 2.6.38 تعني أن قيمة الأولوية (nice) لم يعد لها تأثيرها التقليدي في كثير من الظروف. للتفاصيل، انظر \fBsched\fP(7). .P الطفل الذي تم إنشاؤه بواسطة \fBfork\fP(2) يرث قيمة nice الخاصة بالوالد. يتم الحفاظ على قيمة nice عبر \fBexecve\fP(2). .SS "الاختلافات بين مكتبة C والنواة" استدعاء النظام getpriority يعيد قيم nice مترجمة إلى النطاق 40..1، حيث أن القيمة السالبة سيتم تفسيرها كخطأ. دالة الغلاف glibc لـ \fBgetpriority\fP() تترجم القيمة مرة أخرى وفقًا للصيغة \fIunice\~=\20\-\knice\fP (وبالتالي، النطاق 40..1 الذي يعيده النواة يتوافق مع النطاق \-20..19 كما يُرى من مساحة المستخدم). .SH العلل وفقًا لـ POSIX، قيمة nice هي إعداد لكل عملية. ومع ذلك، في ظل تطبيق لينكس/NPTL الحالي لخيوط POSIX، قيمة nice هي سمة لكل خيط: يمكن للخيوط المختلفة في نفس العملية أن يكون لها قيم nice مختلفة. يجب على التطبيقات المحمولة تجنب الاعتماد على سلوك لينكس، والذي قد يتم جعله متوافقًا مع المعايير في المستقبل. .SH "انظر أيضًا" \fBnice\fP(1), \fBrenice\fP(1), \fBfork\fP(2), \fBcapabilities\fP(7), \fBsched\fP(7) .P \fIDocumentation/scheduler/sched\-nice\-design.rst\fP في شجرة مصدر نواة لينكس (منذ لينكس 2.6.23) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .