الاسم

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

#include <stdlib.h>

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

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_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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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