.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2002, Andries E. Brouwer <aeb@cwi.nl>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ttyslot 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
ttyslot \- إيجاد موضع طرفية المستخدم الحالي في ملف ما
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP       /* انظر في الملاحظات */
.P
\fBint ttyslot(void);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBttyslot\fP():
.nf
    Since glibc 2.24:
        _DEFAULT_SOURCE
    From glibc 2.20 to glibc 2.23:
        _DEFAULT_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
    glibc 2.19 and earlier:
        _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE < 500)
.fi
.SH الوصف
الدالة القديمة \fBttyslot\fP() تُرجع فهرس إدخال المستخدم الحالي في ملف ما.
.P
الآن تسأل "أي ملف؟" حسنًا، لننظر أولاً إلى بعض التاريخ.
.SS "تاريخ قديم"
كان يوجد ملف \fI/etc/ttys\fP في UNIX\ V6، يُقرأ بواسطة برنامج \fBinit\fP(1) لمعرفة
ما يُفعل بكل خط طرفية. كل سطر يتكون من ثلاثة محارف. الحرف الأول كان إما
\[aq]0\[aq] أو \[aq]1\[aq]، حيث \[aq]0\[aq] يعني "تجاهل". الحرف الثاني يُشير
إلى الطرفية: \[aq]8\[aq] يرمز إلى "/dev/tty8". الحرف الثالث كان وسيطًا لـ
\fBgetty\fP(8) يُشير إلى تسلسل سرعات الخط لتجربتها (\[aq]\-\[aq] كان: ابدأ
بتجربة 110 باود). وهكذا كان السطر النموذجي "18\-". عُولج تعليق على خط ما
بتغيير \[aq]1\[aq] إلى \[aq]0\[aq]، وإرسال إشارة إلى init، ثم إعادته مرة
أخرى، وإرسال إشارة أخرى إلى init.
.P
في UNIX\ V7، تغير التنسيق: هنا الحرف الثاني كان الوسيط لـ \fBgetty\fP(8) يُشير
إلى تسلسل سرعات الخط لتجربتها (\[aq]0\[aq] كان: دورة عبر 300\-1200\-150\-110
باود؛ \[aq]4\[aq] كان لوحدة التحكم المتصلة DECwriter) بينما يحتوي باقي السطر
على اسم الطرفية. وهكذا كان السطر النموذجي "14console".
.P
الأنظمة اللاحقة لها بناء جملة أكثر تفصيلاً. الأنظمة المشابهة لـ System V
لديها \fI/etc/inittab\fP بدلاً من ذلك.
.SS "تاريخ قديم (2)"
من ناحية أخرى، يوجد الملف \fI/etc/utmp\fP الذي يُدرج الأشخاص المسجلين
حاليًا. يُحافظ عليه بواسطة \fBlogin\fP(1). له حجم ثابت، والفهرس المناسب في
الملف يُحدد بواسطة \fBlogin\fP(1) باستخدام استدعاء \fBttyslot\fP() لإيجاد رقم
السطر في \fI/etc/ttys\fP (بدء العد من 1).
.SS "دلالات ttyslot"
وبالتالي، الدالة \fBttyslot\fP() تُرجع فهرس الطرفية المسيطرة لعملية الاستدعاء
في الملف \fI/etc/ttys\fP، وهذا (عادةً) هو نفسه فهرس إدخال المستخدم الحالي في
الملف \fI/etc/utmp\fP. لا يزال BSD يمتلك الملف \fI/etc/ttys\fP، لكن الأنظمة
المشابهة لـ System V لا تمتلكه، وبالتالي لا يمكنها الإشارة إليه. لذا، على
هذه الأنظمة، يقول التوثيق أن \fBttyslot\fP() تُرجع فهرس المستخدم الحالي في
قاعدة بيانات محاسبة المستخدم.
.SH "قيمة الإرجاع"
إذا نجحت، تُرجع هذه الدالة رقم الموضع. عند الخطأ (مثلًا، إذا لم يكن أي من
واصفات الملفات 0 أو 1 أو 2 مرتبطًا بطرفية موجودة في قاعدة البيانات هذه)
تُرجع 0 على UNIX\ V6 وV7 والأنظمة المشابهة لـ BSD، لكن \-1 على الأنظمة
المشابهة لـ System V.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBttyslot\fP()
T}	سلامة الخيوط	غير آمن لتعدد الخيوط (MT\-Unsafe)
.TE
.SH الإصدارات
ملف utmp يُوجد في أماكن مختلفة على أنظمة مختلفة، مثل \fI/etc/utmp\fP
و\fI/var/adm/utmp\fP و\fI/var/run/utmp\fP.
.SH المعايير
لا شيء.
.SH التاريخ
SUSv1؛ وُسم كـ LEGACY في SUSv2؛ أُزيل في POSIX.1\-2001. SUSv2 يتطلب \-1 عند
الخطأ.
.P
تقرأ دالة glibc2 لهذه الدالة الملف \fB_PATH_TTYS\fP، المُعرَّف في
\fI<ttyent.h>\fP باسم "/etc/ttys". تُرجع 0 عند الخطأ. نظرًا لأن أنظمة
Linux لا تحتوي عادةً على "/etc/ttys"، فستُرجع دائمًا 0.
.P
في الأنظمة الشبيهة بـ BSD و Linux، يُوفَّر تعريف \fBttyslot\fP() بواسطة
\fI<unistd.h>\fP. في الأنظمة الشبيهة بـ System V، يُوفَّر التعريف
بواسطة \fI<stdlib.h>\fP. منذ glibc 2.24، يُوفِّر \fI<stdlib.h>\fP
أيضًا التعريف مع تعريفات وحدات الماكرو لاختبار الميزات التالية:
.P
.in +4n
.EX
(_XOPEN_SOURCE >= 500 ||
        (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED))
    && ! (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600)
.EE
.in
.P
.\" .SH HISTORY
.\" .BR ttyslot ()
.\" appeared in UNIX V7.
يحتوي Minix أيضًا على \fIfttyslot\fP(\fIfd\fP).
.SH "انظر أيضًا"
\fBgetttyent\fP(3)، \fBttyname\fP(3)، \fButmp\fP(5)
.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 .