'\" t
.\"     Title: agetty
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: إدارة النظام
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "AGETTY" "8" "2026-05-18" "util\-linux 2.42.1" "إدارة النظام"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
agetty \- بديل لينكس getty
.SH "موجز"
.sp
\fBagetty\fP [خيارات] \fIالمنفذ\fP [\fI‎معدل_البود\fP.\|.\|.] [\fIالطرفية\fP]
.SH "الوصف"
.sp
يفتح \fBagetty\fP منفذ tty، ويطلب اسم ولوج ويستدعي الأمر /bin/login. يُستدعى عادةً بواسطة \fBinit\fP(8).
.sp
يمتلك \fBagetty\fP ميزات \fIغير قياسية\fP عديدة مفيدة للخطوط السلكية وخطوط الاتصال الهاتفي:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يُكيّف إعدادات tty مع بتات التماثل ومع محارف المحو (erase)، والإنهاء (kill)، ونهاي السطر (end\-of\-line)، والأحرف الكبيرة عند قراءة اسم ولوج. يستطيع البرنامج التعامل مع محارف 7\-بت بتماثل زوجي أو فردي أو بلا تماثل أو تماثل فراغي، ومحارف 8\-بت بلا تماثل. يُميز البرنامج المحارف الخاصة التالية: ‏Control\-U (للإنهاء)؛ و DEL و backspace (للمحو)؛ ورجوع العربة (carriage return) وتغذية السطر (line feed) (لنهاية السطر). انظر أيضاً الخيارين \fB\-\-erase\-chars\fP و \fB\-\-kill\-chars\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يستنتج اختيارياً معدل البود من رسائل CONNECT الناتجة عن أجهزة المودم المتوافقة مع Hayes(tm).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
لا يقطع الاتصال اختيارياً عندما يُعطى خطاً مفتوحاً بالفعل (مفيد لتطبيقات إعادة الاتصال).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
لا يعرض اختيارياً محتويات ملف \fI/etc/issue\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يعرض اختيارياً ملفات أو أدلة إصدار بديلة بدلاً من \fI/etc/issue\fP أو \fI/etc/issue.d\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
لا يطلب اسم ولوج اختيارياً.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يستدعي اختيارياً برنامج ولوج غير قياسي بدلاً من \fI/bin/login\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يشغل اختيارياً التحكم في التدفق للعتاد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
يفرض اختيارياً أن يكون الخط محلياً دون الحاجة إلى كشف الحامل (carrier detect).
.RE
.sp
لا يستخدم هذا البرنامج ملفات \fI/etc/gettydefs\fP (System V) أو \fI/etc/gettytab\fP (SunOS 4).
.SH "المعطيات"
.sp
\fIمنفذ\fP
.RS 4
مسار نسبي إلى دليل \fI/dev\fP. إذا حُددت العلامة "\-"، يفترض \fBagetty\fP أن دخله القياسي متصل بالفعل بمنفذ tty وأن الاتصال بمستخدم عن بعد قد أُنشئ بالفعل.
.sp
تحت System V، يجب أن تُسبق وسيطة \fIمنفذ\fP ذات القيمة "\-" بالعلامة "\-\-".
.RE
.sp
\fIbaud_rate\fP,.\|.\|.
.RS 4
قائمة مفصولة بفواصل لمعدل بود واحد أو أكثر. في كل مرة يتلقى فيها \fBagetty\fP محرف BREAK، فإنه يتقدم عبر القائمة، التي تُعامل على أنها دائرية.
.sp
ينبغي تحديد معدلات البود بترتيب تنازلي، بحيث يمكن استخدام محرف null ‏(Ctrl\-@) أيضاً لتبديل معدل البود.
.sp
هذه الوسيطة اختيارية وغير ضرورية لمحطات الطرفية الافتراضية (\fBvirtual terminals\fP).
.sp
القيمة المبدئية للمحطات الطرفية التسلسلية (\fBserial terminals\fP) هي الإبقاء على معدل البود الحالي (انظر \fB\-\-keep\-baud\fP) وإذا لم ينجح ذلك، تُستخدم القيمة المبدئية \*(Aq9600\*(Aq.
.RE
.sp
\fIterm\fP
.RS 4
القيمة التي ستُستخدم لمتغير البيئة \fBTERM\fP. يتخطى هذا أي قيمة قد ضبطها \fBinit\fP(1)، وتورثها عملية الولوج والصدفة.
.sp
القيمة المبدئية هي \*(Aqvt100\*(Aq، أو \*(Aqlinux\*(Aq لنظام لينكس على محطة طرفية افتراضية، أو \*(Aqhurd\*(Aq لنظام GNU Hurd على محطة طرفية افتراضية.
.RE
.SH "الخيارات"
.sp
\fB\-8\fP، \fB\-\-8bits\fP
.RS 4
افترض أن tty نظيفة من فئة 8 بت، ومن ثم عطل كشف التماثل.
.RE
.sp
\fB\-a\fP، \fB\-\-autologin\fP \fIاسم_مستخدم\fP
.RS 4
أجرِ عملية ولوج آلي للمستخدم المحدد دون طلب اسم المستخدم أو كلمة السر. يؤدي استخدام هذا الخيار إلى إضافة خيار ووسيطة \fB\-f\fP \fIاسم_مستخدم\fP إلى سطر أوامر \fB/bin/login\fP. انظر \fB\-\-login\-options\fP، التي يمكن استخدامها لتعديل سلوك هذا الخيار.
.sp
لاحظ أن \fB\-\-autologin\fP قد يؤثر على الطريقة التي يهيئ بها \fBgetty\fP الخط التسلسلي، لأنه عند الولوج الآلي لا يقرأ \fBagetty\fP من الخط وليس لديه فرصة لتحسين إعدادات الخط.
.RE
.sp
\fB\-c\fP، \fB\-\-noreset\fP
.RS 4
لا تُعد ضبط cflags (أوضاع التحكم) للمحطة الطرفية. راجع \fBtermios\fP(3) لمزيد من التفاصيل.
.RE
.sp
\fB\-E\fP، \fB\-\-remote\fP
.RS 4
عادةً ما يُعطى الأمر \fBlogin\fP(1) اسم مضيف بعيد عند استدعائه بواسطة شيء مثل \fBtelnetd\fP(8). يسمح هذا الخيار لـ \fBagetty\fP بتمرير ما يستخدمه كاسم مضيف إلى \fBlogin\fP(1) لاستخدامه في \fButmp\fP(5). انظر \fB\-\-host\fP، و \fBlogin\fP(1)، و \fButmp\fP(5).
.sp
إذا أُعطي الخيار \fB\-\-host\fP \fIfakehost\fP، فسيُضاف خيار ووسيطة \fB\-h\fP \fIfakehost\fP إلى سطر أوامر \fI/bin/login\fP.
.sp
إذا أُعطي الخيار \fB\-\-nohostname\fP، فسيُضاف خيار \fB\-H\fP إلى سطر أوامر \fB/bin/login\fP.
.sp
انظر \fB\-\-login\-options\fP.
.RE
.sp
\fB\-f\fP، \fB\-\-issue\-file\fP \fIمسار\fP
.RS 4
يحدد قائمة ملفات وأدلة مفصولة بـ ":" ليتم عرضها بدلاً من \fI/etc/issue\fP (أو غيره). تُعرض جميع الملفات والأدلة المحددة، وتُتجاهل الملفات المفقودة أو الفارغة بصمت. إذا كان المسار المحدد دليلاً، فسيتم عرض جميع الملفات التي تحمل الامتداد \fI.issue\fP بترتيب فرز الإصدارات من الدليل. يسمح هذا بعرض رسائل مخصصة على محطات طرفية مختلفة. سيتخطى الخيار \fB\-\-noissue\fP هذا الخيار.
.RE
.sp
\fB\-\-show\-issue\fP
.RS 4
أعرِض ملف الإصدار (issue) الحالي (أو غيره) على المحطة الطرفية الحالية واخرج. استخدم هذا الخيار لمراجعة الإعداد الحالي، وهو ليس مصمماً لأي غرض آخر. لاحظ أن المخرج قد يستخدم بعض المعلومات المبدئية أو غير المكتملة لأن المخرج السليم يعتمد على المحطة الطرفية وسطر أوامر \fBagetty\fP.
.RE
.sp
\fB\-h, \-\-flow\-control\fP
.RS 4
فعّل التحكم في التدفق عبر العتاد (RTS/CTS). يُترك للتطبيق تعطيل ميفاق التدفق البرمجي (XON/XOFF) عند الاقتضاء.
.RE
.sp
\fB\-H\fP، \fB\-\-host\fP \fIfakehost\fP
.RS 4
اكتب \fIfakehost\fP المحدد في ملف utmp. عادةً، لا يُعطى مضيف ولوج، بما أن \fBagetty\fP يُستخدم للاتصالات المحلية السلكية والوحدات الطرفية. ومع ذلك، قد يكون هذا الخيار مفيداً لتحديد مجمعات المحطات الطرفية وما شابه ذلك.
.RE
.sp
\fB\-i\fP، \fB\-\-noissue\fP
.RS 4
لا تعرض محتويات \fI/etc/issue\fP (أو غيره) قبل كتابة حث الولوج. قد ترتبك المحطات الطرفية أو عتاد الاتصالات عند تلقي الكثير من النصوص بمعدل بود خاطئ؛ وقد تفشل سكربتات الاتصال الهاتفي إذا سبق حث الولوج نص طويل جداً.
.RE
.sp
\fB\-I\fP، \fB\-\-init\-string\fP \fIinitstring\fP
.RS 4
اضبط سلسلة نصية أولية ليتم إرسالها إلى tty أو المودم قبل إرسال أي شيء آخر. قد يُستخدم هذا لتهيئة المودم. يمكن إرسال المحارف غير القابلة للطباعة عن طريق كتابة ترميزها الثماني مسبوقاً بشرطة مائلة عكسية (\(rs). على سبيل المثال، لإرسال محرف تغذية السطر (ASCII 10، الثماني 012)، اكتب \(rs12.
.RE
.sp
\fB\-J\fP، \fB\-\-noclear\fP
.RS 4
لا تمسح الشاشة قبل الحث على اسم الولوج. تُمسح الشاشة بشكل مبدئي.
.RE
.sp
\fB\-l\fP، \fB\-\-login\-program\fP \fIlogin_program\fP
.RS 4
استدعِ \fIlogin_program\fP المحدد بدلاً من /bin/login. يسمح هذا باستخدام برنامج ولوج غير قياسي. يمكن لمثل هذا البرنامج، على سبيل المثال، طلب كلمة مرور للاتصال الهاتفي أو استخدام ملف كلمات مرور مختلف. انظر \fB\-\-login\-options\fP.
.RE
.sp
\fB\-L\fP، \fB\-\-local\-line\fP[\fB=\fP\fIوضع\fP]
.RS 4
التحكم في علم الخط CLOCAL. وسيط \fIوضع\fP الاختياري هو \fBauto\fP أو \fBalways\fP أو \fBnever\fP. إذا أُغفل وسيط \fIوضع\fP، فإن القيمة المبدئية هي \fBalways\fP. إذا لم يُحدد خيار \fB\-\-local\-line\fP إطلاقاً، فإن القيمة المبدئية هي \fBauto\fP.
.sp
\fIalways\fP
.RS 4
فرض كون الخط محلياً دون الحاجة إلى كشف الحامل. قد يكون هذا مفيداً عندما يكون لديك طرفية متصلة محلياً حيث لا يقوم الخط التسلسلي بضبط إشارة كشف الحامل.
.RE
.sp
\fInever\fP
.RS 4
مسح علم CLOCAL صراحةً من إعداد الخط ويُتوقع وجود إشارة كشف الحامل على الخط.
.RE
.sp
\fIauto\fP
.RS 4
الوضع المبدئي لبرنامج \fBagetty\fP. لا يُعدل إعداد CLOCAL ويتبع الإعداد المُفعل من قِبل نواة النظام.
.RE
.RE
.sp
\fB\-m\fP، \fB\-\-extract\-baud\fP
.RS 4
محاولة استخراج معدل البود (baud rate) من رسالة حالة CONNECT الناتجة عن أجهزة المودم المتوافقة مع Hayes(tm). تكون رسائل الحالة هذه على الشكل: "<junk><speed><junk>". يفترض \fBagetty\fP أن المودم يرسل رسالة حالته بنفس السرعة المحددة في قيمة \fIbaud_rate\fP (الأولى) على سطر الأوامر.
.sp
بما أن ميزة \fB\-\-extract\-baud\fP قد تفشل في الأنظمة ذات الحمل العالي، فلا يزال يتعين عليك تفعيل معالجة BREAK عبر سرد جميع معدلات البود المتوقعة على سطر الأوامر.
.RE
.sp
\fB\-\-list\-speeds\fP
.RS 4
أعرِض معدلات بود المتاحة. تُحدد هذه المعدلات وقت التجميع.
.RE
.sp
\fB\-n\fP، \fB\-\-skip\-login\fP
.RS 4
عدم مطالبة المستخدم باسم ولوج. يمكن استخدام هذا بالتزامن مع خيار \fB\-\-login\-program\fP لاستدعاء عملية ولوج غير قياسية مثل نظام BBS. لاحظ أنه مع خيار \fB\-\-skip\-login\fP، لا يتلقى \fBagetty\fP أي مدخلات من المستخدم الذي يلج وبالتالي لن يتمكن من معرفة التماثل، وحجم المحارف، ومعالجة السطر الجديد للاتصال. يضبط مبدئياً على التماثل الفراغي، ومحارف 7 بت، ومحرف نهاية السطر ASCII CR (13). احذر من أن البرنامج الذي يبدأه \fBagetty\fP (عادةً /bin/login) يُشغل كجذر (root).
.RE
.sp
\fB\-N\fP، \fB\-\-nonewline\fP
.RS 4
عدم طباعة سطر جديد قبل كتابة \fI/etc/issue\fP.
.RE
.sp
\fB\-o\fP، \fB\-\-login\-options\fP \fIخيارات_الولوج\fP
.RS 4
الخيارات والوسائط التي تُمرر إلى \fBlogin\fP(1). حيث تُستبدل \(rsu باسم الولوج. على سبيل المثال:
.sp
\fB\-\-login\-options \*(Aq\-h darkstar \-\- \(rsu\*(Aq\fP
.sp
انظر \fB\-\-autologin\fP و \fB\-\-login\-program\fP و \fB\-\-remote\fP.
.sp
يرجى قراءة \fBإشعار الأمان\fP أدناه قبل استخدام هذا الخيار.
.RE
.sp
\fB\-p\fP، \fB\-\-login\-pause\fP
.RS 4
الانتظار للضغط على أي مفتاح قبل الانتقال إلى محث الولوج. يمكن دمجه مع \fB\-\-autologin\fP لتوفير الذاكرة عبر إطلاق الأصداف بكسل (lazily spawning).
.RE
.sp
\fB\-r\fP، \fB\-\-chroot\fP \fIدليل\fP
.RS 4
غيّر الجذر (chroot) إلى الدليل المحدد.
.RE
.sp
\fB\-R\fP، \fB\-\-hangup\fP
.RS 4
استدعاء \fBvhangup\fP(2) لإجراء قطع اتصال افتراضي للطرفية المحددة.
.RE
.sp
\fB\-s\fP، \fB\-\-keep\-baud\fP
.RS 4
محاولة الحفاظ على معدل البود الحالي. تُستخدم معدلات البود من سطر الأوامر عندما يتلقى \fBagetty\fP محرف BREAK. في حال تحديد معدلات بود أخرى، يُحفظ معدل البود الأصلي أيضاً في نهاية قائمة معدلات البود المطلوبة. يمكن استخدام هذا للعودة إلى معدل البود الأصلي بعد إشارات BREAK غير المتوقعة.
.RE
.sp
\fB\-t\fP، \fB\-\-timeout\fP \fIمهلة\fP
.RS 4
الإنهاء إذا تعذر قراءة اسم المستخدم خلال \fIمهلة\fP من الثواني. لا يُنصح باستخدام هذا الخيار مع خطوط الطرفيات السلكية.
.RE
.sp
\fB\-U\fP، \fB\-\-detect\-case\fP
.RS 4
تفعيل دعم كشف الطرفيات التي تدعم الأحرف الكبيرة فقط. سيقوم هذا الإعداد بكشف اسم الولوج الذي يحتوي على أحرف كبيرة فقط كإشارة إلى طرفية تدعم الأحرف الكبيرة فقط، ويُفعل بعض تحويلات الأحرف من كبيرة إلى صغيرة. لاحظ أن هذا لا يدعم أي محارف يونيكود (Unicode).
.RE
.sp
\fB\-w\fP، \fB\-\-wait\-cr\fP
.RS 4
الانتظار حتى يرسل المستخدم أو المودم محرف رجوع العربة أو تغذية السطر قبل إرسال ملف \fI/etc/issue\fP (أو غيره) ومحث الولوج. هذا مفيد مع خيار \fB\-\-init\-string\fP.
.RE
.sp
\fB\-\-nohints\fP
.RS 4
عدم طباعة تلميحات حول أقفال Num و Caps و Scroll.
.RE
.sp
\fB\-\-nohostname\fP
.RS 4
يُطبع اسم المضيف مبدئياً. عند تفعيل هذا الخيار، لن يُعرض أي اسم مضيف على الإطلاق. يمكن أيضاً تفعيل هذا الإعداد عبر خيار LOGIN_PLAIN_PROMPT في ملف ضبط \fI/etc/login.defs\fP (انظر أدناه لمزيد من التفاصيل).
.RE
.sp
\fB\-\-long\-hostname\fP
.RS 4
بشكل مبدئي، يُطبع اسم المضيف فقط حتى النقطة الأولى. مع تفعيل هذا الخيار، يُعرض اسم المضيف المؤهل بالكامل بواسطة \fBgethostname\fP(3P) أو (إذا لم يُعثر عليه) بواسطة \fBgetaddrinfo\fP(3).
.RE
.sp
\fB\-\-erase\-chars\fP \fIسلسلة_محارف\fP
.RS 4
يحدد هذا الخيار محارف إضافية ينبغي تفسيرها على أنها مسافة للخلف ("تجاهل المحرف السابق") عندما يكتب المستخدم اسم الولوج. كان محرف \*(Aqالمسح\*(Aq الإضافي المبدئي هو \*(Aq#\*(Aq، ولكن منذ util\-linux 2.23 لم تُفعل أي محارف مسح إضافية بشكل مبدئي.
.RE
.sp
\fB\-\-kill\-chars\fP \fIسلسلة_محارف\fP
.RS 4
يحدد هذا الخيار محارف إضافية ينبغي تفسيرها على أنها إلغاء ("تجاهل جميع المحارف السابقة") عندما يكتب المستخدم اسم الولوج. كان محرف \*(Aqالإلغاء\*(Aq الإضافي المبدئي هو \*(Aq@\*(Aq، ولكن منذ util\-linux 2.23 لم تُفعل أي محارف إلغاء إضافية بشكل مبدئي.
.RE
.sp
\fB\-\-chdir\fP \fIدليل\fP
.RS 4
غير الدليل قبل الولوج.
.RE
.sp
\fB\-\-delay\fP \fIرقم\fP
.RS 4
نَم لعدد من الثواني قبل فتح tty.
.RE
.sp
\fB\-\-nice\fP \fIرقم\fP
.RS 4
شغّل الولوج بهذه الأولوية.
.RE
.sp
\fB\-\-reload\fP
.RS 4
اطلب من جميع نماذج \fBagetty\fP القيد التشغيل إعادة التحميل وتحديث محثاتها المعروضة، إذا لم يبدأ المستخدم بالولوج بعد. سيخرج الأمر بعد القيام بذلك. قد تكون هذه الميزة غير متاحة في الأنظمة التي لا تتوفر فيها لينكس \fBinotify\fP(7).
.RE
.sp
\fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "عناصر ملف الضبط"
.sp
يقرأ \fBagetty\fP ملف ضبط \fI/etc/login.defs\fP (راجع \fBlogin.defs\fP(5)). لاحظ أن ملف الضبط قد يُوزع مع حزمة أخرى (عادة shadow\-utils). عناصر الضبط التالية ذات صلة بـ \fBagetty\fP:
.sp
\fBLOGIN_PLAIN_PROMPT\fP (boolean)
.RS 4
أخبر \fBagetty\fP بوجوب كتم طباعة اسم المضيف في محث login:. هذا بديل لخيار سطر الأوامر \fB\-\-nohostname\fP. القيمة المبدئية هي \fIno\fP.
.RE
.SH "مثال"
.sp
يعرض هذا القسم أمثلة لحقل العملية لإدخالة في ملف \fI/etc/inittab\fP. سيتعين عليك إضافة قيم مناسبة في مقدمة الحقول الأخرى. راجع \fBinittab\fP(5) لمزيد من التفاصيل.
.sp
لخط سلكي أو tty كونسول:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty 9600 ttyS1\fP
.br
.RE
.ll
.sp
لطرفية متصلة مباشرة دون تمديدات مناسبة لكشف الحامل (جرب هذا إذا كانت طرفيتك تخمل بدلاً من إعطائك محث كلمة السر:):
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-local\-line 9600 ttyS1 vt100\fP
.br
.RE
.ll
.sp
لخط اتصال هاتفي قديم الطراز مع مودم بمعدل بود 9600/2400/1200:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-extract\-baud \-\-timeout 60 ttyS1 9600,2400,1200\fP
.br
.RE
.ll
.sp
لمودم Hayes بواجهة ثابتة بسرعة 115200 بت في الثانية للحاسوب (سلسلة التهيئة في المثال توقف صدى المودم ورموز النتائج، وتجعل DCD المودم/الحاسوب يتتبع DCD المودم/المودم، وتجعل هبوط DTR يسبب فصلاً، وتشغل الرد الآلي بعد رنة واحدة):
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-wait\-cr \-\-init\-string \*(AqATE0Q1&D2&C1S0=1\(rs015\*(Aq 115200 ttyS1\fP
.br
.RE
.ll
.SH "ملاحظة أمنية"
.sp
إذا استخدمت خياري \fB\-\-login\-program\fP و \fB\-\-login\-options\fP، فكن على دراية بأن مستخدماً خبيثاً قد يحاول إدخال أسماء ولوج تحتوي على خيارات مضمنة، تُمرر لاحقاً لبرنامج الولوج المستخدم. يفحص \fBagetty\fP وجود شرطة "\-" بادئة ويضمن تمرير اسم الولوج كمعلمة واحدة (لذا فإن المسافات المضمنة لن تنشئ معلمة أخرى)، ولكن اعتماداً على كيفية تحليل ثنائي الولوج لسطر الأوامر، فقد لا يكون ذلك كافياً. تحقق من عدم إمكانية إساءة استخدام برنامج الولوج المستخدم بهذه الطريقة.
.sp
تستخدم بعض البرامج "\-\-" للإشارة إلى أن بقية سطر الأوامر يجب ألا تُفسر كخيارات. استخدم هذه الميزة إن توفرت بتمرير "\-\-" قبل تمرير اسم المستخدم بواسطة \(rsu.
.SH "ملفات الإصدار (ISSUE FILES)"
.sp
ملف الإصدار المبدئي هو \fI/etc/issue\fP. إذا كان الملف موجوداً، يفحص \fBagetty\fP أيضاً دليل \fI/etc/issue.d\fP. يعد الدليل امتداداً اختيارياً لملف الإصدار المبدئي وتُطبع محتويات الدليل بعد محتوى \fI/etc/issue\fP. إذا كان \fI/etc/issue\fP غير موجود، يُتجاهل الدليل. جميع الملفات \fBذات الامتداد .issue\fP في الدليل تُطبع بترتيب فرز الإصدارات. يمكن استخدام الدليل لصيانة رسائل الأطراف الثالثة بشكل مستقل عن ملف \fI/etc/issue\fP الأساسي للنظام.
.sp
منذ الإصدار 2.35، دُعمت مواقع إضافية لملف ودليل الإصدار. يفحص \fBagetty\fP ملفات \fI/run/issue\fP و \fI/run/issue.d\fP، ثم \fI/usr/lib/issue\fP و \fI/usr/lib/issue.d\fP. الدليل \fI/etc\fP متوقع لضبط المضيف المحدد، و \fI/run\fP متوقع للمحتوى الموَلّد، و \fI/usr/lib\fP يُستخدم للضبط الساكن الذي تصونه التوزيعة.
.sp
لاحظ أنه في الإصدارات من 2.35 إلى 2.40، كانت المواقع الإضافية تُقرأ فقط إذا لم يكن ملف \fI/etc/issue\fP المبدئي موجوداً. ومع ذلك، منذ الإصدار 2.41، تُقرأ المواقع الإضافية دائماً، بغض النظر عن وجود ملف \fI/etc/issue\fP. يسمح هذا التغيير بتوليد ملفات الإصدار بشكل مبدئي.
.sp
يمكن تخطي المسارات المبدئية بالكامل باستخدام خيار \fB\-\-issue\-file\fP. في هذه الحالة يجب أن يكون المسار المحدد ملفاً أو دليلاً وتُتجاهل جميع مواقع ملفات وأدلة الإصدار (issue) المبدئية.
.sp
يمكن تعطيل ميزة ملف الإصدار بالكامل باستخدام خيار \fB\-\-noissue\fP.
.sp
من الممكن مراجعة ملف الإصدار الحالي عبر \fBagetty \-\-show\-issue\fP على الطرفية الحالية.
.sp
قد تحتوي ملفات الإصدار على رموز هروب معينة لعرض اسم النظام، والتاريخ، والوقت وما إلى ذلك. تتكون جميع رموز الهروب من شرطة مائلة خلفية (\(rs) متبوعة مباشرة بأحد المحارف المدرجة أدناه.
.sp
4 أو 4{\fIinterface\fP}
.RS 4
أدرج عنوان IPv4 لواجهة الشبكة المحددة (مثلاً: \(rs4{eth0}). إذا لم يُحدد وسيط \fIinterface\fP، فستُختار أول واجهة مضبوطة بالكامل (UP، و non\-LOCALBACK، و RUNNING). إذا لم يُعثر على واجهة مضبوطة، فسيتم الرجوع لعنوان IP الخاص باسم مضيف الحاسوب.
.RE
.sp
6 أو 6{\fIinterface\fP}
.RS 4
مثل \(rs4 تماماً ولكن لميفاق IPv6.
.RE
.sp
a
.RS 4
أدرج قائمة بعناوين IP "الجيدة" لكافة الواجهات. يطبع أفضل العناوين المرشحة للوصول عن بعد: العناوين العامة والمحلية؛ وإذا لم تتوفر، العنوان المؤقت ذو أطول عمر، وإذا لم يتوفر، عنوان الرابط (link address). لاحظ أن عناوين الرابط تُطبع مع اسم الواجهة المحلية، ولكن يجب أن يتم ذلك مع اسم الواجهة على الجهاز الذي ستُستخدم عليه.
.RE
.sp
A
.RS 4
أدرج قائمة بكافة عناوين IP لجميع الواجهات.
.RE
.sp
b
.RS 4
إدراج معدل البود للخط الحالي.
.RE
.sp
d
.RS 4
أدرج التاريخ الحالي.
.RE
.sp
e أو e{\fIاسم\fP}
.RS 4
ترجمة \fIاسم\fP المقروء بشرياً إلى تسلسل هروب وإدراجه (على سبيل المثال: \(rse{red}نص تنبيه.\(rse{reset}). إذا لم يُحدد وسيط \fIاسم\fP، فسيتم إدراج \(rs033. الأسماء المتاحة حالياً هي: black و blink و blue و bold و brown و cyan و darkgray و gray و green و halfbright و lightblue و lightcyan و lightgray و lightgreen و lightmagenta و lightred و magenta و red و reset و reverse و yellow و white. تُتجاهل جميع الأسماء المجهولة بصمت.
.RE
.sp
s
.RS 4
إدراج اسم النظام (اسم نظام التشغيل). مماثل لـ \*(Aquname \-s\*(Aq. انظر أيضاً رمز الهروب \(rsS.
.RE
.sp
S or S{VARIABLE}
.RS 4
إدراج بيانات VARIABLE من \fI/etc/os\-release\fP. إذا لم يكن هذا الملف موجوداً، فسيتم الرجوع إلى \fI/usr/lib/os\-release\fP. إذا لم يُحدد وسيط VARIABLE، فسيتم استخدام PRETTY_NAME من الملف أو اسم النظام (انظر \(rss). يمكن استخدام رمز الهروب هذا لإبقاء \fI/etc/issue\fP مستقلاً عن التوزيعة والإصدار. لاحظ أن \(rsS{ANSI_COLOR} يُحوّل إلى تسلسل هروب الطرفية الحقيقي.
.RE
.sp
l
.RS 4
أدرج اسم خط tty الحالي.
.RE
.sp
m
.RS 4
إدراج معرف معمارية الآلة. مماثل لـ \fBuname \-m\fP.
.RE
.sp
n
.RS 4
إدراج اسم عقدة الآلة، المعروف أيضاً باسم المضيف (hostname). مماثل لـ \fBuname \-n\fP.
.RE
.sp
o
.RS 4
إدراج اسم نطاق NIS للآلة. مماثل لـ \fBhostname \-d\fP.
.RE
.sp
O
.RS 4
أدرج اسم نطاق DNS للحاسوب.
.RE
.sp
r
.RS 4
إدراج رقم إصدار نظام التشغيل. مماثل لـ \fBuname \-r\fP.
.RE
.sp
t
.RS 4
أدرج الوقت الحالي.
.RE
.sp
u
.RS 4
أدرج عدد المستخدمين الحاليين الولوجين.
.RE
.sp
U
.RS 4
أدرج السلسلة "1 user" أو "<n> users" حيث <n> هو عدد المستخدمين الولوجين حالياً.
.RE
.sp
v
.RS 4
أدرج إصدارة نظام التشغيل، أي تاريخ البناء وما شابه.
.RE
.sp
مثال. على نظامي، ملف \fI/etc/issue\fP التالي:
.sp
.if n .RS 4
.nf
.fam C
هذا هو \(rsn.\(rso (\(rss \(rsm \(rsr) \(rst
.fam
.fi
.if n .RE
.sp
يُعرض كالتالي:
.sp
.if n .RS 4
.nf
.fam C
This is thingol.orcan.dk (لينكس i386 1.1.9) 18:29:30
.fam
.fi
.if n .RE
.SH "الملفات"
.sp
\fI/var/run/utmp\fP
.RS 4
ملف حالة النظام.
.RE
.sp
\fI/etc/issue\fP
.RS 4
يُطبع قبل محث الولوج.
.RE
.sp
\fI/etc/os\-release /usr/lib/os\-release\fP
.RS 4
بيانات تعريف نظام التشغيل.
.RE
.sp
\fI/dev/console\fP
.RS 4
تقارير المشكلات (إذا لم يُستخدم \fBsyslog\fP(3)).
.RE
.sp
\fI/etc/inittab\fP
.RS 4
ملف ضبط \fBinit\fP(8) لعفريت init بنمط SysV.
.RE
.SH "بيانات الاعتماد"
.sp
يدعم \fBagetty\fP الضبط عبر بيانات استيثاق systemd (راجع \c
.URL "https://systemd.io/CREDENTIALS/" "" ")."
يقرأ \fBagetty\fP بيانات استيثاق systemd التالية:
.sp
\fBagetty.autologin\fP (سلسلة)
.RS 4
إذا ضُبط، فإنه يضبط \fBagetty\fP ليقوم بـ ولوج آلي للمستخدم المحدد دون طلب اسم مستخدم أو كلمة سر، على غرار خيار \fB\-\-autologin\fP.
.RE
.SH "العلل"
.sp
تتطلب ميزة كشف معدل البود (خيار \fB\-\-extract\-baud\fP) جدولة \fBagetty\fP في وقت قريب كافٍ بعد اكتمال مكالمة اتصال هاتفي (خلال 30 ملي ثانية مع أجهزة المودم التي تتحدث بسرعة 2400 بود). من أجل المتانة، استخدم دائماً خيار \fB\-\-extract\-baud\fP مقترناً بوسطاء سطر الأوامر لمعدلات بود متعددة، لتمكين معالجة BREAK.
.sp
النص في ملف \fI/etc/issue\fP (أو غيره) ومحث الولوج يتم إخراجهم دائماً بمحارف 7\-بت وتكافؤ مسافة.
.sp
تتطلب ميزة كشف معدل البود (خيار \fB\-\-extract\-baud\fP) أن يرسل المودم رسالة حالته \fIبعد\fP رفع خط DCD.
.SH "التشخيص"
.sp
بناءً على كيفية ضبط البرنامج، تُكتب جميع التشخيصات إلى جهاز الطرفية أو يُبلغ عنها عبر مرفق \fBsyslog\fP(3). تُنتج رسائل الخطأ إذا لم يحدد معطى \fIمنفذ\fP جهاز طرفية؛ أو إذا لم يوجد إدخال utmp للعملية الحالية (في System V فقط)؛ وهكذا.
.SH "المؤلفين"
.sp
.MTO "werner\(atsuse.de" "Werner Fink" "،"
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
كُتب برنامج \fBagetty\fP الأصلي للطرفيات التسلسلية بواسطة \c
.MTO "wietse\(atwzv.win.tue.nl" "W.Z. Venema" ""
ونُقل إلى لينكس بواسطة
.MTO "poe\(atdaimi.aau.dk" "Peter Orbaek" "."
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBagetty\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."