Например: man (1), find (3), updatedb (2)? Что означают цифры в скобках ( "скобки" )?
Что означает число в круглых скобках, указанное после имен команд Unix в manpages?
Ответ 1
Это раздел, которому назначена справочная страница для команды.
Они делятся как
- Общие команды
- Системные вызовы
- Библиотечные функции C
- Специальные файлы (обычно устройства, найденные в /dev ) и драйверы
- Форматы файлов и условные обозначения
- Игры и скринсейверы
- Разное
- Команды и демоны системного администрирования
Исходные описания каждого раздела можно увидеть в Unix Programmer Manual (страница ii).
Ответ 2
Раздел, описанный в руководстве. Список разделов документируется в руководстве пользователя. Например:
man 1 man
man 3 find
Это полезно, когда похожие или точно равные команды существуют в разных разделах
Ответ 3
Причина, по которой номера разделов значительны, заключается в том, что много лет назад, когда дисковое пространство было больше проблемой, чем сейчас, секции могут быть установлены индивидуально.
Во многих системах только 1 и 8 установлены, например. В наши дни люди обычно смотрят команды на google.
Ответ 4
Обратите также внимание на то, что в других униксах метод указания раздела отличается. Например, на солярии это:
man -s 1 man
Ответ 5
Он указывает раздел страниц руководства, в котором находится команда. Переключатель -s команды man может использоваться для ограничения поиска в определенных разделах.
Когда вы просматриваете страницу руководства, в левом верхнем углу отображается название раздела, например:
Пользовательские команды printf (1)
Стандартные функции библиотеки C printf (3C)
Итак, если вы пытаетесь найти функции C и не хотите случайно видеть страницу для пользовательской команды, которая имеет одно и то же имя, вы бы сделали "man -s 3C..."
Ответ 6
Wikipedia подробности о разделах руководства:
- Общие команды
- Системные вызовы
- Функции библиотеки, охватывающие, в частности, стандартную библиотеку C
- Специальные файлы (обычно устройства, найденные в /dev ) и драйверы
- Форматы файлов и условные обозначения
- Игры и скринсейверы
- Разное
- Команды и демоны системного администрирования
Ответ 7
Как говорит @Ian G, это разделы справочной страницы. Давайте сделаем еще один шаг вперед:
1. См. справочную страницу для команды man с man man
, и она показывает 9 разделов следующим образом:
DESCRIPTION
man is the system 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.
2. 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
и т.д.
3. 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
проведет вас, следующий:
- Раздел 1
- Раздел 8
- Раздел 3
- Раздел 2
- Раздел 5
- Раздел 4
- Раздел 6
- Раздел 7
Этот порядок поиска является преднамеренным, как объясняется на странице 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)
Связанный:
- Поиск в Google "linux, что означает число в скобках после функции?" - https://www.google.com/search?q=linux+what+does+the+number+mean+in+parenthesis+after+a+function%3F&oq=linux+what+does+the+number+mean+in+parenthesis+after+a+function%3F&aqs=chrome..69i57j69i64.9867j0j7&sourceid=chrome&ie=UTF-8
- https://superuser.com/info/297702/what-do-the-parentheses-and-number-after-a-unix-command-or-c-function-mean
- https://unix.stackexchange.com/info/3586/what-do-the-numbers-in-a-man-page-mean