'\" t
.\"     Title: setterm
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Команди користувача
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "SETTERM" "1" "2024-04-27" "util\-linux 2.40" "Команди користувача"
.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 "НАЗВА"
setterm \- встановлення атрибутів термінала
.SH "КОРОТКИЙ ОПИС"
.sp
\fBsetterm\fP [options]
.SH "ОПИС"
.sp
\fBsetterm\fP writes to standard output a character string that will invoke the specified terminal capabilities. Where possible \fIterminfo\fP is consulted to find the string to use. Some options however (marked "virtual consoles only" below) do not correspond to a \fBterminfo\fP(5) capability. In this case, if the terminal type is "con" or "linux" the string that invokes the specified capabilities on the PC Minix virtual console driver is output. Options that are not implemented by the terminal are ignored.
.SH "ПАРАМЕТРИ"
.sp
Для булевих параметрів (\fBon\fP або \fBoff\fP) типовим значенням є \fBon\fP (увімкнено).
.sp
Нижче, значенням \fI8\-кольоровий\fP може бути \fBblack\fP, \fBred\fP, \fBgreen\fP, \fByellow\fP, \fBblue\fP, \fBmagenta\fP, \fBcyan\fP або \fBwhite\fP.
.sp
Значенням \fI16\-кольоровий\fP може бути значення \fI8\-кольоровий\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
Необов\(cqязкові аргументи рекомендовано вказувати з використанням «=» (знаку рівності), а не пробілу між параметром і аргументом. Приклад: \-\-параметр=аргумент. \fBsetterm\fP може також обробляти наступний аргумент, який не є параметром, як необов\(cqязковий аргумент.
.sp
\fB\-\-appcursorkeys\fP on|off
.RS 4
Вмикає або вимикає режим програми клавішного курсора. Якщо увімкнено, для клавіш керування курсором видаватимуться комбінації ESC O A, ESC O B тощо, замість ESC [ A, ESC [ B тощо. Див. розділ \fIvi і клавіші курсора\fP у \fIпідручнику з текстового термінала\fP, щоб дізнатися про проблеми, які можуть виникати у користувачів \fBvi\fP. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-append\fP \fIномер_консолі\fP
.RS 4
Подібний до \fB\-\-dump\fP, але дописує до файла знімка, замість його перезаписування. Працює, лише якщо не вказано параметрів \fB\-\-dump\fP.
.RE
.sp
\fB\-\-background\fP \fI8\-кольоровий\fP|default
.RS 4
Встановлює колір тла тексту.
.RE
.sp
\fB\-\-blank\fP[=0\-60|force|poke]
.RS 4
Встановлює інтервал бездіяльності у хвилинах, по завершенню якого екран буде автоматично спорожнено (за допомогою APM, якщо доступна). Без аргументу повідомляє про стан спорожнення (повертає віртуальний термінал, який було спорожнено, або нуль для неспорожненого віртуального термінала). Лише для віртуальних консолей.
.sp
Аргумент \fBforce\fP зберігає екран порожнім, навіть якщо буде натиснуто клавішу.
.sp
Аргумент \fBpoke\fP скасовує порожнечу на екрані.
.RE
.sp
\fB\-\-bfreq\fP[=\fIчисло\fP]
.RS 4
Встановлює частоту гудка у герцах. Без аргументу типовим значенням є \fB0\fP. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-blength\fP[=0\-2000]
.RS 4
Встановлює тривалість гудка у мілісекундах. Без аргументу типовим значенням є \fB0\fP. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-blink\fP on|off
.RS 4
Вмикає або вимикає режим блимання. Лише у віртуальній консолі \fB\-\-blink off\fP вимикає усі атрибути (напівжирний шрифт, напівяскравість, блимання, інверсію).
.RE
.sp
\fB\-\-bold\fP on|off
.RS 4
Вмикає або вимикає режим напівжирного шрифту. Лише у віртуальній консолі \fB\-\-bold off\fP вимикає усі атрибути (напівжирний шрифт, напівяскравість, блимання, інверсію).
.RE
.sp
\fB\-\-clear\fP[=all|rest]
.RS 4
Без аргументу або з аргументом \fBall\fP, буде очищено увесь екран, а курсор буде повернуто у початкову позицію, подібно до того, як діє команда \fBclear\fP(1). Якщо аргументом буде \fBrest\fP, екран буде очищено від поточної позиції курсора до кінця.
.RE
.sp
\fB\-\-clrtabs\fP[=\fIтабуляція1 табуляція2 табуляція3\fP ...]
.RS 4
Усуває позиції табуляції з вказаних горизонтальних позицій у діапазоні \fB1\-160\fP. Без аргументів усуває усі позиції табуляцій. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-cursor\fP on|off
.RS 4
Вмикає або вимикає курсор термінала.
.RE
.sp
\fB\-\-default\fP
.RS 4
Встановлює для параметрів обробки зображення у терміналі типові значення.
.RE
.sp
\fB\-\-dump\fP[=\fIномер\-консолі\fP]
.RS 4
Записати знімок віртуальної консолі із вказаним номером до файла, який вказано за допомогою параметра \fB\-\-file\fP, перезаписавши його вміст; типовим є файл \fIscreen.dump\fP. Без аргументу створює дамп поточної віртуальної консолі. Має вищий пріоритет за \fB\-\-append\fP.
.RE
.sp
\fB\-\-file\fP \fIназва_файла\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\-кольоровий\fP|default
.RS 4
Встановлює колір тексту.
.RE
.sp
\fB\-\-half\-bright\fP on|off
.RS 4
Вмикає або вимикає режим притлумлення (напівяскравості). Лише у віртуальній консолі \fB\-\-half\-bright off\fP вимикає усі атрибути (напівжирний шрифт, напівяскравість, блимання, інверсію).
.RE
.sp
\fB\-\-hbcolor\fP \fI16\-кольоровий\fP
.RS 4
Встановлює колір напівяскравих символів.
.RE
.sp
\fB\-\-initialize\fP
.RS 4
Виводить рядок ініціалізації термінала, який типово встановлює для параметрів обробки зображення та інших атрибутів у терміналі типові значення.
.RE
.sp
\fB\-\-inversescreen\fP on|off
.RS 4
Міняє місцями кольори тексту та тла для усього екрана.
.RE
.sp
\fB\-\-linewrap\fP on|off
.RS 4
Наказує терміналу продовжувати з нового рядка, коли рядок буде заповнено.
.RE
.sp
\fB\-\-msg\fP on|off
.RS 4
Вмикає або вимикає надсилання повідомлень ядра \fBprintk\fP() до консолі. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-msglevel\fP 0\-8
.RS 4
Встановлює рівень журналювання консолі для повідомлень ядра \fBprintk()\fP. Усі повідомлення, якщо бути строгим, є важливішими, за виведений рівень, тому рівень журналювання \fB0\fP дає такий самий результат, що і \fB\-\-msg on\fP, а рівень журналювання \fB8\fP призведе до виведення усіх повідомлень ядра. \fBklogd\fP(8) може бути зручнішим інтерфейсом для журналювання повідомлень ядра.
.sp
Лише віртуальні консолі.
.RE
.sp
\fB\-\-powerdown\fP[=0\-60]
.RS 4
Встановлює інтервал вимикання VESA у хвилинах. Без аргументу типовим значенням є \fB0\fP (вимкнути вимикання живлення). Якщо консоль буде порожньою або монітор перейде у режим присипляння, монітор перейде у режим присипляння вертикальної синхронізації або вимикання, відповідно, щойно сплине вказаний період часу.
.RE
.sp
\fB\-\-powersave\fP \fIрежим\fP
.RS 4
Коректними значеннями аргументу \fIрежим\fP є такі:
.sp
\fBvsync|on\fP
.RS 4
Переводить монітор у режим присипляння vsync VESA.
.RE
.sp
\fBhsync\fP
.RS 4
Переводить монітор у режим присипляння hsync VESA.
.RE
.sp
\fBpowerdown\fP
.RS 4
Переводить монітор у режим вимикання живлення VESA.
.RE
.sp
\fBoff\fP
.RS 4
Вмикає можливості енергозаощадження монітора VESA.
.RE
.RE
.sp
\fB\-\-regtabs\fP[=1\-160]
.RS 4
Знімає усі позиції табуляції, потім встановлює регулярний взірець позицій табуляції, де одній табуляції відповідає вказана кількість позицій. Без аргументу типовим значенням є \fB8\fP. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-repeat\fP on|off
.RS 4
Вмикає або вимикає повторення натискання клавіші. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-reset\fP
.RS 4
Виводить рядок відновлення початкового стану термінала, який типово відновлює стан термінала на момент вмикання.
.RE
.sp
\fB\-\-resize\fP
.RS 4
Скинути розмір термінала визначенням максимальної кількості рядків і стовпчиків. Корисно, якщо справжня геометрія і драйвер термінала ядра не синхронізовано. Найпомітнішим випадком використання є послідовні консолі, у яких не використано \fBioctl\fP(2), а використано лише потоки байтів та розриви рядків.
.RE
.sp
\fB\-\-reverse\fP on|off
.RS 4
Вмикає або вимикає режим інверсії відео. Лише у віртуальній консолі \fB\-\-reverse off\fP вимикає усі атрибути (напівжирний шрифт, напівяскравість, блимання, інверсію).
.RE
.sp
\fB\-\-store\fP
.RS 4
Зберігає поточні параметри обробки зображення терміналом (кольори тексту та тла) як значення, які слід використовувати при відновлення типових параметрів термінала. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-tabs\fP[=\fIтабуляція1 табуляція2 табуляція3\fP ...]
.RS 4
Встановлює позиції табуляції з вказаних горизонтальних позицій у діапазоні \fB1\-160\fP. Без аргументів виводити поточні параметри позицій табуляції.
.RE
.sp
\fB\-\-term\fP \fIназва\-термінала\fP
.RS 4
Перевизначає змінну середовища \fBTERM\fP.
.RE
.sp
\fB\-\-ulcolor\fP \fI16\-кольоровий\fP
.RS 4
Встановлює колір для підкреслених символів. Лише для віртуальних консолей.
.RE
.sp
\fB\-\-underline\fP on|off
.RS 4
Вмикає або вимикає режим підкреслювання.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Вивести текст довідки і завершити роботу.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Вивести дані щодо версії і завершити роботу.
.RE
.SH "ПОПЕРЕДЖЕННЯ"
.sp
Use of \fBsetterm\fP in combination with stdout redirection can have unexpected results, as some options operate on stdin. To prevent problems, always redirect both stdin and stdout to the same device.
.SH "СУМІСНІСТЬ"
.sp
Починаючи з версії 2.25, у \fBsetterm\fP передбачено підтримку довгих параметрів із двома дефісами, наприклад \fB\-\-help\fP, окрім використаних у попередніх версіях довгих параметрів із одинарним дефісом, наприклад \fB\-help\fP. У скриптах краще використовувати зворотно сумісні одинарні дефіси, а не варіанти з подвійним дефісом. На сьогодні, немає планів і якихось вагомих причин для відмови від сумісності із параметрами із одинарними дефісами.
.SH "ВАДИ"
.sp
Відмінності між версіями для Minix і Linux не документовано.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.sp
\fBstty\fP(1),
\fBtput\fP(1),
\fBtty\fP(4),
\fBterminfo\fP(5)
.SH "ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ"
.sp
Для звітування щодо вад скористайтеся системою стеження за вадами \- \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "ДОСТУП ДО ПРОГРАМИ"
.sp
Програма \fBsetterm\fP є частиною пакунка util\-linux, який можна отримати з \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "архіву ядра Linux" "."