Что означает содержание страниц руководства, например, ГИТ-ветвь (1)

Question

Дубликат: https://stackoverflow.com/questions/587676/why-do-programs-in-unix-like-environments-have-numbers-after-their-name/

Например, если я наберу:

man ps

... а затем прокрутите до самого конца, я вижу что-то вроде этого:

SEE ALSO
     kill(1), w(1), kvm(3), strftime(3), sysctl(8)

Как я должен это интерпретировать? Я знаю, что kill - это еще одна команда, но что означает (1)? Есть что-нибудь к этому?

Справочная страница git загадочна:

git-add(1), git-am(1), git-archive(1)

Что кто-то пытается мне сказать?

Answer 1

Чтобы получить доступ к справочной странице для данного пронумерованного раздела, введите man number command

С man man

1. Исполняемые программы или оболочка команды
2. Системные вызовы (функции, предоставляемые ядром)
3. Библиотечные вызовы (функции внутри программных библиотек)
4. Специальные файлы (обычно находятся в / dev)
5. Форматы файлов и соглашения, например / etc / passwd
6. Игры
7. Разное (включая макропакеты и соглашения), например человек (7), groff (7)
8. Команды системного администрирования> (обычно только для root)
9. подпрограммы ядра [нестандартные]

Так, например,

man 1 printf

Даст вам страницу для команды shell printf, тогда как

man 3 printf

Даст вам страницу для вызова библиотеки C.

Answer 2

Справочные страницы разделены на разделы, например, для системных вызовов, команд, макросов и т. д. в основном для предотвращения конфликтов имен, например когда системный вызов имеет то же имя, что и команда.

Один из примеров этого sleep:

man 1 sleep

против

man 3 sleep

Раздел 1 зарезервирован для пользовательских команд.

Answer 3

Содержимое man разделено на несколько разделов:

1. Команды, доступные для пользователей
2. Системные вызовы Unix и C
3. подпрограммы библиотеки C для программ на C
4. Специальные имена файлов
5. Форматы файлов и соглашения для файлов, используемых Unix
6. Игры
7. Пакеты обработки текста
8. Команды и процедуры системного администрирования

Таким образом, kill(1) - это команда, а strftime(3) - это процедура C.

Answer 4

Как говорят другие, справочные страницы разделены на разделы. git-branch(1) относится к справочной странице с именем git-branch в разделе 1 руководства. Вы получаете доступ к этой конкретной man-странице с помощью одной из двух команд (в зависимости от вашего вкуса man):

man 1 git-branch

или

man -s 1 git-branch

Кроме того, некоторые элементы могут появляться в нескольких разделах с разными значениями, например, printf(1) и printf(3). Typing:

man printf

отображает справочную страницу для первого найденного элемента в зависимости от порядка переменной среды MANPATH. Вы можете изменить порядок MANPATH для изменения приоритета разделов или использовать:

man -a printf

для отображения всех справочных страниц для printf.

Answer 5

Man-страницы разделены на разделы. Например, в разделе 1 есть команды, а в 2 - системные вызовы.

Если вы запускаете man kill, он находит kill (1), которая является командой.

Если вы запустите man 2 kill, он покажет вам системный вызов также с именем kill.

То же самое касается crontab (1) и crontab (5).