.\" -*- coding: UTF-8 -*-
'\" t
.\" %%%LICENSE_START(PUBLIC_DOMAIN)
.\" This page is in the public domain.  - aeb
.\" %%%LICENSE_END
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ptsname 3 "29 أكتوبر 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
ptsname, ptsname_r \- الحصول على اسم الطرفية الزائفة التابعة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdlib.h>\fP
.P
\fBchar *ptsname(int \fP\fIfd\fP\fB);\fP
\fBint ptsname_r(\fPsize_t size;
\fB              int \fP\fIfd\fP\fB, char \fP\fIbuf\fP\fB[\fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBptsname\fP():
.nf
.\"        || (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED)
    منذ glibc 2.24:
        _XOPEN_SOURCE >= 500
    glibc 2.23 وما قبله:
        _XOPEN_SOURCE
.fi
.P
\fBptsname_r\fP():
.nf
    _GNU_SOURCE
.fi
.SH الوصف
تُرجع الدالة \fBptsname\fP() اسم جهاز الطرفية الزائفة التابعة المقابل للرئيس
المشار إليه بواصف الملف \fIfd\fP.
.P
الدالة \fBptsname_r\fP() هي المكافئ القابل لإعادة الدخول لـ \fBptsname\fP(). تُرجع
اسم جهاز الطرفية الزائفة التابعة كسلسلة محارف منتهية بصفر في المخزن المؤقت
المشار إليه بـ \fIbuf\fP. تُحدد الوسيطة \fIsize\fP عدد البايتات المتاحة في \fIbuf\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع \fBptsname\fP() مؤشرًا إلى سلسلة محارف في تخزين ثابت ستُستبدل
بالاستدعاءات اللاحقة. يجب عدم تحرير هذا المؤشر. عند الفشل، يُرجع NULL.
.P
.\" In glibc, the error number is not only returned as the return value
.\" but also stored in errno.  But this is not true for musl libc.
عند النجاح، تُرجع \fBptsname_r\fP() 0. عند الفشل، يُرجع رقم خطأ للإشارة إلى
الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
.\" glibc commit 8f0a947cf55f3b0c4ebdf06953c57eff67a22fa9
(لـ \fBptsname_r\fP() فقط) \fIbuf\fP هو NULL. (يُرجَع هذا الخطأ فقط لـ glibc 2.25
والإصدارات الأقدم.)
.TP 
\fBENOTTY\fP
\fIfd\fP لا يشير إلى جهاز رئيسي للطرفية الزائفة.
.TP 
\fBERANGE\fP
(لـ \fBptsname_r\fP() فقط) \fIbuf\fP صغير جدًا.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBptsname\fP()
T}	سلامة الخيوط	MT\-Unsafe race:ptsname
T{
.na
.nh
\fBptsname_r\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH الإصدارات
نسخة من \fBptsname_r\fP() موثقة على Tru64 وHP\-UX وFreeBSD، لكن في تلك
التطبيقات، يُرجَع \-1 عند الخطأ، مع تعيين \fIerrno\fP للإشارة إلى الخطأ. تجنب
استخدام هذه الدالة في البرامج المحمولة.
.SH المعايير
.TP 
\fBptsname\fP():
POSIX.1\-2008.
.TP 
\fBptsname_r\fP():
POSIX.1\-2024.
.SH التاريخ
.TP 
\fBptsname\fP():
POSIX.1\-2001.  glibc 2.1.
.P
\fBptsname\fP() جزء من دعم الطرفية الزائفة UNIX 98 (انظر \fBpts\fP(4)).
.TP 
\fBptsname_r\fP():
GNU.
.SH "انظر أيضًا"
\fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBttyname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4),
\fBpty\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .