SETTERM(1) دستورهای کاربری SETTERM(1)

setterm - تنظیم ویژگی‌های ترمینال

setterm [options]

دستور setterm یک رشته نویسه‌ای را در خروجی استاندارد می‌نویسد که قابلیت‌های مشخص‌شده ترمینال را فراخوانی می‌کند. در صورت امکان، برای یافتن رشته مناسب از terminfo استفاده می‌شود. برخی از گزینه‌ها (که در ادامه با "فقط کنسول‌های مجازی" مشخص شده‌اند) با قابلیت‌های terminfo(5) مطابقت ندارند. در این موارد، اگر نوع ترمینال "con" یا "linux" باشد، رشته‌ای که قابلیت مشخص‌شده را در کنسول مجازی Minix رایانه شخصی فراخوانی می‌کند، ارسال می‌شود. گزینه‌هایی که توسط ترمینال پیاده‌سازی نشده‌اند نادیده گرفته می‌شوند.

برای گزینه‌های بولی (on یا off)، مقدار پیش‌فرض on است.

در ادامه، یک 8-color می‌تواند یکی از مقادیر black، red، green، yellow، blue، magenta، cyan یا white باشد.

یک 16-color می‌تواند یک 8-color، یا grey، یا bright همراه با یکی از مقادیر red، green، yellow، blue، magenta، cyan یا white باشد.

گزینه‌های مختلف رنگ را می‌توان به طور مستقل از هم تنظیم کرد، حداقل در کنسول‌های مجازی، اگرچه نتایج حاصل از تنظیم چند حالت هم‌زمان (به عنوان مثال، --underline و --half-bright) به سخت‌افزار وابسته است.

توصیه می‌شود برای آرگومان‌های اختیاری از علامت مساوی ('=') استفاده شود و میان گزینه و آرگومان فاصله‌ای نباشد؛ به عنوان مثال --option=argument. دستور setterm می‌تواند آرگومان غیرگزینه‌ای بعدی را نیز به عنوان یک آرگومان اختیاری تفسیر کند.

--appcursorkeys on|off

