.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, OpenBSD Group
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: BSD-3-Clause
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH openpty 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" 
.SH الاسم
openpty, login_tty, forkpty \- دوال طرفية مساعدة
.SH المكتبة
مكتبة أدوات النظام (\fIlibutil\fP،\ \fI\-lutil\fP)
.SH موجز
.nf
\fB#include <pty.h>\fP
.P
\fBint openpty(int *\fP\fIamaster\fP\fB, int *\fP\fIaslave\fP\fB, char *\fP\fIname\fP\fB,\fP
\fB              const struct termios *\fP\fItermp\fP\fB,\fP
\fB              const struct winsize *\fP\fIwinp\fP\fB);\fP
\fBpid_t forkpty(int *\fP\fIamaster\fP\fB, char *\fP\fIname\fP\fB,\fP
\fB              const struct termios *\fP\fItermp\fP\fB,\fP
\fB              const struct winsize *\fP\fIwinp\fP\fB);\fP
.P
\fB#include <utmp.h>\fP
.P
\fBint login_tty(int \fP\fIfd\fP\fB);\fP
.fi
.SH الوصف
الدالة \fBopenpty\fP()  تبحث عن طرف زائف متاح وتُعيد واصفات ملفات للسيد والعبد
في \fIamaster\fP و \fIaslave\fP.  إذا كان \fIname\fP ليس NULL، يُعاد اسم ملف العبد في
\fIname\fP.  إذا كان \fItermp\fP ليس NULL، تُضبط معاملات الطرف للعبد إلى القيم في
\fItermp\fP.  إذا كان \fIwinp\fP ليس NULL، يُضبط حجم نافذة العبد إلى القيم في
\fIwinp\fP.
.P
الدالة \fBlogin_tty\fP()  تُحضّر لتسجيل الدخول على الطرف المشار إليه بواسطة
واصف الملف \fIfd\fP (قد يكون جهاز طرف حقيقي، أو عبد طرف زائف كما تُعيده
\fBopenpty\fP())  بإنشاء جلسة جديدة، وجعل \fIfd\fP الطرف المسيطر للعملية
المستدعية، وضبط \fIfd\fP ليكون تيارات الإدخال والإخراج والخطأ القياسية للعملية
الحالية، وإغلاق \fIfd\fP.
.P
الدالة \fBforkpty\fP()  تدمج \fBopenpty\fP() و \fBfork\fP(2) و \fBlogin_tty\fP()  لإنشاء
عملية جديدة تعمل في طرف زائف.  يُعاد واصف ملف يشير إلى جانب السيد من الطرف
الزائف في \fIamaster\fP.  إذا كان \fIname\fP ليس NULL، يُستخدم المخزن المؤقت الذي
يشير إليه لإعادة اسم ملف العبد.  الوسيطان \fItermp\fP و \fIwinp\fP، إذا لم يكونا
NULL، يُحددان سمات الطرف وحجم نافذة جانب العبد من الطرف الزائف.
.SH "قيمة الإرجاع"
إذا لم تنجح استدعاء \fBopenpty\fP() أو \fBlogin_tty\fP() أو \fBforkpty\fP()، يُعاد \-1
ويُضبط \fIerrno\fP للإشارة إلى الخطأ.  وإلا، تُعيد \fBopenpty\fP() و
\fBlogin_tty\fP() وعملية الطفل لـ \fBforkpty\fP() 0، وتُعيد العملية الأم لـ
\fBforkpty\fP() معرف العملية للطفل.
.SH الأخطاء
\fBopenpty\fP()  تفشل إذا:
.TP 
\fBENOENT\fP
لا توجد أطراف متاحة.
.P
\fBlogin_tty\fP()  تفشل إذا فشلت \fBioctl\fP(2)  في ضبط \fIfd\fP ليكون الطرف المسيطر
للعملية المستدعية.
.P
\fBforkpty\fP()  تفشل إذا فشلت إما \fBopenpty\fP()  أو \fBfork\fP(2).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBforkpty\fP()،
\fBopenpty\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
T{
.na
.nh
\fBlogin_tty\fP()
T}	سلامة الخيوط	غير آمن للمسارات المتعددة (MT\-Unsafe) سباق:ttyname
.TE
.SH المعايير
BSD.
.SH التاريخ
أُضيفت معدّلات \fBconst\fP إلى وسائط مؤشرات البنية لـ \fBopenpty\fP()  و
\fBforkpty\fP()  في glibc 2.8.
.P
قبل glibc 2.0.92، تُعيد \fBopenpty\fP()  واصفات ملفات لزوج طرف زائف BSD؛ منذ
glibc 2.0.92، تحاول أولاً فتح زوج طرف زائف UNIX 98، وتتراجع إلى فتح زوج طرف
زائف BSD إذا فشل ذلك.
.SH العلل
لا أحد يعرف مقدار المساحة التي يجب حجزها لـ \fIname\fP.  لذا، استدعاء
\fBopenpty\fP()  أو \fBforkpty\fP()  مع \fIname\fP غير NULL قد لا يكون آمناً.
.SH "انظر أيضًا"
\fBfork\fP(2), \fBttyname\fP(3), \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 .