| STTY(1) | دستورات کاربر | STTY(1) |
نام (NAME)
stty - تغییر و چاپ تنظیمات خط ترمینال
خلاصه دستور (SYNOPSIS)
stty [-F DEVICE | --file=DEVICE] [SETTING]...
stty [-F DEVICE | --file=DEVICE] [-a|--all]
stty [-F DEVICE | --file=DEVICE] [-g|--save]
توضیحات (DESCRIPTION)
چاپ یا تغییر ویژگیها و مشخصات خط ترمینال.
آرگومانهای اجباری برای گزینههای طولانی، برای گزینههای کوتاه نیز اجباری هستند.
- -a, --all
- چاپ تمام تنظیمات فعلی در قالبی خوانا برای انسان
- -g, --save
- چاپ تمام تنظیمات فعلی در قالبی قابل خواندن توسط stty
- -F, --file=DEVICE
- باز کردن و استفاده از DEVICE مشخصشده به جای ورودی استاندارد
- --help
- نمایش این راهنما و خروج
- --version
- نمایش اطلاعات نسخه و خروج
علامت اختیاری - پیش از SETTING نشاندهنده نفی (غیرفعالسازی) آن است. علامت * نشاندهنده تنظیمات غیر POSIX است. سیستم زیربنایی مشخص میکند کدام تنظیمات در دسترس هستند.
نویسههای ویژه (Special characters)
- * discard CHAR
- نویسه CHAR نادیدهگیری (دور ریختن) خروجی را تغییر وضعیت میدهد
- eof CHAR
- نویسه CHAR نشانگر پایان فایل را ارسال میکند (پایان دادن به ورودی)
- eol CHAR
- نویسه CHAR به خط پایان میدهد
- * eol2 CHAR
- نویسه CHAR جایگزین برای پایان دادن به خط
- erase CHAR
- نویسه CHAR آخرین نویسه تایپشده را پاک میکند
- intr CHAR
- نویسه CHAR یک سیگنال وقفه (interrupt) ارسال میکند
- kill CHAR
- نویسه CHAR خط جاری را پاک میکند
- * lnext CHAR
- نویسه CHAR نویسه بعدی را به صورت تحتاللفظی (quoted) وارد میکند
- quit CHAR
- نویسه CHAR یک سیگنال خروج (quit) ارسال میکند
- * rprnt CHAR
- نویسه CHAR خط جاری را دوباره ترسیم میکند
- start CHAR
- نویسه CHAR پس از متوقف شدن خروجی، آن را مجدداً آغاز میکند
- stop CHAR
- نویسه CHAR خروجی را متوقف میکند
- susp CHAR
- نویسه CHAR یک سیگنال تعلیق ترمینال (stop signal) ارسال میکند
- * swtch CHAR
- نویسه CHAR به یک لایه پوسته (shell) دیگر سوئیچ میکند
- * werase CHAR
- نویسه CHAR آخرین کلمه تایپشده را پاک میکند
تنظیمات ویژه (Special settings)
- N
- تنظیم سرعت ورودی و خروجی روی N بود (baud)
- cols N
- اعلام به هسته مبنی بر اینکه ترمینال دارای N ستون است
- * columns N
- همانند cols N
- * [-]drain
- صبر کردن برای ارسال و انتقال دادهها پیش از اعمال تنظیمات (بهطور پیشفرض فعال است)
- ispeed N
- تنظیم سرعت ورودی روی N
- * line N
- استفاده از انضباط خط (line discipline) شماره N
- min N
- همراه با -icanon، تعیین حداقل N نویسه برای تکمیل یک خواندن
- ospeed N
- تنظیم سرعت خروجی روی N
- rows N
- اعلام به هسته مبنی بر اینکه ترمینال دارای N سطر است
- size
- چاپ تعداد سطرها و ستونها بر اساس گزارش هسته
- speed
- چاپ سرعت خط ترمینال
- time N
- همراه با -icanon، تنظیم مهلت زمانی خواندن به میزان N دهم ثانیه
تنظیمات کنترلی (Control settings)
- [-]clocal
- غیرفعالسازی سیگنالهای کنترلی مودم
- [-]cread
- اجازه دریافت ورودی
- * [-]crtscts
- فعالسازی دستتکانی سختافزاری RTS/CTS
- csN
- تنظیم اندازه هر نویسه به N بیت، که N در محدوده [5..8] است
- [-]cstopb
- استفاده از دو بیت توقف در هر نویسه (یک بیت همراه با '-')
- [-]hup
- ارسال سیگنال قطع ارتباط (hangup) هنگامی که آخرین پردازش tty را میبندد
- [-]hupcl
- همانند [-]hup
- [-]parenb
- تولید بیت توازن در خروجی و انتظار بیت توازن در ورودی
- [-]parodd
- تنظیم توازن فرد (یا توازن زوج همراه با '-')
- * [-]cmspar
- استفاده از توازن ثابت "stick" (علامت/فاصله یا mark/space)
تنظیمات ورودی (Input settings)
- [-]brkint
- نویسههای شکست (break) باعث ارسال سیگنال وقفه شوند
- [-]icrnl
- تبدیل بازگشت به ابتدای سطر (carriage return) به خط جدید (newline)
- [-]ignbrk
- نادیده گرفتن نویسههای شکست (break)
- [-]igncr
- نادیده گرفتن بازگشت به ابتدای سطر
- [-]ignpar
- نادیده گرفتن نویسههای دارای خطای توازن
- * [-]imaxbel
- بوق زدن و خالی نکردن بافر ورودی پرشده در هنگام دریافت یک نویسه
- [-]inlcr
- تبدیل خط جدید به بازگشت به ابتدای سطر
- [-]inpck
- فعالسازی بررسی توازن ورودی
- [-]istrip
- پاک کردن (صفر کردن) بیت مرتبه بالا (بیت هشتم) در نویسههای ورودی
- * [-]iutf8
- فرض کردن اینکه نویسههای ورودی با کدگذاری UTF-8 هستند
- * [-]iuclc
- تبدیل حروف بزرگ به حروف کوچک
- * [-]ixany
- اجازه دادن به هر نویسهای برای راهاندازی مجدد خروجی، نه فقط نویسه start
- [-]ixoff
- فعالسازی ارسال نویسههای شروع/توقف (start/stop)
- [-]ixon
- فعالسازی کنترل جریان XON/XOFF
- [-]parmrk
- علامتگذاری خطاهای توازن (با توالی نویسهای 255-0)
- [-]tandem
- همانند [-]ixoff
تنظیمات خروجی (Output settings)
- * bsN
- سبک تأخیر پسبر (backspace)، که N در محدوده [0..1] است
- * crN
- سبک تأخیر بازگشت به ابتدای سطر، که N در محدوده [0..3] است
- * ffN
- سبک تأخیر برگه جدید (form feed)، که N در محدوده [0..1] است
- * nlN
- سبک تأخیر خط جدید، که N در محدوده [0..1] است
- * [-]ocrnl
- تبدیل بازگشت به ابتدای سطر به خط جدید
- * [-]ofdel
- استفاده از نویسههای حذف (delete) برای پر کردن به جای نویسههای NUL
- * [-]ofill
- استفاده از نویسههای پرکننده (padding) به جای زمانبندی برای ایجاد تأخیرها
- * [-]olcuc
- تبدیل حروف کوچک به حروف بزرگ
- * [-]onlcr
- تبدیل خط جدید به بازگشت به سطر و خط جدید (CR-LF)
- * [-]onlret
- خط جدید عمل بازگشت به ابتدای سطر را نیز انجام دهد
- * [-]onocr
- چاپ نکردن بازگشت به ابتدای سطر در ستون نخست
- [-]opost
- پسپردازش خروجی
- * tabN
- سبک تأخیر تب افقی، که N در محدوده [0..3] است
- * tabs
- همانند tab0
- * -tabs
- همانند tab3
- * vtN
- سبک تأخیر تب عمودی، که N در محدوده [0..1] است
تنظیمات محلی (Local settings)
- [-]crterase
- پژواک نویسههای پاک کردن به صورت پسبر-فاصله-پسبر
- * crtkill
- حذف تمام خط با رعایت تنظیمات echoprt و echoe
- * -crtkill
- حذف تمام خط با رعایت تنظیمات echoctl و echok
- * [-]ctlecho
- پژواک نویسههای کنترلی در نمادگذاری کلاهی ('^c')
- [-]echo
- پژواک نویسههای ورودی
- * [-]echoctl
- همانند [-]ctlecho
- [-]echoe
- همانند [-]crterase
- [-]echok
- پژواک خط جدید پس از نویسه kill
- * [-]echoke
- همانند [-]crtkill
- [-]echonl
- پژواک خط جدید حتی اگر نویسههای دیگر پژواک داده نشوند
- * [-]echoprt
- پژواک نویسههای پاکشده به سمت عقب، میان '\' و '/'
- * [-]extproc
- فعالسازی "LINEMODE"؛ مناسب برای پیوندهای با تأخیر بالا
- * [-]flusho
- دور ریختن خروجی
- [-]icanon
- فعالسازی نویسههای ویژه: erase، kill، werase، rprnt
- [-]iexten
- فعالسازی نویسههای ویژه غیر POSIX
- [-]isig
- فعالسازی نویسههای ویژه وقفه (interrupt)، خروج (quit) و تعلیق (suspend)
- [-]noflsh
- غیرفعالسازی تخلیه بافر پس از دریافت نویسههای ویژه وقفه و خروج
- * [-]prterase
- همانند [-]echoprt
- * [-]tostop
- متوقف ساختن پردازشهای پسزمینه که قصد نوشتن روی ترمینال را دارند
- * [-]xcase
- همراه با icanon، گریز با '\' برای حروف بزرگ
تنظیمات ترکیبی (Combination settings)
- * [-]LCASE
- همانند [-]lcase
- cbreak
- همانند -icanon
- -cbreak
- همانند icanon
- cooked
- همانند brkint ignpar istrip icrnl ixon opost isig icanon، و بازگرداندن نویسههای eof و eol به مقادیر پیشفرضشان
- -cooked
- همانند raw
- crt
- همانند echoe echoctl echoke
- dec
- همانند echoe echoctl echoke -ixany intr ^c erase 0177 kill ^u
- * [-]decctlq
- همانند [-]ixany
- ek
- بازگرداندن نویسههای erase و kill به مقادیر پیشفرضشان
- evenp
- همانند parenb -parodd cs7
- -evenp
- همانند -parenb cs8
- * [-]lcase
- همانند xcase iuclc olcuc
- litout
- همانند -parenb -istrip -opost cs8
- -litout
- همانند parenb istrip opost cs7
- nl
- همانند -icrnl -onlcr
- -nl
- همانند icrnl -inlcr -igncr onlcr -ocrnl -onlret
- oddp
- همانند parenb parodd cs7
- -oddp
- همانند -parenb cs8
- [-]parity
- همانند [-]evenp
- pass8
- همانند -parenb -istrip cs8
- -pass8
- همانند parenb istrip cs7
- raw
- همانند -ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr -icrnl -ixon -ixoff -icanon -opost -isig -iuclc -ixany -imaxbel -xcase min 1 time 0
- -raw
- همانند cooked
- sane
- همانند cread -ignbrk brkint -inlcr -igncr icrnl icanon iexten echo echoe echok -echonl -noflsh -ixoff -iutf8 -iuclc -ixany imaxbel -xcase -olcuc -ocrnl opost -ofill onlcr -onocr -onlret nl0 cr0 tab0 bs0 vt0 ff0 isig -tostop -ofdel -echoprt echoctl echoke -extproc -flusho، و تنظیم تمامی نویسههای ویژه به مقادیر پیشفرضشان
خط tty متصل به ورودی استاندارد را مدیریت میکند. بدون آرگومان، نرخ بود (baud rate)، انضباط خط (line discipline) و انحرافات از stty sane را چاپ میکند. در تنظیمات، CHAR به صورت تحتاللفظی دریافت میشود، یا مطابق ^c ،0x37 ،0177 یا 127 کدگذاری میشود؛ مقادیر ویژه ^- یا undef برای غیرفعال کردن نویسههای ویژه استفاده میشوند.
نویسنده (AUTHOR)
نوشتهشده توسط David MacKenzie.
گزارش اشکالات (REPORTING BUGS)
صفحه
خانگی و
راهنمای
برخط GNU coreutils:
https://www.gnu.org/software/coreutils
راهنمای
عمومی
استفاده از
نرمافزارهای
گنو: https://www.gnu.org/gethelp
گزارش
هرگونه
اشکال در
ترجمه به:
https://translationproject.org/team
حق نشر (COPYRIGHT)
حق نشر © 2025 Free
Software Foundation, Inc.
مجوز GPLv3+: گنو GPL
نسخه ۳ یا
بالاتر
https://gnu.org/licenses/gpl.html.
این
نرمافزار
آزاد است:
شما مجاز به
تغییر و
بازتوزیع
آن هستید.
هیچ ضمانتی
وجود
ندارد، تا
حدی که
قانون
اجازه
میدهد.
همچنین ببینید (SEE ALSO)
مستندات
کامل در:
https://www.gnu.org/software/coreutils/stty
یا به صورت
محلی از
طریق: info '(coreutils) stty invocation'
| June 2025 | GNU coreutils 9.7 |