'\" t
.\"     Title: setterm
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: User Commands
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "SETTERM" "1" "2026-06-16" "util\-linux 2.41.5" "دستورهای کاربری"
.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)"
setterm \- تنظیم ویژگی‌های ترمینال
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsetterm\fP [options]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBsetterm\fP یک رشته نویسه‌ای را در خروجی استاندارد می‌نویسد که قابلیت‌های مشخص‌شده ترمینال را فراخوانی می‌کند. در صورت امکان، برای یافتن رشته مناسب از \fIterminfo\fP استفاده می‌شود. برخی از گزینه‌ها (که در ادامه با \(dqفقط کنسول‌های مجازی\(dq مشخص شده‌اند) با قابلیت‌های \fBterminfo\fP(5) مطابقت ندارند. در این موارد، اگر نوع ترمینال \(dqcon\(dq یا \(dqlinux\(dq باشد، رشته‌ای که قابلیت مشخص‌شده را در کنسول مجازی Minix رایانه شخصی فراخوانی می‌کند، ارسال می‌شود. گزینه‌هایی که توسط ترمینال پیاده‌سازی نشده‌اند نادیده گرفته می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای گزینه‌های بولی (\fBon\fP یا \fBoff\fP)، مقدار پیش‌فرض \fBon\fP است.
.sp
در ادامه، یک \fI8\-color\fP می‌تواند یکی از مقادیر \fBblack\fP، \fBred\fP، \fBgreen\fP، \fByellow\fP، \fBblue\fP، \fBmagenta\fP، \fBcyan\fP یا \fBwhite\fP باشد.
.sp
یک \fI16\-color\fP می‌تواند یک \fI8\-color\fP، یا \fBgrey\fP، یا \fBbright\fP همراه با یکی از مقادیر \fBred\fP، \fBgreen\fP، \fByellow\fP، \fBblue\fP، \fBmagenta\fP، \fBcyan\fP یا \fBwhite\fP باشد.
.sp
گزینه‌های مختلف رنگ را می‌توان به طور مستقل از هم تنظیم کرد، حداقل در کنسول‌های مجازی، اگرچه نتایج حاصل از تنظیم چند حالت هم‌زمان (به عنوان مثال، \fB\-\-underline\fP و \fB\-\-half\-bright\fP) به سخت‌افزار وابسته است.
.sp
توصیه می‌شود برای آرگومان‌های اختیاری از علامت مساوی (\*(Aq=\*(Aq) استفاده شود و میان گزینه و آرگومان فاصله‌ای نباشد؛ به عنوان مثال \-\-option=argument. دستور \fBsetterm\fP می‌تواند آرگومان غیرگزینه‌ای بعدی را نیز به عنوان یک آرگومان اختیاری تفسیر کند.
.sp
\fB\-\-appcursorkeys\fP \fBon\fP|\fBoff\fP
.RS 4
حالت Cursor Key Application را روشن یا خاموش می‌کند. در حالت فعال، به جای ارسال ESC [ A، ESC [ B و غیره، کدهای ESC O A، ESC O B و غیره برای کلیدهای مکان‌نما ارسال می‌شوند. برای اطلاع از اینکه این مورد چگونه می‌تواند برای کاربران \fBvi\fP مشکل ایجاد کند، بخش \fIvi and Cursor\-Keys\fP در راهنمای \fIText\-Terminal\-HOWTO\fP را ببینید. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-append\fP \fIconsole_number\fP
.RS 4
مشابه \fB\-\-dump\fP عمل می‌کند، اما به جای رونویسی پرونده تصویر لحظه‌ای، اطلاعات را به انتهای آن ضمیمه می‌کند. فقط در صورتی کار می‌کند که هیچ گزینه \fB\-\-dump\fP دیگری مشخص نشده باشد.
.RE
.sp
\fB\-\-background\fP \fI8\-color\fP|\fBdefault\fP
.RS 4
رنگ پس‌زمینه متن را تنظیم می‌کند.
.RE
.sp
\fB\-\-blank\fP[\fB=0\fP\-\fB60\fP|\fBforce\fP|\fBpoke\fP]
.RS 4
فاصله زمانی عدم فعالیت (بر حسب دقیقه) را تنظیم می‌کند که پس از آن صفحه نمایش به طور خودکار خاموش/خالی (blank) می‌شود (در صورت دسترسی، از APM استفاده می‌کند). بدون آرگومان، وضعیت خاموشی صفحه را دریافت می‌کند (مشخص می‌کند کدام ترمینال مجازی خاموش شده است، یا در صورت فعال بودن صفر برمی‌گرداند). فقط برای کنسول‌های مجازی.
.sp
آرگومان \fBforce\fP حتی در صورت فشرده شدن یک کلید، صفحه را خاموش نگه می‌دارد.
.sp
آرگومان \fBpoke\fP صفحه را از حالت خاموش خارج می‌کند.
.RE
.sp
\fB\-\-bfreq\fP[\fB=\fP\fInumber\fP]
.RS 4
فرکانس بوق زنگ (bell) را بر حسب هرتز تنظیم می‌کند. بدون آرگومان، مقدار پیش‌فرض \fB0\fP است. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-blength\fP[\fB=0\fP\-\fB2000\fP]
.RS 4
مدت زمان بوق زنگ را بر حسب میلی‌ثانیه تنظیم می‌کند. بدون آرگومان، مقدار پیش‌فرض \fB0\fP است. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-blink\fP \fBon\fP|\fBoff\fP
.RS 4
حالت چشمک‌زن (blink) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، \fB\-\-blink off\fP تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.
.RE
.sp
\fB\-\-bold\fP \fBon\fP|\fBoff\fP
.RS 4
حالت برجسته یا بسیار روشن (bold) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، \fB\-\-bold off\fP تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.
.RE
.sp
\fB\-\-clear\fP[\fB=all\fP|\fBrest\fP]
.RS 4
بدون آرگومان یا با آرگومان \fBall\fP، کل صفحه پاک شده و مکان‌نما در موقعیت آغازین (home) قرار می‌گیرد؛ درست مانند عملکرد دستور \fBclear\fP(1). با آرگومان \fBrest\fP، صفحه از موقعیت فعلی مکان‌نما تا انتهای آن پاک می‌شود.
.RE
.sp
\fB\-\-clrtabs\fP[\fB=\fP\fItab1 tab2 tab3\fP .\|.\|.]
.RS 4
فواصل جدول‌بندی (tab stops) را از موقعیت‌های افقی مشخص‌شده مکان‌نما، در بازه \fB1\fP\-\fB160\fP پاک می‌کند. بدون آرگومان، تمام فواصل جدول‌بندی را پاک می‌کند. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-cursor\fP \fBon\fP|\fBoff\fP
.RS 4
نمایش مکان‌نمای ترمینال را روشن یا خاموش می‌کند.
.RE
.sp
\fB\-\-default\fP
.RS 4
گزینه‌های رندر و نمایش ترمینال را روی مقادیر پیش‌فرض تنظیم می‌کند.
.RE
.sp
\fB\-\-dump\fP[\fB=\fP\fIconsole_number\fP]
.RS 4
یک تصویر لحظه‌ای (snapshot) از کنسول مجازی با شماره مشخص‌شده را در پرونده تعیین‌شده توسط گزینه \fB\-\-file\fP می‌نویسد و محتوای قبلی آن را بازنویسی می‌کند؛ نام پیش‌فرض \fIscreen.dump\fP است. بدون آرگومان، از کنسول مجازی فعلی خروجی می‌گیرد. این گزینه بر \fB\-\-append\fP اولویت دارد.
.RE
.sp
\fB\-\-file\fP \fIfilename\fP
.RS 4
نام پرونده تصویر لحظه‌ای را برای هر کدام از گزینه‌های \fB\-\-dump\fP یا \fB\-\-append\fP در همان خط فرمان تنظیم می‌کند. در صورت عدم وجود این گزینه، پیش‌فرض \fIscreen.dump\fP در دایرکتوری جاری خواهد بود. نام مسیری که از بیشینه مجاز سیستم فراتر رود کوتاه می‌شود؛ برای مقدار آن به \fBPATH_MAX\fP در \fIlinux/limits.h\fP مراجعه کنید.
.RE
.sp
\fB\-\-foreground\fP \fI8\-color\fP|\fBdefault\fP
.RS 4
رنگ پیش‌زمینه متن را تنظیم می‌کند.
.RE
.sp
\fB\-\-half\-bright\fP \fBon\fP|\fBoff\fP
.RS 4
حالت کم‌نور (نیمه‌روشن) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، \fB\-\-half\-bright off\fP تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.
.RE
.sp
\fB\-\-hbcolor\fP \fI16\-color\fP
.RS 4
رنگ نویسه‌های نیمه‌روشن را تنظیم می‌کند.
.RE
.sp
\fB\-\-initialize\fP
.RS 4
رشته مقداردهی اولیه ترمینال را نمایش می‌دهد؛ این رشته معمولاً گزینه‌های رندر ترمینال و سایر ویژگی‌ها را روی مقادیر پیش‌فرض تنظیم می‌کند.
.RE
.sp
\fB\-\-inversescreen\fP \fBon\fP|\fBoff\fP
.RS 4
رنگ‌های پیش‌زمینه و پس‌زمینه را برای کل صفحه جابه‌جا (معکوس) می‌کند.
.RE
.sp
\fB\-\-linewrap\fP \fBon\fP|\fBoff\fP
.RS 4
باعث می‌شود ترمینال هنگام پر شدن یک خط، ادامه متن را در خط جدید نمایش دهد.
.RE
.sp
\fB\-\-msg\fP \fBon\fP|\fBoff\fP
.RS 4
ارسال پیام‌های \fBprintk\fP() هسته به کنسول را فعال یا غیرفعال می‌کند. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-msglevel\fP \fB0\fP\-\fB8\fP
.RS 4
سطح ثبت گزارش‌های کنسول را برای پیام‌های \fBprintk()\fP هسته تنظیم می‌کند. تمام پیام‌هایی که از این سطح مهم‌تر باشند چاپ خواهند شد؛ بنابراین سطح ثبت گزارش \fB0\fP تأثیری مشابه با \fB\-\-msg on\fP دارد و سطح \fB8\fP تمام پیام‌های هسته را چاپ می‌کند. ممکن است \fBklogd\fP(8) واسط مناسب‌تری برای ثبت گزارش پیام‌های هسته باشد.
.sp
فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-powerdown\fP[\fB=0\fP\-\fB60\fP]
.RS 4
فاصله زمانی خاموشی VESA را بر حسب دقیقه تنظیم می‌کند. بدون آرگومان، پیش‌فرض \fB0\fP است (غیرفعال کردن خاموشی خودکار). اگر کنسول خالی شده باشد یا نمایشگر در حالت تعلیق باشد، پس از سپری شدن این مدت زمان، نمایشگر به ترتیب به حالت تعلیق vsync یا خاموشی کامل وارد می‌شود.
.RE
.sp
\fB\-\-powersave\fP \fImode\fP
.RS 4
مقادیر معتبر برای \fImode\fP عبارتند از:
.sp
\fBvsync\fP|\fBon\fP
.RS 4
نمایشگر را در حالت تعلیق VESA vsync قرار می‌دهد.
.RE
.sp
\fBhsync\fP
.RS 4
نمایشگر را در حالت تعلیق VESA hsync قرار می‌دهد.
.RE
.sp
\fBpowerdown\fP
.RS 4
نمایشگر را در حالت خاموشی VESA قرار می‌دهد.
.RE
.sp
\fBoff\fP
.RS 4
ویژگی‌های مدیریت مصرف انرژی نمایشگر را خاموش می‌کند.
.RE
.RE
.sp
\fB\-\-regtabs\fP[\fB=1\fP\-\fB160\fP]
.RS 4
تمام فواصل جدول‌بندی را پاک کرده و سپس یک الگوی منظم جدول‌بندی با فاصله مشخص‌شده میان موقعیت‌ها ایجاد می‌کند. بدون آرگومان، مقدار پیش‌فرض \fB8\fP است. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-repeat\fP \fBon\fP|\fBoff\fP
.RS 4
تکرار کلیدهای صفحه‌کلید را روشن یا خاموش می‌کند. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-reset\fP
.RS 4
رشته بازنشانی ترمینال را نمایش می‌دهد که معمولاً ترمینال را به وضعیت زمان روشن شدن برمی‌گرداند.
.RE
.sp
\fB\-\-resize\fP
.RS 4
اندازه ترمینال را با ارزیابی بیشینه سطر و ستون بازنشانی می‌کند. این ویژگی زمانی مفید است که ابعاد واقعی و درایور ترمینال هسته با یکدیگر هماهنگ نباشند. برجسته‌ترین کاربرد آن برای کنسول‌های سریال است که از \fBioctl\fP(2) استفاده نمی‌کنند و تنها با جریان‌های بایتی و وقفه‌ها کار می‌کنند.
.RE
.sp
\fB\-\-reverse\fP \fBon\fP|\fBoff\fP
.RS 4
حالت تصویر معکوس (reverse video) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، \fB\-\-reverse off\fP تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.
.RE
.sp
\fB\-\-store\fP
.RS 4
گزینه‌های رندر فعلی ترمینال (رنگ‌های پیش‌زمینه و پس‌زمینه) را به عنوان مقادیری که در بازنشانی به حالت پیش‌فرض استفاده می‌شوند ذخیره می‌کند. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-tabs\fP[\fB=\fP\fItab1 tab2 tab3\fP .\|.\|.]
.RS 4
فواصل جدول‌بندی را در موقعیت‌های افقی مشخص‌شده مکان‌نما، در بازه \fB1\fP\-\fB160\fP تنظیم می‌کند. بدون آرگومان، تنظیمات فعلی فواصل جدول‌بندی را نمایش می‌دهد.
.RE
.sp
\fB\-\-term\fP \fIterminal_name\fP
.RS 4
متغیر محیطی \fBTERM\fP را نادیده گرفته و جایگزین می‌کند.
.RE
.sp
\fB\-\-ulcolor\fP \fI16\-color\fP
.RS 4
رنگ نویسه‌های زیرخط‌دار (underline) را تنظیم می‌کند. فقط برای کنسول‌های مجازی.
.RE
.sp
\fB\-\-underline\fP \fBon\fP|\fBoff\fP
.RS 4
حالت زیرخط را روشن یا خاموش می‌کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "هشدار (WARNING)"
.sp
استفاده از \fBsetterm\fP همراه با تغییر مسیر stdout ممکن است نتایج غیرمنتظره‌ای داشته باشد، زیرا برخی گزینه‌ها روی stdin عمل می‌کنند. برای جلوگیری از بروز مشکل، همیشه هر دو ورودی stdin و خروجی stdout را به یک دستگاه تغییر مسیر دهید.
.SH "سازگاری (COMPATIBILITY)"
.sp
از نسخه 2.25، \fBsetterm\fP علاوه بر گزینه‌های طولانی سنتی با یک خط تیره مانند \fB\-help\fP، از گزینه‌های طولانی با دو خط تیره مانند \fB\-\-help\fP نیز پشتیبانی می‌کند. در اسکریپت‌ها بهتر است به جای دو خط تیره، از تک خط تیره که سازگاری رو به عقب دارد استفاده شود. در حال حاضر هیچ برنامه یا دلیل موجهی برای قطع پشتیبانی از حالت تک خط تیره وجود ندارد.
.SH "ایرادات (BUGS)"
.sp
تفاوت‌های میان نسخه‌های Minix و Linux مستند نشده‌اند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBstty\fP(1),
\fBtput\fP(1),
\fBtty\fP(4),
\fBterminfo\fP(5)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه ردیابی اشکالات" "."
.SH "دسترس‌پذیری (AVAILABILITY)"
.sp
دستور \fBsetterm\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت کرد.