Документация Linux

Man-страницы

Вместе с дистрибутивами GNU/Linux устанавливается большое число консольных утилит, выполняемых в Bash-оболочке. Кроме того, множество программ потом устанавливает сам пользователь. В связи с этим невозможно запомнить весь перечень команд с их параметрами. Поэтому для каждой программы должна иметься страница документации, так называемая man-страница. Здесь man – это сокращение от слова manual (руководство, пособие).

Доступ к этим страницам осуществляется с помощью одноименной программы man. В качестве аргумента ей передается имя команды, информацию о которой мы хотим получить. Например, man date или man cat.

На скриншоте показана страница документации к утилите sleep, входящей в GNU/Linux. Страница открывается по команде man sleep и является одной из самых коротких. Здесь мы можем видеть всю структуру man-страницы, состоящей из следующих разделов:

  1. NAME. Имя команды, и кратко что она делает.

  2. SYNOPSIS. Варианты синтаксиса, т. е. способов записи, команды. Параметры без скобок являются обязательными. В квадратных скобках – необязательными (опциональными).

  3. DESCRIPTION. Подробное описание программы и ее ключей.

  4. AUTHOR. Разработчик программы.

  5. REPORTING BUGS. Куда сообщать об ошибках.

  6. COPYRIGHT. Авторские права на программу, лицензия, под которой она распространяется.

  7. SEE ALSO. Дополнительная информация.

Данные разделы стандартны и характерны для всех man-страниц.

Обратите внимание, в первой строке мана пишется имя программы и в скобках ставится число. Так в примере выше написано SLEEP(1). Число обозначает раздел, к которому относится данная страница документации Linux. Пользовательские утилиты относятся к разделу под номером 1.

Если посмотреть документацию к программе apt-get, с помощью которой во многих дистрибутивах Linux устанавливается ПО, то там будет стоять число 8. К восьмому разделу относятся программы администрирования системы, то есть выполняемые с правами суперпользователя (root'а).

Большинство man-страниц достаточно длинные и не помещаются на одном экране. Поэтому пользуются горячими клавишами навигации по документации:

Есть и другие клавиши управления.

В зависимости от дистрибутива часть страниц может быть переведена на русский язык. Однако большинство, как и почти вся документация в сфере IT, написаны на английском языке.

Документация Info

Info-руководство – другой вариант документации команд Linux. Описание команд в info менее формализовано и поэтому зачастую более понятно.

Команда вида info имя_программы откроет ту часть info-документации, где начинается описание указанной программы.

На скрине info-страница для утилиты yes.

Info-руководство – по-сути один большой гипертекстовый сборник, в котором можно перемещаться по ссылкам. Для этого надо установить курсор в подчеркнутую фразу, начинающуюся с *, и нажать Enter. В отличие от info-документации каждая man-страница является независимым документом.

С помощью клавиши u можно подняться на самый верхний уровень info-документации Linux. Клавиши n и p перемещают вниз и вверх от статьи к статье (должна быть включена английская раскладка клавиатуры). На изображении ниже показано начало самого верхнего уровня иерархии страниц info.

Опция --help

У многих команд есть ключ --help, который позволяет быстро получить краткую справку. Информация выводится тут же в терминал, и остается видимой во время написания следующей команды. Нередко --help выдает русифицированную справку.

Команда apropos

Может возникнуть ситуация, когда требуется выполнить какую-либо задачу, а есть ли программа для этого, и как она называется, неизвестно. В таких случаях можно попробовать поискать с помощью утилиты apropos. Она выводит на экран краткие описания команд, содержащие строку, переданную ей в качестве аргумента.

Допустим нам надо проверить, есть ли каком-то файле повторяющиеся строки. По английски "повторять, повторение" – repeat. Следовательно, команда поиска подходящей программы будет выглядеть так: apropos repeat.

Нашлось четыре программы, из которых очевидно нам подходит uniq. Получив по ней справку, выясняем, что ключ -d позволяет выводить только повторяющиеся строки.

Примечание. Аналогично apropos'у работает утилита man с ключом -k.

Курс с ответами к заданиям и дополнительными уроками в PDF


Введение в Linux и Bash. Курс

Все разделы сайта