ptsname(3)

الاسم
ptsname, ptsname_r - الحصول على اسم الطرفية الزائفة التابعة

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

موجز
#include <stdlib.h>

char *ptsname(int fd);
int ptsname_r(size_t size;
              int fd, char buf[size], size_t size);

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

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

ptsname_r():
    _GNU_SOURCE

الوصف
تُرجع الدالة ptsname() اسم جهاز الطرفية الزائفة التابعة المقابل للرئيس المشار إليه بواصف الملف fd.

الدالة ptsname_r() هي المكافئ القابل لإعادة الدخول لـ ptsname(). تُرجع اسم جهاز الطرفية الزائفة التابعة كسلسلة محارف منتهية بصفر في المخزن المؤقت المشار إليه بـ buf. تُحدد الوسيطة size عدد البايتات المتاحة في buf.

قيمة الإرجاع
عند النجاح، تُرجع ptsname() مؤشرًا إلى سلسلة محارف في تخزين ثابت ستُستبدل بالاستدعاءات اللاحقة. يجب عدم تحرير هذا المؤشر. عند الفشل، يُرجع NULL.

عند النجاح، تُرجع ptsname_r() 0. عند الفشل، يُرجع رقم خطأ للإشارة إلى الخطأ.

الأخطاء

EINVAL
    (لـ ptsname_r() فقط) buf هو NULL. (يُرجَع هذا الخطأ فقط لـ glibc 2.25 والإصدارات الأقدم.)

ENOTTY
    fd لا يشير إلى جهاز رئيسي للطرفية الزائفة.

ERANGE
    (لـ ptsname_r() فقط) buf صغير جدًا.

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

الإصدارات
نسخة من ptsname_r() موثقة على Tru64 وHP-UX وFreeBSD، لكن في تلك التطبيقات، يُرجَع -1 عند الخطأ، مع تعيين errno للإشارة إلى الخطأ. تجنب استخدام هذه الدالة في البرامج المحمولة.

المعايير

ptsname():
    POSIX.1-2008.

ptsname_r():
    POSIX.1-2024.

التاريخ

ptsname():
    POSIX.1-2001. glibc 2.1.

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

ptsname_r():
    GNU.

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