Что означает число в скобках после имен команд Unix в manpages?

Ответы:

484

Это раздел, которому назначена страница руководства для команды.

Они разделены как

  1. Общие команды
  2. Системные звонки
  3. Функции библиотеки C
  4. Специальные файлы (обычно устройства, найденные в / dev) и драйверы
  5. Форматы файлов и соглашения
  6. Игры и заставки
  7. Разное
  8. Команды и демоны системного администрирования

Оригинальные описания каждого раздела можно увидеть в Руководстве программиста Unix (стр. Ii).

Ян Г
источник
123
Ключевой бит информации: для доступа к справочной странице, обозначенной как «foo (5)»:man 5 foo
Стив Беннетт
1
Эта ссылка имела тот же список, но была версией v5 упомянутого руководства. Я взял на себя смелость обновить ссылку ответа с ссылкой на Интернет-архив, в которой была версия v7, на которую исходная ссылка, по-видимому, ссылалась (на основе URL).
Йерун
80

Раздел команды документирован в руководстве. Список разделов документирован в мужском руководстве. Например:

man 1 man
man 3 find

Это полезно, когда в разных секциях существуют одинаковые или точно одинаковые команды

Винко Врсалович
источник
102
И в «старые времена» номера разделов соответствовали переплету, в котором находилась печатная версия справочной страницы.
Даррон,
51

Причина, по которой номера разделов являются значительными, заключается в том, что много лет назад, когда дисковое пространство было более серьезной проблемой, чем сейчас, разделы можно было устанавливать по отдельности.

Например, во многих системах были установлены только 1 и 8. В эти дни люди склонны искать команды в Google вместо этого.

LepardUK
источник
10

Также обратите внимание, что в других Unix-системах метод указания раздела отличается. На солярисе, например, это:

man -s 1 man
ДЕРЕВО
источник
8

Указывает раздел справочных страниц, в которых находится команда. Ключ -s команды man можно использовать для ограничения поиска определенными разделами.

Когда вы просматриваете справочную страницу, в верхнем левом углу отображается название раздела, например:

Пользовательские команды printf (1)
Стандартные функции библиотеки C printf (3C)

Поэтому, если вы пытаетесь найти функции C и не хотите случайно увидеть страницу для пользовательской команды с таким же именем, вы должны выполнить 'man -s 3C ...'

Дейв Коста
источник
6

Как говорит @Ian G , это разделы справочной страницы. Давайте сделаем еще один шаг вперед:

1. См. Справочную страницу для команды man с командой 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.


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. Секция 1
  2. Раздел 8
  3. Раздел 3
  4. Раздел 2
  5. Раздел 5
  6. Раздел 4
  7. Раздел 6
  8. Раздел 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)

Связанные с:

  1. 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 + в + скобка + после + а + функция% 3F & AQS = chrome..69i57j69i64.9867j0j7 & SourceId = хром & т.е. = UTF-8 ,
  2. /superuser/297702/what-do-the-parentheses-and-number-after-a-unix-command-or-c-function-mean
  3. /unix/3586/what-do-the-numbers-in-a-man-page-mean
Габриэль Стейплс
источник
2
Чрезвычайно полезная информация, не уверен, почему проголосовал против, но у вас есть мой +1.
Harperville
2

Википедия подробно о разделах руководства:

  1. Общие команды
  2. Системные звонки
  3. Библиотечные функции, охватывающие, в частности, стандартную библиотеку C
  4. Специальные файлы (обычно устройства, найденные в / dev) и драйверы
  5. Форматы файлов и соглашения
  6. Игры и заставки
  7. Разное
  8. Команды и демоны системного администрирования
Боб Сеттербо
источник
4
Этот ответ стал бесполезным; ссылка, которой не было в ранее принятом ответе, разорвалась и была отредактирована, теперь к этому ответу вообще ничего не добавлено.
Бен Фойгт