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 للإشارة إلى الخطأ.

الأخطاء

EACCES
    تعذر الوصول إلى الطرفية الزائفة التابعة المقابلة.

EBADF
    الوسيط fd ليس واصف ملف مفتوح صالح.

EINVAL
    الوسيط 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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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