الاسم¶

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);

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.