Например: man(1)
, find(3)
, updatedb(2)
?
Что означают числа в скобках (брит. «Скобки»)?
Например: man(1)
, find(3)
, updatedb(2)
?
Что означают числа в скобках (брит. «Скобки»)?
Ответы:
Это раздел, которому назначена страница руководства для команды.
Они разделены как
Оригинальные описания каждого раздела можно увидеть в Руководстве программиста Unix (стр. Ii).
man 5 foo
Раздел команды документирован в руководстве. Список разделов документирован в мужском руководстве. Например:
man 1 man
man 3 find
Это полезно, когда в разных секциях существуют одинаковые или точно одинаковые команды
Причина, по которой номера разделов являются значительными, заключается в том, что много лет назад, когда дисковое пространство было более серьезной проблемой, чем сейчас, разделы можно было устанавливать по отдельности.
Например, во многих системах были установлены только 1 и 8. В эти дни люди склонны искать команды в Google вместо этого.
Указывает раздел справочных страниц, в которых находится команда. Ключ -s команды man можно использовать для ограничения поиска определенными разделами.
Когда вы просматриваете справочную страницу, в верхнем левом углу отображается название раздела, например:
Пользовательские команды printf (1)
Стандартные функции библиотеки C printf (3C)
Поэтому, если вы пытаетесь найти функции C и не хотите случайно увидеть страницу для пользовательской команды с таким же именем, вы должны выполнить 'man -s 3C ...'
Как говорит @Ian G , это разделы справочной страницы. Давайте сделаем еще один шаг вперед:
man man
, и она показывает 9 разделов следующим образом:DESCRIPTION
man is the system's manual pager. Each page argument given
to man is normally the name of a program, utility or func‐
tion. The manual page associated with each of these argu‐
ments is then found and displayed. A section, if provided,
will direct man to look only in that section of the manual.
The default action is to search in all of the available sec‐
tions following a pre-defined order ("1 n l 8 3 2 3posix 3pm
3perl 5 4 9 6 7" by default, unless overridden by the SEC‐
TION directive in /etc/manpath.config), and to show only the
first page found, even if page exists in several sections.
The table below shows the section numbers of the manual fol‐
lowed by the types of pages they contain.
1 Executable programs or shell commands
2 System calls (functions provided by the kernel)
3 Library calls (functions within program libraries)
4 Special files (usually found in /dev)
5 File formats and conventions eg /etc/passwd
6 Games
7 Miscellaneous (including macro packages and conven‐
tions), e.g. man(7), groff(7)
8 System administration commands (usually only for root)
9 Kernel routines [Non standard]
A manual page consists of several sections.
man <section_num> <cmd>
Представим, что вы гуглите по командам Linux. Вы можете найти эту OPEN(2)
страницу в Интернете по адресу : http://man7.org/linux/man-pages/man2/open.2.html .
Чтобы увидеть это на страницах руководства на вашем компьютере, просто введите man 2 open
.
Для FOPEN(3)
использования man 3 fopen
и т. Д.
man <section_num> intro
Для чтения интро страниц в разделе, ввести man <section_num> intro
, например man 1 intro
, man 2 intro
, man 7 intro
и т.д.
Чтобы просмотреть все вводные страницы руководства последовательно, один за другим, сделайте man -a intro
. Начальная страница для Раздела 1 откроется. Нажмите, qчтобы выйти, затем нажмите, Enterчтобы просмотреть вступление к Разделу 8. Нажмите, qчтобы выйти, а затем нажмите, Enterчтобы просмотреть вступление к Разделу 3. Продолжайте этот процесс до завершения. Каждый раз после нажатия qвы будете возвращаться к главному экрану терминала, но вы все равно будете в интерактивном режиме и увидите следующую строку:
--Man-- next: intro(8) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]
Обратите внимание, что порядок раздела, который man -a intro
проведет вас через:
Этот порядок поиска является преднамеренным, поскольку man man
страница объясняет:
The default action is to search in all of the available sections follow‐
ing a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 5 4 9 6 7" by default, unless overrid‐
den by the SECTION directive in /etc/manpath.config)
Википедия подробно о разделах руководства: