posix_openpt(3)

الاسم
posix_openpt - فتح جهاز طرفية زائفة

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

موجز
#include <stdlib.h>
#include <fcntl.h>

int posix_openpt(int flags);

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

posix_openpt():
    _XOPEN_SOURCE >= 600

الوصف
تفتح الدالة posix_openpt() جهاز طرفية زائفة رئيسي غير مستخدم، وتُعيد واصف ملف يمكن استخدامه للإشارة إلى ذلك الجهاز.

الوسيط flags هو قناع بتات يجمع باستخدام OR صفرًا أو أكثر من الأعلام التالية:

O_RDWR
    فتح الجهاز للقراءة والكتابة معًا. من المعتاد تحديد هذا العلم.

O_NOCTTY
    عدم جعل هذا الجهاز الطرفية المسيطرة للعملية.

قيمة الإرجاع
عند النجاح، تُعيد posix_openpt() واصف ملف (عدد صحيح غير سالب) وهو أقل واصف ملف غير مستخدم مرقم. عند الفشل، تُعاد -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء
انظر open(2).

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

المعايير
POSIX.1-2008.

التاريخ
glibc 2.2.1. POSIX.1-2001.

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

ملاحظات
بعض تطبيقات UNIX الأقدم التي تدعم الطرفيات الزائفة System V (المعروفة أيضًا بـ UNIX 98) لا تحتوي على هذه الدالة، ولكن يمكن تنفيذها بسهولة بفتح جهاز تعدد الإرسال للطرفية الزائفة:

    int
    posix_openpt(int flags)
    {
        return open("/dev/ptmx", flags);
    }

استدعاء posix_openpt() يُنشئ اسم مسار لجهاز الطرفية الزائفة التابع المقابل. يمكن الحصول على اسم مسار الجهاز التابع باستخدام ptsname(3). اسم مسار الجهاز التابع موجود فقط طالما الجهاز الرئيسي مفتوح.

انظر أيضًا
open(2), getpt(3), grantpt(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.