'\" t
.\"     Title: agetty
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "AGETTY" "8" "2026-06-16" "util\-linux 2.41.5" "System Administration"
.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 "نام (NAME)"
agetty \- برنامه مدیریت خطوط tty و باز کردن نشست ورود به سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBagetty\fP [options] \fIport\fP [\fIbaud_rate\fP.\|.\|.] [\fIterm\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBagetty\fP یک درگاه tty را باز می‌کند، نام کاربری ورود را درخواست کرده و دستور /bin/login را فراخوانی می‌کند. این برنامه معمولاً توسط \fBinit\fP(8) اجرا می‌شود.
.sp
دستور \fBagetty\fP چندین ویژگی \fIغیر استاندارد\fP دارد که برای خطوط اتصال مستقیم فیزیکی و خطوط تلفنی (dial\-in) مفید هستند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
تنظیمات tty را هنگام خواندن نام کاربری با بیت‌های پاریتی، نویسه‌های پاک‌کردن (erase)، حذف خط (kill)، پایان خط (end\-of\-line) و حروف بزرگ تطبیق می‌دهد. این برنامه می‌تواند نویسه‌های ۷ بیتی با پاریتی زوج، فرد، بدون پاریتی یا پاریتی فاصله (space) و همچنین نویسه‌های ۸ بیتی بدون پاریتی را مدیریت کند. نویسه‌های کنترلی ویژه زیر شناسایی می‌شوند: 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
.\}
به‌طور اختیاری نرخ باود (baud rate) را از پیام‌های CONNECT صادرشده توسط مودم‌های سازگار با Hayes(tm) استخراج و تعیین می‌کند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
به‌طور اختیاری هنگام مواجهه با یک خط از قبل باز شده، ارتباط را قطع نمی‌کند (مفید برای برنامه‌های تماس مجدد یا call\-back).
.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
.\}
به‌طور اختیاری فایل‌ها یا دایرکتوری‌های issue جایگزین را به جای \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
.\}
به‌طور اختیاری کنترل جریان سخت‌افزاری (hardware flow control) را فعال می‌کند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
به‌طور اختیاری خط را بدون نیاز به سیگنال تشخیص حامل (carrier detect) به حالت محلی (local) مجبور می‌کند.
.RE
.sp
این برنامه از فایل‌های \fI/etc/gettydefs\fP (مربوط به System V) یا \fI/etc/gettytab\fP (مربوط به SunOS 4) استفاده نمی‌کند.
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
\fIport\fP
.RS 4
یک مسیر نسبی نسبت به دایرکتوری \fI/dev\fP. اگر "\-" مشخص شود، \fBagetty\fP فرض می‌کند که ورودی استاندارد آن از قبل به یک درگاه tty متصل است و ارتباط با کاربر راه دور برقرار شده است.
.sp
در System V، آرگومان \fIport\fP به‌صورت "\-" باید با یک "\-\-" همراه باشد.
.RE
.sp
\fIbaud_rate\fP,.\|.\|.
.RS 4
فهرستی جداشده با کاما از یک یا چند نرخ باود. هر بار که \fBagetty\fP یک نویسه BREAK دریافت می‌کند، به مقدار بعدی در این فهرست که به‌صورت چرخشی در نظر گرفته می‌شود می‌رود.
.sp
نرخ‌های باود باید به ترتیب نزولی مشخص شوند تا از نویسه null (یا Ctrl\-@) نیز بتوان برای جابه‌جایی نرخ باود استفاده کرد.
.sp
این آرگومان برای \fBپایانه‌های مجازی (virtual terminals)\fP اختیاری و غیرضروری است.
.sp
مقدار پیش‌فرض برای \fBپایانه‌های سریالی (serial terminals)\fP حفظ نرخ باود فعلی است (به \fB\-\-keep\-baud\fP مراجعه کنید) و در صورت ناموفق بودن، به مقدار پیش‌فرض \*(Aq9600\*(Aq بازمی‌گردد.
.RE
.sp
\fIterm\fP
.RS 4
مقداری که باید برای متغیر محیطی \fBTERM\fP استفاده شود. این مقدار هر تنظیمی که ممکن است توسط \fBinit\fP(1) اعمال شده باشد را لغو می‌کند و توسط login و پوسته به ارث برده می‌شود.
.sp
مقدار پیش‌فرض \*(Aqvt100\*(Aq است، یا برای لینوکس در پایانه مجازی \*(Aqlinux\*(Aq، و برای GNU Hurd در پایانه مجازی \*(Aqhurd\*(Aq است.
.RE
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-8\fP, \fB\-\-8bits\fP
.RS 4
فرض می‌کند پایانه tty هشت بیتی تمیز (8\-bit clean) است، بنابراین تشخیص پاریتی را غیرفعال می‌کند.
.RE
.sp
\fB\-a\fP, \fB\-\-autologin\fP \fIusername\fP
.RS 4
کاربر مشخص‌شده را به‌طور خودکار بدون درخواست نام کاربری یا گذرواژه وارد سیستم می‌کند. استفاده از این گزینه باعث اضافه شدن گزینه و آرگومان \fB\-f\fP \fIusername\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 یا control modes) را بازنشانی نمی‌کند. برای جزئیات بیشتر به \fBtermios\fP(3) مراجعه کنید.
.RE
.sp
\fB\-E\fP, \fB\-\-remote\fP
.RS 4
به‌طور معمول دستور \fBlogin\fP(1) زمانی که توسط برنامه‌هایی مانند \fBtelnetd\fP(8) فراخوانی می‌شود، یک نام میزبان راه دور دریافت می‌کند. این گزینه به \fBagetty\fP اجازه می‌دهد مقداری را که به‌عنوان نام میزبان استفاده می‌کند برای درج در \fButmp\fP(5) به \fBlogin\fP(1) منتقل کند. به \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 \fIpath\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 برای اتصالات مستقیم محلی و کنسول‌ها استفاده می‌شود. با این حال، این گزینه می‌تواند برای شناسایی متمرکزکننده‌های پایانه (terminal concentrators) و موارد مشابه مفید باشد.
.RE
.sp
\fB\-i\fP, \fB\-\-noissue\fP
.RS 4
پیش از چاپ اعلان ورود، محتوای \fI/etc/issue\fP (یا موارد دیگر) را نمایش نمی‌دهد. پایانه‌ها یا سخت‌افزارهای ارتباطی ممکن است با دریافت متن‌های طولانی در نرخ باود اشتباه دچار اختلال شوند؛ همچنین اسکریپت‌های اتصال تلفنی (dial\-up) ممکن است در صورت طولانی بودن متن قبل از اعلان ورود، با شکست مواجه شوند.
.RE
.sp
\fB\-I\fP, \fB\-\-init\-string\fP \fIinitstring\fP
.RS 4
یک رشته اولیه را برای ارسال به tty یا مودم، پیش از ارسال هر چیز دیگری تعیین می‌کند. این گزینه می‌تواند برای مقداردهی اولیه مودم استفاده شود. نویسه‌های غیرقابل چاپ را می‌توان با نوشتن کد هشت‌هشتی (octal) آن‌ها با یک بک‌اسلش (\(rs) ارسال کرد. برای مثال، برای ارسال نویسه linefeed (کد اسکی ۱۰، هشت‌هشتی 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\fImode\fP]
.RS 4
پرچم خط CLOCAL را کنترل می‌کند. آرگومان اختیاری \fImode\fP می‌تواند \fBauto\fP، \fBalways\fP یا \fBnever\fP باشد. اگر آرگومان \fImode\fP حذف شود، مقدار پیش‌فرض \fBalways\fP است. اگر گزینه \fB\-\-local\-line\fP اصلاً مشخص نشود، مقدار پیش‌فرض \fBauto\fP خواهد بود.
.sp
\fIalways\fP
.RS 4
خط را وادار می‌کند که یک خط محلی باشد بدون نیاز به سیگنال تشخیص حامل (carrier detect). این حالت زمانی مفید است که یک پایانه متصل به‌صورت محلی دارید که در آن خط سریال سیگنال تشخیص حامل را تنظیم نمی‌کند.
.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
تلاش می‌کند تا نرخ باود را از پیام وضعیت 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 هیچ ورودی از کاربری که وارد می‌شود دریافت نمی‌کند و بنابراین قادر نخواهد بود پاریتی، اندازه نویسه و پردازش خط جدید اتصال را تشخیص دهد؛ در نتیجه به پاریتی فاصله (space)، نویسه‌های ۷ بیتی و نویسه پایان خط اسکی 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 \fIlogin_options\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نکات امنیتی (SECURITY NOTICE)\fP را در ادامه مطالعه کنید.
.RE
.sp
\fB\-p\fP, \fB\-\-login\-pause\fP
.RS 4
پیش از رفتن به اعلان ورود، منتظر فشرده شدن هر کلیدی می‌ماند. می‌توان آن را با \fB\-\-autologin\fP ترکیب کرد تا با ایجاد تنبل (lazy spawning) پوسته‌ها در مصرف حافظه صرفه‌جویی شود.
.RE
.sp
\fB\-r\fP, \fB\-\-chroot\fP \fIdirectory\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 \fItimeout\fP
.RS 4
اگر هیچ نام کاربری در عرض \fItimeout\fP ثانیه خوانده نشود، خاتمه می‌یابد. استفاده از این گزینه برای خطوط پایانه با اتصال مستقیم توصیه نمی‌شود.
.RE
.sp
\fB\-U\fP, \fB\-\-detect\-case\fP
.RS 4
پشتیبانی از تشخیص پایانه‌هایی که فقط دارای حروف بزرگ هستند را فعال می‌کند. این تنظیم، نام کاربری حاوی حروف تماماً بزرگ را به‌عنوان نشانه‌ای از پایانه فقط دارای حروف بزرگ شناسایی کرده و برخی تبدیل‌های حروف بزرگ به کوچک را فعال می‌کند. توجه داشته باشید که این قابلیت هیچ پشتیبانی از نویسه‌های یونیکد ندارد.
.RE
.sp
\fB\-w\fP, \fB\-\-wait\-cr\fP
.RS 4
پیش از ارسال فایل \fI/etc/issue\fP (یا سایر فایل‌ها) و اعلان ورود، منتظر می‌ماند تا کاربر یا مودم یک نویسه carriage\-return یا linefeed ارسال کند. این گزینه همراه با گزینه \fB\-\-init\-string\fP مفید است.
.RE
.sp
\fB\-\-nohints\fP
.RS 4
راهنماها و هشدارهای مربوط به کلیدهای Num Lock، Caps Lock و Scroll Lock را چاپ نمی‌کند.
.RE
.sp
\fB\-\-nohostname\fP
.RS 4
به‌طور پیش‌فرض نام میزبان چاپ می‌شود. با فعال بودن این گزینه، اصلاً نام میزبانی نمایش داده نخواهد شد. این تنظیم همچنین از طریق گزینه LOGIN_PLAIN_PROMPT در فایل پیکربندی \fI/etc/login.defs\fP قابل فعال‌سازی است (برای جزئیات بیشتر به ادامه مراجعه کنید).
.RE
.sp
\fB\-\-long\-hostname\fP
.RS 4
به‌طور پیش‌فرض نام میزبان تنها تا اولین نقطه چاپ می‌شود. با فعال بودن این گزینه، نام کامل میزبان (FQDN) از طریق \fBgethostname\fP(3P) یا (در صورت پیدا نشدن) از طریق \fBgetaddrinfo\fP(3) نمایش داده می‌شود.
.RE
.sp
\fB\-\-erase\-chars\fP \fIstring\fP
.RS 4
این گزینه نویسه‌های اضافه‌ای را مشخص می‌کند که هنگام وارد کردن نام کاربری توسط کاربر، باید به‌عنوان کلید پس‌بر (backspace یا «نادیده گرفتن نویسه قبلی») تفسیر شوند. مقدار پیش‌فرض قبلی برای نویسه حذف \*(Aq#\*(Aq بود، اما از نسخه util\-linux 2.23 هیچ نویسه حذف اضافی به‌طور پیش‌فرض فعال نیست.
.RE
.sp
\fB\-\-kill\-chars\fP \fIstring\fP
.RS 4
این گزینه نویسه‌های اضافه‌ای را مشخص می‌کند که هنگام تایپ نام کاربری توسط کاربر، باید به‌عنوان حذف کل خط (kill یا «نادیده گرفتن تمام نویسه‌های قبلی») تفسیر شوند. مقدار پیش‌فرض قبلی برای نویسه حذف خط \*(Aq@\*(Aq بود، اما از نسخه util\-linux 2.23 هیچ نویسه حذف خط اضافی به‌طور پیش‌فرض فعال نیست.
.RE
.sp
\fB\-\-chdir\fP \fIdirectory\fP
.RS 4
پیش از ورود به سیستم، دایرکتوری کاری را تغییر می‌دهد.
.RE
.sp
\fB\-\-delay\fP \fInumber\fP
.RS 4
تعداد ثانیه‌ای که باید قبل از باز کردن tty توقف کند (sleep).
.RE
.sp
\fB\-\-nice\fP \fInumber\fP
.RS 4
فرایند ورود را با این اولویت اولویت‌بندی (nice) اجرا می‌کند.
.RE
.sp
\fB\-\-reload\fP
.RS 4
از تمام نمونه‌های در حال اجرای \fBagetty\fP می‌خواهد در صورتی که کاربر هنوز شروع به ورود نکرده باشد، اعلان‌های نمایش‌داده‌شده خود را بازخوانی و به‌روزرسانی کنند. پس از انجام این کار، دستور خارج خواهد شد. این قابلیت ممکن است در سیستم‌های فاقد \fBinotify\fP(7) لینوکس پشتیبانی نشود.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "موارد فایل پیکربندی (CONFIG FILE ITEMS)"
.sp
دستور \fBagetty\fP فایل پیکربندی \fI/etc/login.defs\fP را می‌خواند (به \fBlogin.defs\fP(5) مراجعه کنید).
توجه داشته باشید که این فایل پیکربندی ممکن است همراه با بسته دیگری (معمولاً shadow\-utils) توزیع شده باشد.
موارد پیکربندی زیر برای \fBagetty\fP مرتبط هستند:
.sp
\fBLOGIN_PLAIN_PROMPT\fP (بولی)
.RS 4
به \fBagetty\fP اعلام می‌کند که چاپ نام میزبان در اعلان :login لغو شود. این یک جایگزین برای گزینه خط فرمان \fB\-\-nohostname\fP است. مقدار پیش‌فرض \fIno\fP است.
.RE
.SH "مثال (EXAMPLE)"
.sp
این بخش مثال‌هایی را برای فیلد process از یک مدخل در فایل \fI/etc/inittab\fP نشان می‌دهد. شما باید مقادیر مناسب را برای سایر فیلدها اضافه کنید. برای جزئیات بیشتر به \fBinittab\fP(5) مراجعه کنید.
.sp
برای یک خط اتصال مستقیم فیزیکی یا یک کنسول tty:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty 9600 ttyS1\fP
.br
.RE
.ll
.sp
برای یک پایانه متصل مستقیم بدون سیم‌کشی مناسب برای تشخیص حامل (اگر پایانه شما به جای نمایش اعلان password: به حالت تعلیق درمی‌آید، این را امتحان کنید):
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-local\-line 9600 ttyS1 vt100\fP
.br
.RE
.ll
.sp
برای یک خط تلفنی سنتی با یک مودم ۹۶۰۰/۲۴۰۰/۱۲۰۰ باود:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-extract\-baud \-\-timeout 60 ttyS1 9600,2400,1200\fP
.br
.RE
.ll
.sp
برای یک مودم Hayes با یک رابط ثابت ۱۱۵۲۰۰ بیت بر ثانیه به دستگاه (رشته مقداردهی اولیه در این مثال بازتاب مودم و کدهای نتیجه را غیرفعال می‌کند، سیگنال 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 "نکات امنیتی (SECURITY NOTICE)"
.sp
اگر از گزینه‌های \fB\-\-login\-program\fP و \fB\-\-login\-options\fP استفاده می‌کنید، توجه داشته باشید که ممکن است یک کاربر مخرب تلاش کند نام‌های کاربری همراه با گزینه‌های تعبیه‌شده وارد کند که سپس به برنامه ورود استفاده‌شده منتقل می‌شوند. \fBagetty\fP شروع شدن با "\-" را بررسی می‌کند و مطمئن می‌شود که نام کاربری به‌عنوان یک پارامتر منتقل شود (بنابراین فاصله‌های تعبیه‌شده پارامتر جدیدی ایجاد نمی‌کنند)، اما بسته به نحوه تجزیه خط فرمان توسط باینری login ممکن است این کار کافی نباشد. بررسی کنید که برنامه ورود استفاده‌شده نتواند به این روش مورد سوءاستفاده قرار گیرد.
.sp
برخی برنامه‌ها از "\-\-" استفاده می‌کنند تا مشخص کنند که بقیه خط فرمان نباید به‌عنوان گزینه تفسیر شود. در صورت وجود این قابلیت، با قرار دادن "\-\-" قبل از ارسال نام کاربری توسط \(rsu از آن استفاده کنید.
.SH "فایل‌های پیش‌درآمد (ISSUE FILES)"
.sp
فایل issue پیش‌فرض \fI/etc/issue\fP است. اگر این فایل وجود داشته باشد، \fBagetty\fP همچنین وجود دایرکتوری \fI/etc/issue.d\fP را بررسی می‌کند. این دایرکتوری یک افزونه اختیاری برای فایل issue پیش‌فرض است و محتوای دایرکتوری پس از محتوای \fI/etc/issue\fP چاپ می‌شود. اگر فایل \fI/etc/issue\fP وجود نداشته باشد، این دایرکتوری نادیده گرفته می‌شود. تمام فایل‌های \fBدارای پسوند .issue\fP از این دایرکتوری به ترتیب مرتب‌سازی نسخه چاپ می‌شوند. این دایرکتوری می‌تواند برای نگهداری پیام‌های برنامه‌های شخص ثالث به‌صورت مستقل از فایل اصلی \fI/etc/issue\fP سیستم استفاده شود.
.sp
از نسخه ۲.۳۵ به بعد، مکان‌های اضافی برای فایل و دایرکتوری issue پشتیبانی می‌شوند. دستور \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
توجه داشته باشید که در نسخه‌های ۲.۳۵ تا ۲.۴۰، مکان‌های اضافی تنها در صورتی خوانده می‌شدند که فایل پیش‌فرض \fI/etc/issue\fP وجود نداشت. با این حال، از نسخه ۲.۴۱، مکان‌های اضافی صرف‌نظر از وجود فایل \fI/etc/issue\fP همواره خوانده می‌شوند. این تغییر امکان تولید پیش‌فرض فایل‌های issue را فراهم می‌سازد.
.sp
مسیرهای پیش‌فرض را می‌توان به‌طور کامل با استفاده از گزینه \fB\-\-issue\-file\fP بازنویسی کرد. در این حالت مسیر مشخص‌شده باید یک فایل یا دایرکتوری باشد و تمام مکان‌های پیش‌فرض فایل و دایرکتوری issue نادیده گرفته می‌شوند.
.sp
قابلیت فایل issue را می‌توان با استفاده از گزینه \fB\-\-noissue\fP به‌طور کامل غیرفعال کرد.
.sp
می‌توان فایل issue فعلی را با دستور \fBagetty \-\-show\-issue\fP روی پایانه فعلی بررسی و بازبینی کرد.
.sp
فایل‌های issue ممکن است حاوی کدهای گریز (escape codes) خاصی برای نمایش نام سیستم، تاریخ، زمان و غیره باشند. تمام کدهای گریز شامل یک بک‌اسلش (\(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
b
.RS 4
نرخ باود (baudrate) خط فعلی را درج می‌کند.
.RE
.sp
d
.RS 4
تاریخ فعلی را درج می‌کند.
.RE
.sp
e یا e{\fIname\fP}
.RS 4
نام خوانا برای انسان (\fIname\fP) را به یک دنباله گریز (escape sequence) ترجمه کرده و درج می‌کند (برای مثال: \(rse{red}متن هشدار.\(rse{reset}). اگر آرگومان \fIname\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 یا 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
نام گره (nodename) دستگاه را درج می‌کند که با عنوان نام میزبان (hostname) نیز شناخته می‌شود. معادل دستور \fBuname \-n\fP است.
.RE
.sp
o
.RS 4
نام دامنه NIS دستگاه را درج می‌کند. معادل دستور \fBhostname \-d\fP است.
.RE
.sp
O
.RS 4
نام دامنه DNS دستگاه را درج می‌کند.
.RE
.sp
r
.RS 4
شماره انتشار (release) سیستم‌عامل را درج می‌کند. معادل دستور \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
نسخه سیستم‌عامل، یعنی تاریخ ساخت (build\-date) و موارد مشابه را درج می‌کند.
.RE
.sp
یک مثال. در سیستم من، فایل \fI/etc/issue\fP زیر:
.sp
.if n .RS 4
.nf
.fam C
This is \(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 (Linux i386 1.1.9) 18:29:30
.fam
.fi
.if n .RE
.SH "فایل‌ها (FILES)"
.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 "اعتبارنامه‌ها (CREDENTIALS)"
.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 "اشکالات (BUGS)"
.sp
قابلیت تشخیص نرخ باود (گزینه \fB\-\-extract\-baud\fP) مستلزم این است که \fBagetty\fP به اندازه کافی سریع پس از برقراری تماس تلفنی زمان‌بندی و اجرا شود (در عرض ۳۰ میلی‌ثانیه برای مودم‌هایی که با نرخ ۲۴۰۰ باود ارتباط برقرار می‌کنند). برای پایداری بیشتر، همیشه از گزینه \fB\-\-extract\-baud\fP در ترکیب با آرگومان چندگانه نرخ باود در خط فرمان استفاده کنید تا پردازش BREAK فعال باشد.
.sp
متن موجود در فایل \fI/etc/issue\fP (یا سایر فایل‌ها) و اعلان ورود همواره با نویسه‌های ۷ بیتی و پاریتی فاصله (space parity) ارسال می‌شوند.
.sp
قابلیت تشخیص نرخ باود (گزینه \fB\-\-extract\-baud\fP) مستلزم آن است که مودم پیام وضعیت خود را \fIپس از\fP فعال کردن خط DCD ارسال کند.
.SH "عیب‌یابی (DIAGNOSTICS)"
.sp
بسته به نحوه پیکربندی برنامه، تمام پیام‌های تشخیصی روی دستگاه کنسول نوشته می‌شوند یا از طریق امکانات \fBsyslog\fP(3) گزارش می‌شوند. در صورتی که آرگومان \fIport\fP یک دستگاه پایانه را مشخص نکند؛ اگر مدخل utmp برای فرایند فعلی وجود نداشته باشد (فقط در System V)؛ و موارد مشابه، پیام‌های خطا صادر می‌شوند.
.SH "نویسندگان (AUTHORS)"
.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 "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBagetty\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.