حالت Cursor Key Application را روشن یا خاموش می‌کند. در حالت فعال، به جای ارسال ESC [ A، ESC [ B و غیره، کدهای ESC O A، ESC O B و غیره برای کلیدهای مکان‌نما ارسال می‌شوند. برای اطلاع از اینکه این مورد چگونه می‌تواند برای کاربران vi مشکل ایجاد کند، بخش vi and Cursor-Keys در راهنمای Text-Terminal-HOWTO را ببینید. فقط برای کنسول‌های مجازی.

--append console_number

مشابه --dump عمل می‌کند، اما به جای رونویسی پرونده تصویر لحظه‌ای، اطلاعات را به انتهای آن ضمیمه می‌کند. فقط در صورتی کار می‌کند که هیچ گزینه --dump دیگری مشخص نشده باشد.

--background 8-color|default

رنگ پس‌زمینه متن را تنظیم می‌کند.

--blank[=0-60|force|poke]

فاصله زمانی عدم فعالیت (بر حسب دقیقه) را تنظیم می‌کند که پس از آن صفحه نمایش به طور خودکار خاموش/خالی (blank) می‌شود (در صورت دسترسی، از APM استفاده می‌کند). بدون آرگومان، وضعیت خاموشی صفحه را دریافت می‌کند (مشخص می‌کند کدام ترمینال مجازی خاموش شده است، یا در صورت فعال بودن صفر برمی‌گرداند). فقط برای کنسول‌های مجازی.

آرگومان force حتی در صورت فشرده شدن یک کلید، صفحه را خاموش نگه می‌دارد.

آرگومان poke صفحه را از حالت خاموش خارج می‌کند.

--bfreq[=number]

فرکانس بوق زنگ (bell) را بر حسب هرتز تنظیم می‌کند. بدون آرگومان، مقدار پیش‌فرض 0 است. فقط برای کنسول‌های مجازی.

--blength[=0-2000]

مدت زمان بوق زنگ را بر حسب میلی‌ثانیه تنظیم می‌کند. بدون آرگومان، مقدار پیش‌فرض 0 است. فقط برای کنسول‌های مجازی.

--blink on|off

حالت چشمک‌زن (blink) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، --blink off تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.

--bold on|off

حالت برجسته یا بسیار روشن (bold) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، --bold off تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.

--clear[=all|rest]

بدون آرگومان یا با آرگومان all، کل صفحه پاک شده و مکان‌نما در موقعیت آغازین (home) قرار می‌گیرد؛ درست مانند عملکرد دستور clear(1). با آرگومان rest، صفحه از موقعیت فعلی مکان‌نما تا انتهای آن پاک می‌شود.

--clrtabs[=tab1 tab2 tab3 ...]

فواصل جدول‌بندی (tab stops) را از موقعیت‌های افقی مشخص‌شده مکان‌نما، در بازه 1-160 پاک می‌کند. بدون آرگومان، تمام فواصل جدول‌بندی را پاک می‌کند. فقط برای کنسول‌های مجازی.

--cursor on|off

نمایش مکان‌نمای ترمینال را روشن یا خاموش می‌کند.

--default

گزینه‌های رندر و نمایش ترمینال را روی مقادیر پیش‌فرض تنظیم می‌کند.

--dump[=console_number]

یک تصویر لحظه‌ای (snapshot) از کنسول مجازی با شماره مشخص‌شده را در پرونده تعیین‌شده توسط گزینه --file می‌نویسد و محتوای قبلی آن را بازنویسی می‌کند؛ نام پیش‌فرض screen.dump است. بدون آرگومان، از کنسول مجازی فعلی خروجی می‌گیرد. این گزینه بر --append اولویت دارد.

--file filename

نام پرونده تصویر لحظه‌ای را برای هر کدام از گزینه‌های --dump یا --append در همان خط فرمان تنظیم می‌کند. در صورت عدم وجود این گزینه، پیش‌فرض screen.dump در دایرکتوری جاری خواهد بود. نام مسیری که از بیشینه مجاز سیستم فراتر رود کوتاه می‌شود؛ برای مقدار آن به PATH_MAX در linux/limits.h مراجعه کنید.

--foreground 8-color|default

رنگ پیش‌زمینه متن را تنظیم می‌کند.

--half-bright on|off

حالت کم‌نور (نیمه‌روشن) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، --half-bright off تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.

--hbcolor 16-color

رنگ نویسه‌های نیمه‌روشن را تنظیم می‌کند.

--initialize

رشته مقداردهی اولیه ترمینال را نمایش می‌دهد؛ این رشته معمولاً گزینه‌های رندر ترمینال و سایر ویژگی‌ها را روی مقادیر پیش‌فرض تنظیم می‌کند.

--inversescreen on|off

رنگ‌های پیش‌زمینه و پس‌زمینه را برای کل صفحه جابه‌جا (معکوس) می‌کند.

--linewrap on|off

باعث می‌شود ترمینال هنگام پر شدن یک خط، ادامه متن را در خط جدید نمایش دهد.

--msg on|off

ارسال پیام‌های printk() هسته به کنسول را فعال یا غیرفعال می‌کند. فقط برای کنسول‌های مجازی.

--msglevel 0-8

سطح ثبت گزارش‌های کنسول را برای پیام‌های printk() هسته تنظیم می‌کند. تمام پیام‌هایی که از این سطح مهم‌تر باشند چاپ خواهند شد؛ بنابراین سطح ثبت گزارش 0 تأثیری مشابه با --msg on دارد و سطح 8 تمام پیام‌های هسته را چاپ می‌کند. ممکن است klogd(8) واسط مناسب‌تری برای ثبت گزارش پیام‌های هسته باشد.

فقط برای کنسول‌های مجازی.

--powerdown[=0-60]

فاصله زمانی خاموشی VESA را بر حسب دقیقه تنظیم می‌کند. بدون آرگومان، پیش‌فرض 0 است (غیرفعال کردن خاموشی خودکار). اگر کنسول خالی شده باشد یا نمایشگر در حالت تعلیق باشد، پس از سپری شدن این مدت زمان، نمایشگر به ترتیب به حالت تعلیق vsync یا خاموشی کامل وارد می‌شود.

--powersave mode

مقادیر معتبر برای mode عبارتند از:

vsync|on

نمایشگر را در حالت تعلیق VESA vsync قرار می‌دهد.

hsync

نمایشگر را در حالت تعلیق VESA hsync قرار می‌دهد.

powerdown

نمایشگر را در حالت خاموشی VESA قرار می‌دهد.

off

ویژگی‌های مدیریت مصرف انرژی نمایشگر را خاموش می‌کند.

--regtabs[=1-160]

تمام فواصل جدول‌بندی را پاک کرده و سپس یک الگوی منظم جدول‌بندی با فاصله مشخص‌شده میان موقعیت‌ها ایجاد می‌کند. بدون آرگومان، مقدار پیش‌فرض 8 است. فقط برای کنسول‌های مجازی.

--repeat on|off

تکرار کلیدهای صفحه‌کلید را روشن یا خاموش می‌کند. فقط برای کنسول‌های مجازی.

--reset

رشته بازنشانی ترمینال را نمایش می‌دهد که معمولاً ترمینال را به وضعیت زمان روشن شدن برمی‌گرداند.

--resize

اندازه ترمینال را با ارزیابی بیشینه سطر و ستون بازنشانی می‌کند. این ویژگی زمانی مفید است که ابعاد واقعی و درایور ترمینال هسته با یکدیگر هماهنگ نباشند. برجسته‌ترین کاربرد آن برای کنسول‌های سریال است که از ioctl(2) استفاده نمی‌کنند و تنها با جریان‌های بایتی و وقفه‌ها کار می‌کنند.

--reverse on|off

حالت تصویر معکوس (reverse video) را روشن یا خاموش می‌کند. به جز در کنسول مجازی، --reverse off تمام ویژگی‌ها (برجسته، نیمه‌روشن، چشمک‌زن، معکوس) را خاموش می‌کند.

--store

گزینه‌های رندر فعلی ترمینال (رنگ‌های پیش‌زمینه و پس‌زمینه) را به عنوان مقادیری که در بازنشانی به حالت پیش‌فرض استفاده می‌شوند ذخیره می‌کند. فقط برای کنسول‌های مجازی.

--tabs[=tab1 tab2 tab3 ...]

فواصل جدول‌بندی را در موقعیت‌های افقی مشخص‌شده مکان‌نما، در بازه 1-160 تنظیم می‌کند. بدون آرگومان، تنظیمات فعلی فواصل جدول‌بندی را نمایش می‌دهد.

--term terminal_name

متغیر محیطی TERM را نادیده گرفته و جایگزین می‌کند.

--ulcolor 16-color

رنگ نویسه‌های زیرخط‌دار (underline) را تنظیم می‌کند. فقط برای کنسول‌های مجازی.

--underline on|off

حالت زیرخط را روشن یا خاموش می‌کند.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

استفاده از setterm همراه با تغییر مسیر stdout ممکن است نتایج غیرمنتظره‌ای داشته باشد، زیرا برخی گزینه‌ها روی stdin عمل می‌کنند. برای جلوگیری از بروز مشکل، همیشه هر دو ورودی stdin و خروجی stdout را به یک دستگاه تغییر مسیر دهید.

از نسخه 2.25، setterm علاوه بر گزینه‌های طولانی سنتی با یک خط تیره مانند -help، از گزینه‌های طولانی با دو خط تیره مانند --help نیز پشتیبانی می‌کند. در اسکریپت‌ها بهتر است به جای دو خط تیره، از تک خط تیره که سازگاری رو به عقب دارد استفاده شود. در حال حاضر هیچ برنامه یا دلیل موجهی برای قطع پشتیبانی از حالت تک خط تیره وجود ندارد.

تفاوت‌های میان نسخه‌های Minix و Linux مستند نشده‌اند.

stty(1), tput(1), tty(4), terminfo(5)

برای گزارش باگ‌ها، از سامانه ردیابی اشکالات https://github.com/util-linux/util-linux/issues.

دستور setterm بخشی از بسته util-linux است که می‌توان آن را از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت کرد.

2026-06-16 util-linux 2.41.5