Scroll to navigation

grantpt(3) Library Functions Manual grantpt(3)

الاسم

grantpt - منح الوصول إلى الطرفية الزائفة التابعة

المكتبة

مكتبة سي المعيارية (libc، -lc)

موجز

#define _XOPEN_SOURCE
#include <stdlib.h>
int grantpt(int fd);

متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

grantpt():


منذ glibc 2.24:
_XOPEN_SOURCE >= 500
glibc 2.23 وما قبله:
_XOPEN_SOURCE

الوصف

تغير الدالة grantpt() وضع ومالك جهاز الطرفية الزائفة التابعة المقابل للطرفية الزائفة الرئيسية المشار إليها بواصف الملف fd. تُضبط هوية المستخدم للتابعة إلى UID الحقيقي للعملية المستدعية. تُضبط هوية المجموعة إلى قيمة غير محددة (مثل tty). يُضبط وضع التابعة إلى 0620 (crw--w----).

سلوك grantpt() غير محدد إذا وُضع معالج إشارة لالتقاط إشارات SIGCHLD.

قيمة الإرجاع

عند النجاح، تُرجع grantpt() 0. وإلا، تُرجع -1 وتضبط errno للإشارة إلى الخطأ.

الأخطاء

تعذر الوصول إلى الطرفية الزائفة التابعة المقابلة.
الوسيط fd ليس واصف ملف مفتوح صالح.
الوسيط fd صالح لكنه غير مرتبط بطرفية زائفة رئيسية.

السمات

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

الواجهة السمة القيمة
grantpt() سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)

المعايير

POSIX.1-2008.

التاريخ

glibc 2.1. POSIX.1-2001.

هذا جزء من دعم الطرفيات الزائفة UNIX 98، انظر pts(4).

نفذت الأنظمة التاريخية هذه الدالة عبر ثنائي مساعد set-user-ID يُسمى "pt_chown". glibc على لينكس قبل glibc 2.33 كان يمكنه فعل ذلك أيضًا، لدعم تهيئات تحتوي فقط على طرفيات زائفة BSD؛ أُزيل هذا الدعم. على الأنظمة الحديثة، هذا إما عملية لا شيء —مع صلاحيات مهيأة عند تخصيص pty، كما هو الحال على لينكس— أو ioctl(2).

انظر أيضًا

open(2), posix_openpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

21 سبتمبر 2025 صفحات دليل لينكس (لم تصدر بعد)