'\" t .\" ** The above line should force tbl to be a preprocessor ** .\" Man page for man .\" .\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.) .\" Copyright (C) 2001-2019 Colin Watson. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH MAN 1 2023-01-08 2.11.2 "Утилиты просмотра справочных страниц" .SH НАЗВАНИЕ man \- доступ к системным справочным страницам .SH СИНТАКСИС .\" The general command line .\" The apropos command line \fBman\fP [\|\fIпараметры man\fP\|] [\|[\|\fIраздел\fP\|] \fIстраница\fP\ \|.\|.\|.\|]\ .\|.\|.\& .br .\" The --global-apropos command line \fBman\fP \fB\-k\fP [\|\fIпараметры apropos\fP\|] \fIрегвыр\fP \&.\|.\|.\& .br .\" The whatis command line \fBman\fP \fB\-K\fP [\|\fIпараметры man\fP\|] [\|\fIраздел\fP\|] \fIтермин\fP\ .\|.\|.\& .br .\" The --local command line \fBman\fP \fB\-f\fP [\|\fIwhatis\fP \fIпараметры\fP\|] \fIстраница\fP \&.\|.\|.\& .br .\" The --where/--where-cat command line \fBman\fP \fB\-l\fP [\|\fIпараметры man\fP\|] \fIфайл\fP \&.\|.\|.\& .br \fBman\fP \fB\-w\fP\||\|\fB\-W\fP [\|\fIпараметры man\fP\|] \fIстраница\fP \&.\|.\|.\& .SH ОПИСАНИЕ \fBman\fP — это пейджер справочных страниц системы. Каждый параметр \fIстраница\fP, переданный \fBman\fP, обычно является названием программы, утилиты или функции. По каждому из этих параметров выполняется поиск и вывод связанной с ним \fIсправочной страницы\fP. Если указан параметр \fIраздел\fP, то это заставляет \fBman\fP выполнять поиск только в этом справочном \fIразделе\fP. Действием по умолчанию является поиск во всех доступных \fIразделах\fP в заранее определённом порядке (смотрите \fBDEFAULTS\fP) и показ только первой найденной \fIстраницы\fP, даже если существуют \fIстраницы\fP в нескольких \fIразделах\fP. В таблице ниже показаны номера справочных \fIразделов\fP и описание их содержимого. .TS tab (@); l lx. 1@T{ Исполняемые программы или команды оболочки (shell) T} 2@T{ Системные вызовы (функции, предоставляемые ядром) T} 3@T{ Библиотечные вызовы (функции, предоставляемые программными библиотеками) T} 4@T{ Специальные файлы (обычно находящиеся в каталоге \fI/dev\/\fP) T} 5@T{ Форматы файлов и соглашения, например о \fI/etc/passwd\fP T} 6@T{ Игры T} 7@T{ Разное (включает пакеты макросов и соглашения), например\& \fBman\fP(7), \fBgroff\fP(7), \fBman\-pages\fP(7) T} 8@T{ Команды администрирования системы (обычно, запускаемые только суперпользователем) T} 9@T{ Процедуры ядра [\|нестандартный раздел\|] T} .TE Справочная \fIстраница\fP состоит из нескольких разделов. Стандартные имена разделов: \fBНАЗВАНИЕ\fP (\fBNAME\fP), \fBСИНТАКСИС\fP (\fBSYNOPSIS\fP), \fBНАСТРОЙКИ\fP (\fBCONFIGURATION\fP), \fBОПИСАНИЕ\fP (\fBDESCRIPTION\fP), \fBПАРАМЕТРЫ\fP (\fBOPTIONS\fP), \fBКОД\ ВЫХОДА\fP (\fBEXIT\ STATUS\fP), \fBВОЗВРАЩАЕМОЕ\ ЗНАЧЕНИЕ\fP (\fBRETURN\ VALUE\fP), \fBОШИБКИ\fP (\fBERRORS\fP), \fBОКРУЖЕНИЕ\fP (\fBENVIRONMENT\fP), \fBФАЙЛЫ\fP (\fBFILES\fP), \fBВЕРСИИ\fP (\fBVERSIONS\fP), \fBСОГЛАСУЕТСЯ\ С\fP (\fBCONFORMING\ TO\fP), \fBЗАМЕЧАНИЯ\fP (\fBNOTES\fP), \fBОШИБКИ\fP (\fBBUGS\fP), \fBПРИМЕР\fP (\fBEXAMPLE\fP), \fBАВТОРЫ\fP (\fBAUTHORS\fP) и \fBСМОТРИТЕ\ ТАКЖЕ\fP (\fBSEE\ ALSO\fP). В разделе \fBСИНТАКСИС\fP используются следующие соглашения (которые также могут быть использованы в качестве основы для других разделов). .TS tab (@); l lx. \fBтекст жирным шрифтом\fP@T{ набирать точно как показано. T} \fIтекст курсивным шрифтом\fP@T{ заменить соответствующим значением. T} [\|\fB\-abc\fP\|]@T{ любой или все параметры внутри [ ] необязательны. T} \fB\-a\|\fP|\|\fB\-b\fP@T{ параметры, разделённые |, не могут указываться одновременно. T} \fIпараметр\fP .\|.\|.@T{ повторяющийся \fIпараметр\fP. T} [\|\fIвыражение\fP\|] .\|.\|.@T{ всё \fIвыражение\fP\ внутри [ ] может вводиться несколько раз. T} .TE Точная отрисовка может отличаться на разных устройствах вывода. Например, man, обычно, не способна вывести курсив в терминале, и вместо него выведет текст подчёркнутым или цветным. При объяснении команды или функции должен применяться шаблон, который точно описывает все возможные варианты вызова. В некоторых случаях рекомендуется показать несколько уникальных вызовов, как показано в разделе \fBСИНТАКСИС\fP этой справочной страницы. .SH ПРИМЕРЫ .TP \w'man\ 'u \fBman\fP\fI\ ls\fP Показать справочную страницу для \fIпараметра\fP (программы) \fIls\fP. .TP \fBman\fP \fIman\fP.\fI7\fP Показать справочную страницу пакета макросов \fIman\fP из раздела \fI7\fP (аналог команды "\fBman\fP \fI7 man\fP"). .TP \fBman '\fP\fIman\fP(\fI7\fP)' Показать справочную страницу пакета макросов \fIman\fP из раздела \fI7\fP (аналог команды "\fBman\fP \fI7 man\fP"; она удобнее для копирования и вставки перекрёстных ссылок в справочные страницы; заметим, что скобки нужно защищать кавычками из\-за оболочки). .TP \fBman\ \-a\fP\fI\ intro\fP Показать подряд все доступные справочные страницы по \fIintro\fP. В перерыве между показами можно пропустить следующую справочную страницу или закончить просмотр. .TP \fBman \-t \fP\fIbash \fP|\fI lpr \-Pps\fP Отформатировать справочную страницу для \fIbash\fP в формат по умолчанию \fBtroff\fP или \fBgroff\fP и передать её по каналу в принтер с именем \fIps\fP. Обычно, форматом вывода \fBgroff\fP по умолчанию является PostScript. По команде \fBman \-\-help\fP можно посмотреть какой процессор привязан к параметру \fB\-t\fP. .TP \fBman \-l \-T\fP\fIdvi ./foo.1x.gz\fP\fB > \fP\fI./foo.1x.dvi\fP Эта команда расжимает и форматирует справочную страницу в формате nroff \&\fI./foo.1x.gz\fP в файл в формате \fBнезависимом от устройства (dvi)\fP. Перенаправление вывода необходимо, так как при параметре \fB\-T\fP вывод направляется напрямую на \fBстандартный вывод\fP без пейджера. Результат может быть просмотрен с помощью, например, \fBxdvi\fP или преобразован в PostScript с помощью, например, \fBdvips\fP. .TP \fBman\ \-k\fP\fI\ printf\fP Искать в кратких описаниях и именах справочных страниц ключевое слово \fIprintf\fP, рассматриваемое как регулярное выражение. Показать любые найденные совпадения. Эквивалентно вызову \fBapropos\fP\fI\ printf\fP\fB.\fP .TP \fBman\ \-f\fP\fI\ smail\fP Искать справочные страницы, ссылающиеся на \fIsmail\fP и показать краткое описание любой найденной. Эквивалентно вызову \fBwhatis\fP\fI\ smail\fP\fB.\fP .SH ОБЗОР Многие параметры \fBman\fP предназначены для предоставления как можно большей гибкости пользователю. Можно изменять путь поиска, порядок разделов, выходной обработчик и другие характеристики и операции — всё это подробно описано ниже. В работе \fBman\fP могут использоваться различные переменные окружения. Возможно задать любые параметры во «всеобъемлющей» переменной $\fBMANOPT\fP, экранируя пробельные символы в значениях (с помощью обратной косой черты). \fBman\fP разбирает $\fBMANOPT\fP перед началом анализа параметров, переданных при вызове в командной строке. Все значения параметров, указанные в командной строке, заменят значения своих аналогов из переменной окружения. Для сброса всех параметров, установленных с помощью $\fBMANOPT\fP, можно указать параметр \fB\-D\fP в начале командной строки. Это позволит man «забыть» о значениях, указанных в $\fBMANOPT\fP, хотя они всё равно должны быть заданы правильно. Обычно, справочные страницы хранятся в формате \fBnroff\fP(1) в каталоге \fI/usr/share/man\fP. В некоторых установках для повышения производительности также могут существовать заранее отформатированные \fIстраницы cat\fP. Место хранения этих файлов описано в \fBmanpath\fP(5). Данный пакет обеспечивает поддержку справочных страниц на нескольких языках (через \fIлокаль\fP). Если система не настраивает её автоматически, то вам необходимо присвоить переменной $\fBLC_MESSAGES\fP, $\fBLANG\fP или другой переменной окружения (зависит от системы) значение локали предпочитаемого языка, обычно задаваемое в формате \fBPOSIX\fP: <\fIязык\fP>[\|\fB_\fP<\fIтерритория\fP>\|[\|\fB.\fP<\fIкодировка\fP>\|[\|\fB,\fP<\fIверсия\fP>\|]\|]\|] Если запрашиваемая страница доступна для вашей \fIлокали\fP, то она будет показана вместо стандартной (обычно, на американском английском) страницы. Если вы обнаружили, что этот пакет не переведён ваш язык и вы хотите сделать это, то свяжитесь с сопровождающим, который скоординирует данную работу. Отдельные справочные страницы пишутся и поддерживаются сопровождающими программы, функции или другой части, которую они описывают, и не включены в этот пакет. Если вы обнаружите отсутствие или некорректность справочной страницы, сообщите сопровождающим конкретного пакета. О других возможностях и расширениях, доступных в этом пейджере справочных страниц, читайте в описаниях из этого пакета. .SH "ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ" Порядок поиска по разделам можно изменить через переменную окружения $\fBMANSECT\fP или директиву \fBSECTION\fP в \fI/etc/manpath.config\fP. Значение по умолчанию следующее: .RS .if !'po4a'hide' 1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7 .RE Отформатированная справочная страница отображается \fIпейджером\fP. Его можно задать несколькими способами, в противном случае будет использовано значение по умолчанию (смотрите описание параметра \fB\-P\fP). Фильтры можно указывать разными способами. Во\-первых, обрабатывается значение параметра \fB\-p\fP или переменная окружения $\fBMANROFFSEQ\fP. Если \fB\-p\fP не указывалась и переменная окружения не установлена, то в поисках строки препроцессора анализируется первая строка nroff файла. Чтобы указывать строку препроцессора правильно, первая строка должна быть в формате \&\fB'\e"\fP <\fBстрока\fP> где \fBстрока\fP может содержать комбинацию букв, описанных в параметре \fB\-p\fP ниже. Если информация о фильтре нигде не указана, то используется набор по умолчанию. .\" ******************************************************************** Конвейер форматирования создаётся из фильтров и основной программы форматирования (\fBnroff\fP или [\fBtg\fP]\fBroff\fP с параметром \fB\-t\fP) и выполняется. Или же, если существует исполняемая программа \fImandb_nfmt\fP (или \fImandb_tfmt\fP с параметром \fB\-t\fP) в корне дерева справочных страниц, то выполняется именно она. Она получает файл с исходным текстом справочной страницы, строку препроцессора, и, необязательно, устройство, указанное в параметре \fB\-T\fP или \fB\-E\fP. .SH ПАРАМЕТРЫ Параметры без значений, повторяющиеся в командной строки, $\fBMANOPT\fP или обоих, не опасны. В случае с параметрами со значением, при каждом повторении новое значение заменяет имеющееся. .SS "Общие параметры" .TP \fB\-C\ \fP\fIфайл\fP,\ \fB\-\-config\-file=\fP\fIфайл\fP Использовать указанный пользовательский файл настройки вместо значения по умолчанию \fI~/.manpath\fP. .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Показывать отладочную информацию. .TP .if !'po4a'hide' .BR \-D ", " \-\-default Этот параметр обычно вводится самым первым, и указывает \fBman\fP активировать поведение по умолчанию. Он используется для сброса параметров, которые могли быть установлены через переменную окружения $\fBMANOPT\fP. Любые параметры, указанные после \fB\-D\fP, будут действовать как обычно. .TP \fB\-\-warnings\fP[=\fIпредупреждения\/\fP] Включить предупреждения от \fIgroff\fP. Это может быть использовано для проверки тривиальных ошибок в исходном тексте справочных страниц. \fIПредупреждения\fP представляют собой список названий предупреждений через запятую; если он не указан, то по умолчанию используется значение «mac». Полный список доступных предупреждений можно найти в \fBinfo groff\fP, раздел \(lqПредупреждения\(rq. .SS "Основные режимы работы" .TP .if !'po4a'hide' .BR \-f ", " \-\-whatis Эквивалентно работе \fBwhatis\fP. Отображает краткое описание из справочной страницы, если оно есть. Подробней смотрите \fBwhatis\fP(1). .TP .if !'po4a'hide' .BR \-k ", " \-\-apropos Эквивалентно работе \fBapropos\fP. Ищет в кратких описаниях справочных страниц ключевые слова и показывает любые совпадения. Подробней смотрите \fBapropos\fP(1). .TP .if !'po4a'hide' .BR \-K ", " \-\-global\-apropos Поиск текста во всех справочных страницах. Используется простой поиск перебором, что занимает определённое время; если можно, указывайте раздел для сокращения числа страниц, в которых нужно искать. Термины поиска могут быть простыми строками (по умолчанию), или регулярными выражениями, если указан параметр \fB\-\-regex\fP. .IP Заметим, что данный поиск выполняется по \fIисходному тексту\fP справочных страниц, а не по отображаемому тексту, и поэтому может включать ложные результаты, например, из\-за комментариев в исходных файлах. Поиск по отображаемому тексту выполнялся бы медленнее. .TP .if !'po4a'hide' .BR \-l ", " \-\-local\-file .\" Compressed nroff source files with a supported compression .\" extension will be decompressed by man prior to being displaying via the .\" usual filters. Включить «локальный» режим. Форматирует и показывает локальные справочные файлы, а не ищет их в справочной коллекции системы. Каждый параметр справочной страницы считается именем правильно отформатированного исходного файла nroff. Cat файлы не создаются. Если в качестве одного из параметров указан «\-», то данные будут взяты из стандартного входного потока. Если этот параметр не используется и man не может найти запрашиваемую страницу, то перед тем как показать сообщение об ошибке, будет предпринята попытка работать в локальном режиме, используя указанное имя в качестве имени файла для поиска. .TP .if !'po4a'hide' .BR \-w ", " \-\-where ", " \-\-path ", " \-\-location Не выводить содержимое справочной страницы, а показать место нахождения исходного файла nroff, который был бы отформатирован. Если также указан параметр \fB\-a\fP, то вывести расположения всех исходных файлов, которые подпадают под критерии поиска. .TP .if !'po4a'hide' .BR \-W ", " \-\-where\-cat ", " \-\-location\-cat Не выводить содержимое справочной страницы, а показать место нахождения отформатированного файла cat, который был бы показан. Если также указан параметр \fB\-a\fP, то вывести расположения всех отформатированных файлов, которые подпадают под критерии поиска. .IP Если указаны параметры \fB\-w\fP и \fB\-W\fP, и вывести исходный файл и файл cat, разделив их пробелом. Если указаны сразу \fB\-w\fP, \fB\-W\fP и \fB\-a\fP, то сделать это для каждого возможного совпадения. .TP .if !'po4a'hide' .BR \-c ", " \-\-catman Этот параметр не для обычного использования, и должен использоваться только программой \fBcatman\fP. .TP \fB\-R\ \fP\fIкодировка\fP,\ \fB\-\-recode\fP=\fIкодировка\fP Вместо обычного форматирования справочной страницы можно преобразовать исходный текст в заданную \fIкодировку\fP. Если вам уже известна кодировка исходного файла, то вы можете также использовать непосредственно \fBmanconv\fP(1). Однако, этот параметр позволяет преобразовывать несколько справочных страниц в одну кодировку без явного указания кодировки каждой страницы, предполагая, что они уже установлены в структуру, подобную иерархии справочных страниц. .IP Попробуйте использовать \fBman-recode\fP(1) вместо преобразования множества справочных страниц, так как его интерфейс разработан для группового преобразования и может выполнить эту задачу намного быстрее. .SS "Поиск справочных страниц" .TP \fB\-L\ \fP\fIлокаль\fP,\ \fB\-\-locale=\fP\fIлокаль\fP \fBman\fP, обычно, определяет текущую локаль с помощью вызова C\-функции \fBsetlocale\fP(3), которая исследует различные переменные окружения, возможно $\fBLC_MESSAGES\fP и $\fBLANG\fP. Для временной подмены полученного значения, используйте этот параметр, задающий \fIлокаль\fP только в \fBman\fP. Заметим, что это влияет только непосредственно на поиск страниц. Вывод сообщений программы, например справки, всегда будет выполняться для изначально определённой локали. .TP \fB\-m\fP \fIсистема\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIсистема\fP\|[\|,.\|.\|.\|] Если система имеет доступ к справочным страницам других операционных систем, то к ним можно обратиться с помощью этого параметра. Чтобы найти справочную страницу из коллекции страниц для операционной системы NewOS, укажите \fB\-m\fP \fBNewOS\fP. В значении \fIсистема\fP может указать несколько имён операционных систем через запятую. Чтобы включить поиск по справочным страницам родной операционной системы, добавьте системное имя \fBman\fP в это значение. Этот параметр заменяет значение переменной окружения $\fBSYSTEM\fP. .TP \fB\-M\ \fP\fIпуть\fP,\ \fB\-\-manpath=\fP\fIпуть\fP Задать альтернативный manpath для работы. По умолчанию, для определения пути поиска \fBman\fP использует \fBmanpath\fP, указанный в исходном коде программы. Этот параметр заменяет значение переменной окружения $\fBMANPATH\fP и выключает действие параметра \fB\-m\fP. Задаваемый в качестве manpath путь должен быть корнем иерархии справочных страниц, разделённой на разделы, описанных в справочной странице по man\-db (в разделе "Система справочных страниц"). Для просмотра справочных страниц вне этих иерархий, используйте параметр \fB\-l\fP. .TP \fB\-S\fP \fIсписок\/\fP, \fB\-s\fP \fIсписок\/\fP, \fB\-\-sections=\fP\fIсписок\/\fP Задаваемый \fIсписок\fP разделов, перечисляемых через запятую, используется для определения разделов руководства поиска и их порядка. Этот параметр заменяет значение переменной окружения $\fBMANSECT\fP (параметр \fB\-s\fP введён для совместимости с System V). .TP \fB\-e\ \fP\fIдоп.расширение\fP,\ \fB\-\-extension=\fP\fIдоп.расширение\fP Некоторые системы включают большое число пакетов справочных страниц, например таких, которые поставляются с пакетом \fBTcl\fP, в главную иерархию справочных страниц. Для решения проблемы появления двух справочных страниц с одинаковым именем, например, \fBexit\fP(3), все страницы \fBTcl\fP, обычно, помещаются в раздел \fBl\fP. Но для страниц такого типа уже определён правильный раздел (3). Теперь возможно помещать страницы в правильный раздел, и назначать им специальное «расширение», в данном случае, \fBexit\fP(3tcl). Обычно, \fBman\fP показывает \fBexit\fP(3), а не \fBexit\fP(3tcl). Чтобы преодолеть это и не запоминать в каком разделе лежит определённая страница, теперь возможно передать \fBman\fP строку \fIдоп.расширения\fP, указывающую какому пакету должна принадлежать страница. Возвращаясь к примеру выше, укажите параметр \fB\-e\ tcl\fP для \fBman\fP, чтобы ограничить поиск только страницами с расширением \fB*tcl\fP. .TP .if !'po4a'hide' .BR \-i ", " \-\-ignore\-case Игнорировать регистр при поиске справочных страниц. Включено по умолчанию. .TP .if !'po4a'hide' .BR \-I ", " \-\-match\-case Искать справочные страницы с учётом регистра символов. .TP .if !'po4a'hide' .B \-\-regex Показывает все страницы, у которых какая\-то часть в имени или в описании совпадает с параметром \fIстраница\fP, заданным в виде регулярного выражения, также как \fBapropos\fP(1). Так как, обычно, нет разумного способа определить "лучшую" страницу при поиске по регулярному выражению, то этот параметр подразумевает \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-wildcard Показывает все страницы, у которых какая\-то часть в имени или в описании совпадает с параметром \fIстраница\fP, заданным в виде групповых символов, также как в \fBapropos\fP(1) \fB\-\-wildcard\fP. Значение \fIстраница\fP должно полностью совпадать с именем или описанием, или совпадать по границе слов в описании. Так как, обычно, нет разумного способа определить "лучшую" страницу при поиске по регулярному выражению, то этот параметр подразумевает \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-names\-only Если указан параметр \fB\-\-regex\fP или \fB\-\-wildcard\fP, то совпадения ищутся только в именах страниц, а не в описании страницы, как в \fBwhatis\fP(1). Иначе, этого не происходит. .TP .if !'po4a'hide' .BR \-a ", " \-\-all По умолчанию, \fBman\fP завершает работу после показа наиболее подходящей найденной справочной страницы. Этот параметр заставляет \fBman\fP показать все справочные страницы с именами, которые удовлетворяют критериям поиска. .TP .if !'po4a'hide' .BR \-u ", " \-\-update Данный параметр заставляет \fBman\fP обновить свои кэши базы данные установленных справочных страниц. Это требуется очень редко и для этого, обычно, лучше запускать \fBmandb\fP(8). .TP .if !'po4a'hide' .B \-\-no\-subpages По умолчанию, \fBman\fP пытается интерпретировать пары имён справочных страниц, указанных в командной строке, как единое имя справочной страницы, содержащее символ переноса или подчёркивания. Это поддерживает общую систему программ, которые имеют несколько подкоманд, позволяя для каждой из них предоставлять справочные страницы используя синтаксис, похожий на вызов самих подкоманд. Например: .nf .if !'po4a'hide' \& $ man \-aw git diff .if !'po4a'hide' \& /usr/share/man/man1/git\-diff.1.gz .fi Чтобы выключить такое поведение, укажите параметр \fB\-\-no\-subpages\fP. .nf .if !'po4a'hide' \& $ man \-aw \-\-no\-subpages git diff .if !'po4a'hide' \& /usr/share/man/man1/git.1.gz .if !'po4a'hide' \& /usr/share/man/man3/Git.3pm.gz .if !'po4a'hide' \& /usr/share/man/man1/diff.1.gz .fi .SS "Контролирование форматированного вывода" .TP \fB\-P\ \fP\fIпейджер\fP,\ \fB\-\-pager=\fP\fIпейджер\fP Указывает, какой пейджер использовать для вывода. По умолчанию, \fBman\fP использует \fBpager\fP и применяет \fBcat\fP, если \fBpager\fP не найден или не является исполняемым файлом. Этот параметр заменяет значение переменной окружения $\fBMANPAGER\fP которая, в свою очередь, заменяет значение переменной окружения $\fBPAGER\fP. Не используется вместе с \fB\-f\fP или \fB\-k\fP. Значением может быть просто имя команды или команды с параметрами, можно использовать экранирование интерпретатора команд (обратные слэши, одиночные кавычки или двойные кавычки). Нельзя объединять несколько команд каналами; если эту нужно, создайте сценарий\-обёртку, который получает файл для показа в виде параметра или со стандартного ввода. .TP \fB\-r\ \fP\fIприглашение\fP,\ \fB\-\-prompt=\fP\fIприглашение\fP Если в качестве пейджера используется новая версия \fBless\fP, то \fBman\fP будет пытаться установить ей формат приглашения и некоторые значимые параметры. По умолчанию приглашение выглядит как \fB Manual page\fP\fI имя\fP\fB(\fP\fIраздел\fP\fB) line\fP\fI x\fP .\"The default options are .\".BR \-six8 . .\"The actual default will depend on your chosen .\".BR locale . где \fIимя\fP это имя справочной страницы, \fIраздел\fP — раздел, в котором она была найдена и \fIx\fP — номер текущей строки. Приглашение устанавливается с помощью переменной окружения $\fBLESS\fP. .\"You may need to do this if your .\"version of .\".B less .\"rejects the default options or if you prefer a different prompt. Данное значение по умолчанию можно изменить с помощью параметра \fB\-r\fP. Значение параметра может содержать текст \fB$MAN_PN\fP, вместо которого подставляется имя текущей справочной страницы и её название раздела, окружённое «(» и «)». Строка, используемая для создания приглашения по умолчанию, могла бы выглядеть как \fB\e\ Справочная\e\ страница\e\ \e$MAN_PN\e\ ?ltстрока\e\ %lt?L/%L.:\fP .br \fBbyte\e\ %bB?s/%s..?\e\ (ВСЕ):?pB\e\ %pB\e\e%..\fP .br \fB(h — справка, q — выход)\fP Здесь она разделена на три строки только для повышения читаемости. Описание её составных частей смотрите в справочной странице \fBless\fP(1). Строка приглашения сначала обрабатывается оболочкой командной строки. Все двойные кавычки, обратные кавычки и обратные косые черты в приглашении должны предваряться обратными косыми чертами для экранирования. Строка приглашения может заканчиваться экранированным $, за которым можно указать другие параметры less. По умолчанию, \fBman\fP указывает параметры \fB\-ix8\fP. Переменная окружения $\fBMANLESS\fP, описанная ниже, может использоваться для назначения строки приглашения по умолчанию, если это не задано в командной строке. .TP .if !'po4a'hide' .BR \-7 ", " \-\-ascii При просмотре справочной страницы в изначальной кодировке \fIascii\fP(7) на 7\-битном терминале или эмуляторе терминала при использовании описания устройства \fIlatin1\fP(7) с \fBGNU\fP \fBnroff\fP некоторые символы могут неправильно отображаться . Этот параметр позволяет справочным страницам в изначальной \fIascii\fP отображаться в \fIascii\fP, используя устройство \fIlatin1\fP. Любой \fIlatin1\fP текст не будет транслироваться. Следующая таблица показывает выполняемые трансляции: некоторые её части могут отображаться правильно только при использовании \fBGNU\fP \fBnroff\fP устройства \fIlatin1\fP(7). .ie c \[shc] \ . ds softhyphen \[shc] .el \ . ds softhyphen \(hy .na .TS tab (@); l c c c. Описание@Восьмеричный код@latin1@ascii _ T{ длинный перенос T}@255@\*[softhyphen]@- T{ bullet (точка в центре) T}@267@\(bu@o T{ значок ударения T}@264@\(aa@' T{ знак ударения T}@327@\(mu@x .TE .ad Если колонка \fIlatin1\fP отображается правильно, то ваш терминал может быть настроен для отображения символов \fIlatin1\fP и этот параметр ненужен. Если колонки \fIlatin1\fP и \fIascii\fP одинаковы, то вы читаете эту страницу с помощью данного параметра, или \fBman\fP не отформатировал страницу с помощью описания устройства \fIlatin1\fP. Если колонка \fIlatin1\fP отсутствует или повреждена, то вам может потребоваться просматривать справочные страницы с помощью этого параметра. Этот параметр игнорируется при использовании параметров \fB\-t\fP, \fB\-H\fP, \fB\-T\fP или \fB\-Z\fP, и может быть бесполезен для \fBnroff\fP, если он не от \fBGNU\fP. .TP \fB\-E\ \fP\fIкодировка\fP,\ \fB\-\-encoding\fP=\fIкодировка\fP Сгенерировать вывод в символьной кодировке, отличной от используемой по умолчанию. Кроме реальной символьной кодировки, типа \fBUTF\-8\fP, для обратной совместимости в \fIкодировке\fP можно указывать устройство \fBnroff\fP, например, \fBascii\fP, \fBlatin1\fP или \fButf8\fP. .TP .if !'po4a'hide' .BR \-\-no\-hyphenation ", " \-\-nh Обычно, \fBnroff\fP автоматически разбивает текст при окончании строки даже на словах, у которых нет переносов, если это необходимо для размещения слов в строке для избежания лишних пробелов. Этот параметр отключает автоматический перенос; в результате перенос выполняется только для слов, в которых есть символы переноса. Если вы пишите справочную страницу и просто хотите отключить в \fBnroff\fP перенос в словах в неподходящем месте, не используйте этот параметр, а почитайте документацию к \fBnroff\fP; например, вы можете поместить "\e%" внутрь слова в место возможного разрыва, или поместить "\e%" в начало слова, что не даст его разорвать совсем. .TP .if !'po4a'hide' .BR \-\-no\-justification ", " \-\-nj Обычно, \fBnroff\fP автоматически выравнивает текст по обеим границам. Этот параметр выключает полное выравнивание, оставляя выравнивание по левому краю, получается так называемый текст "без выключки по правому краю". Если вы пишите справочную страницу и просто хотите отключить в \fBnroff\fP выравнивание в некоторых параграфах, не используйте этот параметр, а почитайте документацию к \fBnroff\fP; например, вы можете использовать запросы ".na", ".nf", ".fi", и ".ad" для временного отключения выравнивания и заполнения. .TP \fB\-p\ \fP\fIстрока\fP,\ \fB\-\-preprocessor=\fP\fIстрока\fP Задать последовательность препроцессоров для запуска перед \fBnroff\fP или \fBtroff\fP/\fBgroff\fP. Не во всех системах имеется полный набор препроцессоров. Некоторые препроцессоры и буквы, используемые для их обозначения: \fBeqn\fP (\fBe\fP), \fBgrap\fP (\fBg\fP), \fBpic\fP (\fBp\fP), \fBtbl\fP (\fBt\fP), \fBvgrind\fP (\fBv\fP), \fBrefer\fP (\fBr\fP). Этот параметр заменяет значение переменной окружения $\fBMANROFFSEQ\fP. \fBzsoelim\fP запускается всегда в качестве первого очень быстрого препроцессора. .TP .if !'po4a'hide' .BR \-t ", " \-\-troff Использовать \fIgroff \-mandoc\fP для форматирования справочной страницы и вывода в стандартный выходной поток. Этот параметр не требуется вместе с \fB\-H\fP, \fB\-T\fP или \fB\-Z\fP. .TP \fB\-T\fP[\fIустройство\/\fP], \fB\-\-troff\-device\fP[=\fIустройство\/\fP] Этот параметр используется для замены вывода \fBgroff\fP (или, возможно, \fBtroff\fP) на более подходящий для устройства, отличного от используемого по умолчанию. Подразумевается \fB\-t\fP. Примеры (предоставляются с Groff\-1.17) включают \fBdvi\fP, \fBlatin1\fP, \fBps\fP, \fButf8\fP, \fBX75\fP и \fBX100\fP. .TP \fB\-H\fP[\fIбраузер\/\fP], \fB\-\-html\fP[=\fIбраузер\/\fP] Этот параметр заставляет \fBgroff\fP создавать HTML \-страницу, и отображать её в веб\-браузере. Выбор браузера определяется необязательным значением \fIбраузер\fP, переменной окружения $\fBBROWSER\fP, или, если ничего не указано, значением по умолчанию, установленным при компиляции программы (обычно \fBlynx\fP). Этот параметр предполагает \fB\-t\fP, и работает только с \fBGNU\fP \fBtroff\fP. .TP \fB\-X\fP[\fIdpi\/\fP], \fB\-\-gxditview\fP[=\fIdpi\/\fP] С этим параметром вывод \fBgroff\fP осуществляет в графическое окно с помощью программы \fBgxditview\fP. Значениями \fIdpi\fP (точек на дюйм) могут быть 75, 75\-12, 100 или 100\-12; по умолчанию 75; в вариантах с \-12 в конце используется базовый шрифт в 12 точек. Этот параметр подразумевает \fB\-T\fP со значениями устройств X75, X75\-12, X100 и X100\-12 соответственно. .TP .if !'po4a'hide' .BR \-Z ", " \-\-ditroff \fBgroff\fP запустит \fBtroff\fP, а затем использует соответствующий постпроцессор для создания результата, подходящего для выбранного устройства. Если \fIgroff \-mandoc\fP совпадает с \fBgroff\fP, то данный параметр передаётся \fBgroff\fP и использование постпроцессора отменяется. Подразумевает \fB\-t\fP. .SS "Выдача справки" .TP .if !'po4a'hide' .BR \-? ", " \-\-help Показать справочное сообщение и закончить работу. .TP .if !'po4a'hide' .B \-\-usage Показать короткое сообщение об использовании и завершить работу. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Показать информацию о версии. .SH "КОД ВЫХОДА" .TP .if !'po4a'hide' .B 0 Успешное выполнение программы. .TP .if !'po4a'hide' .B 1 Была показана справка об использовании, произошла синтаксическая ошибка или проблемы в файле настройки. .TP .if !'po4a'hide' .B 2 Ошибка при работе. .TP .if !'po4a'hide' .B 3 Дочерний процесс завершился с ненулевым кодом выхода. .TP .if !'po4a'hide' .B 16 По крайней мере одна из страниц/файлов/ключевых слов не существует или для неё при поиске ничего не найдено. .SH ОКРУЖЕНИЕ .\".TP \w'MANROFFSEQ\ \ 'u .TP .if !'po4a'hide' .B MANPATH Если установлена переменная окружения $\fBMANPATH\fP, то её значение используется в качестве пути поиска справочных страниц. О том, как используется эта переменная окружения и поведение по умолчанию, смотрите раздел \fBПУТЬ ПОИСКА\fP в \fBmanpath\fP(5). .TP .if !'po4a'hide' .B MANROFFOPT Всякий раз, когда \fBman\fP вызывает программу форматирования (\fBnroff\fP, \fBtroff\fP или \fBgroff\fP) в её командную строку добавляется содержимое $\fBMANROFFOPT\fP. .TP .if !'po4a'hide' .B MANROFFSEQ Если установлена переменная окружения $\fBMANROFFSEQ\fP, то её значение используется для определения набора препроцессоров для обработки каждой справочной страницы. Список препроцессоров по умолчанию зависит от системы. .TP .if !'po4a'hide' .B MANSECT Если установлена переменная окружения $\fBMANSECT\fP, то её значением является список разделов, указанных через двоеточие, и она используется для задания разделов справочных страниц, в которых будет производится поиск и в каком порядке. Значением по умолчанию является «1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7», если оно не заменено директивой \fBSECTION\fP в \fI/etc/manpath.config\fP. .TP .if !'po4a'hide' .BR MANPAGER , " PAGER" Если установлена переменная окружения $\fBMANPAGER\fP или $\fBPAGER\fP ($\fBMANPAGER\fP просматривается первой), то в ней задано имя программы для отображения справочной страницы. По умолчанию, используется \fBpager\fP или \fBcat\fP, если \fBpager\fP не найден или не является исполняемым файлом. Значением может быть просто имя команды или команды с параметрами, можно использовать экранирование интерпретатора команд (обратные слэши, одиночные кавычки или двойные кавычки). Нельзя объединять несколько команд каналами; если эту нужно, создайте сценарий\-обёртку, который получает файл для показа в виде параметра или со стандартного ввода. .TP .if !'po4a'hide' .B MANLESS Если установлена переменная окружения $\fBMANLESS\fP, то её значение будет использоваться по умолчанию как строка приглашения для пейджера \fBless\fP, как если бы был указан параметр \fB\-r\fP (так что любые появления текста \fB$MAN_PN\fP будут как\-то раскрыты). Например, если вы хотите установить строку приглашения дословно в \(lqmy prompt string\(rq, то установите $\fBMANLESS\fP равной \(oq\fB\-Psmy\ prompt\ string\fP\(cq. Указанное значение параметра \fB\-r\fP замещает значение переменной окружения. .TP .if !'po4a'hide' .B BROWSER Если установлена переменная окружения $\fBBROWSER\fP, то её значение представляет собой список команд, разделяемых двоеточием; каждая из них используется для попытки запуска веб\-браузера для \fBman\fP \fB\-\-html\fP. В каждой команде \fI%s\fP заменяется именем файла, содержащим HTML результат от \fBgroff\fP, \fI%%\fP заменяется одним знаком процента (%), а \fI%c\fP заменяется двоеточием (:). .TP .if !'po4a'hide' .B SYSTEM Установка значения переменной окружения $\fBSYSTEM\fP равносильна указанию параметра \fB\-m\fP. .TP .if !'po4a'hide' .B MANOPT Если установлена переменная окружения $\fBMANOPT\fP, то она анализируется раньше командной строки \fBman\fP и должна задаваться в том же формате. Значения всех специальных переменных окружения \fBman\fP могут быть заданы в параметрах командной строки, а включение в $\fBMANOPT\fP показывает, что данный параметр скоро устареет. Обратите особое внимание на то, что все пробелы, которые должны быть частью значения параметра, нужно экранировать. .TP .if !'po4a'hide' .B MANWIDTH Если установлена переменная окружения $\fBMANWIDTH\fP, то её значение используется в качестве длины строки форматируемых справочных страниц. Если она не установлена, то справочные страницы будут отформатированы по длине строки текущего терминала (используется значение переменной $\fBCOLUMNS\fP, и вызов \fBioctl\fP(2), если он доступен, или 80 символов, если ничего недоступно). Cat страницы будут сохраняться на диск только, если может быть использовано форматирование по умолчанию, то есть когда длина строки терминала лежит в промежутке между 66 и 80 символами. .TP .if !'po4a'hide' .B MAN_KEEP_FORMATTING Обычно, если вывод не направляется на терминал (например, в файл или канал), символы форматирования отбрасываются для облегчения чтения результата не имея специальных инструментов. Однако, если переменная окружения $\fBMAN_KEEP_FORMATTING\fP установлена в непустое значение, то символы форматирования остаются. Это может быть полезно для оболочек вокруг \fBman\fP, которые распознают символы форматирования. .TP .if !'po4a'hide' .B MAN_KEEP_STDERR Обычно, если вывод направляется на терминал (например, в пейджер), все ошибки вывода команды, используемой для создания форматированного варианта справочной страницы, отбрасываются во избежании порчи отображаемого текста. Программы типа \fBgroff\fP часто выводят относительно безобидные сообщения об ошибках, например о печатных проблемах плохого выравнивания вперемешку с информацией справочной страницы. Однако, некоторые пользователи всё равно хотели бы их видеть, и поэтому, если установить переменную окружения $\fBMAN_KEEP_STDERR\fP в непустое значение, вывод ошибок будет производиться как обычно. .TP .if !'po4a'hide' .B MAN_DISABLE_SECCOMP В Linux, \fBman\fP, обычно, ограничивает подпроцессы, работающие с ненадёжными данными, с помощью изолированной среды \fBseccomp\fP(2). Это позволяет безопасно запускать сложный код разбора произвольных справочных страниц. Если это приводит к ошибке по причине не связанной с содержимым отображаемой справочной страницы, то изолированную среду можно отключить, указав непустое значение в переменной $\fBMAN_DISABLE_SECCOMP\fP. .TP .if !'po4a'hide' .B PIPELINE_DEBUG Если переменная окружения $\fBPIPELINE_DEBUG\fP равна «1», то \fBman\fP выведет отладочные сообщения в стандартный поток ошибок из каждого запускаемого подпроцесса. .TP .if !'po4a'hide' .BR LANG , " LC_MESSAGES" В зависимости от системы и реализации, одна или обе переменные $\fBLANG\fP и $\fBLC_MESSAGES\fP будут просмотрены для определения текущей локали сообщений. \fBman\fP будет отображать свои сообщения в этой локали (если они для неё есть). Подробней смотрите в \fBsetlocale\fP(3). .SH ФАЙЛЫ .TP .if !'po4a'hide' .I /etc/manpath.config Файл настройки man\-db. .TP .if !'po4a'hide' .I /usr/share/man Глобальная иерархия справочных страниц. .SH "СМОТРИТЕ ТАКЖЕ" .if !'po4a'hide' .BR apropos (1), .if !'po4a'hide' .BR groff (1), .if !'po4a'hide' .BR less (1), .if !'po4a'hide' .BR manpath (1), .if !'po4a'hide' .BR nroff (1), .if !'po4a'hide' .BR troff (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR zsoelim (1), .if !'po4a'hide' .BR manpath (5), .if !'po4a'hide' .BR man (7), .if !'po4a'hide' .BR catman (8), .if !'po4a'hide' .BR mandb (8) .PP Документация на некоторые пакеты может быть доступна в других форматах, например, \fBinfo\fP(1) или HTML. .SH ИСТОРИЯ 1990, 1991 \(en изначально написана Джоном В.\& Итоном (John W. Eaton, jwe@che.utexas.edu). 23 декабря 1992: Рик Фейт (Rik Faith, faith@cs.unc.edu) исправил ошибки, найденные Виллемом Касдорпом (Willem Kasdorp, wkasdo@nikhefk.nikef.nl). 30 апреля 1994 \(en 23 февраля 2000: Вильф (Wilf.\& G.Wilford@ee.surrey.ac.uk) разрабатывал и сопровождал этот пакет с помощью некоторых других людей. 30 октября 1996 \(en 30 марта 2001: Фабрицио Полако (Fabrizio Polacco, сопровождал и улучшал этот пакет для проекта Debian с помощью всего сообщества. 31 марта 2001 \(en настоящие дни: Колин Уотсон (Colin Watson, занимается разработкой и сопровождением man\-db. .SH ОШИБКИ .if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db