.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1995, James R. Van Zandt <jrv@vanzandt.mv.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ttyname 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
ttyname, ttyname_r \- إرجاع اسم طرفية
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP
.P
\fBchar *ttyname(int \fP\fIfd\fP\fB);\fP
\fBint ttyname_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
.SH الوصف
ترجع الدالة \fBttyname\fP() مؤشرًا إلى اسم المسار المنتهي بقيمة خالية لجهاز
الطرفية المفتوح على واصف الملف \fIfd\fP، أو NULL عند الخطأ (مثلًا، إذا كان
\fIfd\fP غير متصل بطرفية). قد تشير القيمة المُرجعة إلى بيانات ثابتة، قد تُستبدل
بالاستدعاء التالي. تخزن الدالة \fBttyname_r\fP() اسم المسار هذا في المخزن
المؤقت \fIbuf\fP بحجم \fIsize\fP.
.SH "قيمة الإرجاع"
ترجع الدالة \fBttyname\fP() مؤشرًا إلى اسم مسار عند النجاح. عند الخطأ، تُرجع
NULL، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. ترجع الدالة \fBttyname_r\fP() 0 عند
النجاح، ورقم خطأ عند الخطأ.
.SH الأخطاء
.TP 
\fBEBADF\fP
واصف ملف سيئ.
.TP 
.\" glibc commit 15e9a4f378c8607c2ae1aa465436af4321db0e23
\fBENODEV\fP
يشير \fIfd\fP إلى جهاز طرفية زائفة تابعة لكن تعذر العثور على اسم المسار المقابل
(انظر الملاحظات).
.TP 
\fBENOTTY\fP
لا يشير \fIfd\fP إلى جهاز طرفية.
.TP 
\fBERANGE\fP
(\fBttyname_r\fP()) كان \fIsize\fP صغيرًا جدًا للسماح بتخزين اسم المسار.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBttyname\fP()
T}	سلامة الخيوط	غير آمن للمسارات المتعددة (MT\-Unsafe) سباق:ttyname
T{
.na
.nh
\fBttyname_r\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001،‏ 4.2BSD.
.SH ملاحظات
عملية تُبقي واصف ملف يشير إلى جهاز \fBpts\fP(4) مفتوحًا عند التبديل إلى مساحة
وصل أخرى تستخدم مثيل \fI/dev/ptmx\fP مختلفًا قد تجد مصادفة أن مسار جهاز بنفس
الاسم لذلك الواصف موجود. لكن مسار الجهاز هذا يشير إلى جهاز مختلف وبالتالي لا
يمكن استخدامه للوصول إلى الجهاز الذي يشير إليه واصف الملف. استدعاء
\fBttyname\fP() أو \fBttyname_r\fP() على واصف الملف في مساحة الوصل الجديدة سيجعل
هذه الدوال تُرجع NULL وتضبط \fIerrno\fP إلى \fBENODEV\fP.
.SH "انظر أيضًا"
\fBtty\fP(1), \fBfstat\fP(2), \fBctermid\fP(3), \fBisatty\fP(3), \fBpts\fP(4)
.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 .