.\" -*- coding: UTF-8 -*-
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ioperm 2 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
ioperm \- تعيين أذونات الإدخال/الإخراج للمنفذ
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <sys/io.h>\fP
.P
\fBint ioperm(unsigned long \fP\fIfrom\fP\fB, unsigned long \fP\fInum\fP\fB, int \fP\fIturn_on\fP\fB);\fP
.fi
.SH الوصف
تضبط \fBioperm\fP()  بتات أذونات الوصول إلى المنفذ للخيط المستدعي لعدد \fInum\fP
من البتات بدءًا من عنوان المنفذ \fIfrom\fP.  إذا كانت \fIturn_on\fP غير صفرية،
فسيتم تمكين الإذن للبتات المحددة؛ وإلا فسيتم تعطيله.  إذا كانت \fIturn_on\fP
غير صفرية، يجب أن يكون الخيط المستدعي مميزًا (\fBCAP_SYS_RAWIO\fP).
.P
قبل لينكس 2.6.8، كان يمكن تحديد أول 0x3ff من منافذ الإدخال/الإخراج فقط بهذه
الطريقة.  للمزيد من المنافذ، كان يجب استخدام استدعاء النظام \fBiopl\fP(2)
(بوسيطة \fIlevel\fP بقيمة 3).  منذ لينكس 2.6.8، يمكن تحديد 65,536 منفذ
إدخال/إخراج.
.P
تُورث الأذونات بواسطة العملية التابعة المنشأة بواسطة \fBfork\fP(2) (لكن انظر
التاريخ).  تُحفظ الأذونات عبر \fBexecve\fP(2)؛ هذا مفيد لإعطاء أذونات الوصول
إلى المنفذ للبرامج غير المميزة.
.P
هذا الاستدعاء مخصص بشكل أساسي لمعمارية i386.  في العديد من المعماريات
الأخرى، لا يوجد أو سيعيد دائمًا خطأ.
.SH "قيمة الإرجاع"
عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP
للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
قيم غير صالحة لـ \fIfrom\fP أو \fInum\fP.
.TP 
\fBEIO\fP
(على PowerPC) هذا الاستدعاء غير مدعوم.
.TP 
\fBENOMEM\fP
.\" Could not allocate I/O bitmap.
نفدت الذاكرة.
.TP 
\fBEPERM\fP
الخيط المستدعي لديه صلاحية غير كافية.
.SH الإصدارات
تحتوي glibc على نموذج أولي لـ \fBioperm\fP()  في كل من \fI<sys/io.h>\fP و
\fI<sys/perm.h>\fP.  تجنب الأخير، فهو متاح فقط على i386.
.SH المعايير
لينكس.
.SH التاريخ
قبل لينكس 2.4، لم تكن الأذونات تُورث بواسطة عملية تابعة منشأة بواسطة
\fBfork\fP(2).
.SH ملاحظات
يظهر ملف \fI/proc/ioports\fP منافذ الإدخال/الإخراج المخصصة حاليًا على النظام.
.SH "انظر أيضًا"
\fBiopl\fP(2), \fBoutb\fP(2), \fBcapabilities\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 .