Использование manual pages — man

Автор: | 03/02/2013

manualДля поиска по страницам руководства используйте следующие команды:

apropos — поиск во всех названиях и описаниях man-страниц, которые включают в себя указанное слово;
whatis — такой же поиск, но в результатах указываются только те страницы, в котороых указанное слово встречается целиком.

Например:

$ apropos man

ALTQ(9)                  — kernel interfaces for manipulating output queues on network interfaces
BUS_READ_IVAR(9), BUS_WRITE_IVAR(9) — manipulate bus-specific device instance variables
DB_COMMAND(9), DB_SHOW_COMMAND(9), DB_SHOW_ALL_COMMAND(9) — Extends the ddb command set
VFS_QUOTACTL(9)          — manipulate file system quotas
acpi(4)                  — Advanced Configuration and Power Management support
acpi_thermal(4)          — ACPI thermal management subsystem
acpiconf(8)              — control ACPI power management
adduser(8)               — command for adding new users

и т.д., всего — 281 совпадение.

Аналогичное дейтсвие выполняется с помощью ключа -k:

$ man -k man

Тогда как whatis выполнит более точный поиск:

$  whatis man

catman(1)                — preformat man pages
groff_man(7)             — groff `man‘ macros to support generation of man pages
man(1)                   — display online manual documentation pages
man.conf(5)              — man(1) and manpath(1) configuration files
mysqlman(1)              — default man page for mysql
Pod::Man(3)              — Convert POD data to formatted *roff input
Pod::Perldoc::ToMan(3)   — let Perldoc render Pod as man pages

Всего 7 совпадений.

Руководство имеет девять разделов:

1. General commands — основные команды;
2. System calls and error numbers — системные вызовы и коды ошибок;
3. The C libraries — библиотеки С;
4. Devices and device drivers — устройства и драйверы устройств;
5. File formats — форматы файлов;
6. Games instructions — иструкции к играм;
7. Miscellaneous information — различная информация;
8. System maintenance commands — команды обслуживания системы;
9. Kernel system interfaces — системные интерфейсы ядра.

Для каждой страницы руководства после названия указан номер раздела, к которой эта страница относится.

Например:

$ whatis ab

ab(8)                    — Apache HTTP server benchmarking tool

Раздел 8 — System maintenance commands.

$ whatis top

top(1)                   — display and update information about the top cpu processes

Раздел 1 — General commands — основные команды

Для указания точного раздела, из которого требуется вывести страницу руководства — укажите номер после слова man. К примеру, для команды less существуют несколько страниц руководства:

floor(3), floorf(3), floorl(3) — largest integral value less than or equal to x
less(1)                  — opposite of more
lesskey(1)               — specify key bindings for less
trunc(3), truncf(3), truncl(3) — nearest integral value with magnitude less than or equal to |x|
less(3)                  — perl pragma to request less of something

Если требуется прочитать страницу руководства именно по средству просмотра файлов — то выполните:

$ man 1 less

LESS(1)                                                                LESS(1)
NAME
less — opposite of more

Команда:

$ man 3 less

Выдаст страницу:

less(3)                Perl Programmers Reference Guide                less(3)
NAME
less — perl pragma to request less of something

Для поиска по странице руководства используется символ /, после ввода которого можно ввести слово для поиска. Что бы продолжить поиск по странице с уже введённым текстом — используйте клавишу N.

Просмотр man-страниц осуществляется с помощью указанной в файле конфигурации пользователя программы, например:

# cat /root/.bashrc

export PAGER=most

Хотя по-умолчанию обычно используется:

PAGER   more