Использование 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