Що означає число в дужках, показане після імен команд Unix в manpages?


Відповіді:


484

Це розділ, якому призначена сторінка man для команди.

Вони розділені як

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

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


123
Основна інформація: щоб отримати доступ до сторінки чоловіка, вказаної як "foo (5)":man 5 foo
Стів Беннетт


1
Це посилання мало той самий перелік, але являло собою версію згаданого посібника v5. Я взяв на себе можливість оновити посилання відповіді на один до Інтернет-архіву, який мав версію v7, на яку, здавалося б, посилалася оригінальна відповідь (на основі URL-адреси).
Jeroen

80

Розділ, команда якого задокументований у посібнику. Список розділів задокументований в посібнику для людини. Наприклад:

man 1 man
man 3 find

Це корисно, коли в різних розділах існують подібні або абсолютно рівні команди


102
А в "старі часи" номери розділів відповідали палітурці, на якій розміщено версію копій сторінки чоловічої сторінки.
Даррон,

51

Причина, чому чисельність розділів є значною, полягає в тому, що багато років тому, коли дисковий простір був більшою проблемою, ніж зараз, секції можна було встановити окремо.

Наприклад, у багатьох системах встановлено лише 1 і 8. У наші дні люди, як правило, дивляться на команди на Google.


10

Зауважимо також, що на інших оніксах метод визначення розділу відрізняється. Наприклад, на Solaris це:

man -s 1 man

8

Він вказує на розділ довідкових сторінок, в якому знаходиться команда. Перемикач -s на команді man може використовуватися для обмеження пошуку певними розділами.

Коли ви переглядаєте чоловічу сторінку, у верхньому лівому куті вказується назва розділу, наприклад:

Команди користувача printf (1)
Стандартні функції C бібліотеки printf (3C)

Отже, якщо ви намагаєтеся шукати функції C і не хочете випадково побачити сторінку для команди користувача, яка має те саме ім’я, ви зробите "man -s 3C ..."


6

Як говорить @Ian G , вони є розділами чоловічої сторінки. Давайте ж зробимо цей крок далі:

1. Дивіться сторінку man для команди 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 на вашому ПК, просто введіть 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 + в + дужках + після + a + функція% 3F & aqs = хром..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. Функції бібліотеки, що охоплюють, зокрема, стандартну бібліотеку С
  4. Спеціальні файли (зазвичай пристрої, такі, які знайдені в / dev) та драйвери
  5. Формати та конвенції файлів
  6. Ігри та заставки
  7. Різне
  8. Команди та демони системного адміністрування

4
Ця відповідь стала марною; посилання, яке також не було в раніше прийнятій відповіді, перервалося і було відредаговане, тепер ця відповідь взагалі нічого не додала.
Ben Voigt
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.