Man -f o que significa o (1)? [duplicado]

Question

Estou vendo o sinal -f no homem, que é descrito como:

   -f, --whatis
          Equivalent to whatis.  Display a short description from the manual page, if available.  See whatis(1) for details.

Quando realmente uso -f , as entradas sempre têm um colchete no final e, às vezes, você recebe várias entradas.

Exemplos de man -f resultados:

man -f grep :

grep (1)             - print lines matching a pattern

man -f man :

man (7)              - macros to format man pages
man (1)              - an interface to the on-line reference manuals

man -f git :

Git (3pm)            - Perl interface to the Git version control system
git (1)              - the stupid content tracker

Eu estou supondo que todas as descrições normais do programa são mostradas com (1) .

Alguém pode explicar que outras listas estão sendo pesquisadas e como identificar quais números diferentes significam entre parênteses?

Observação: notei também que, para o git, posso obter a página de manual (3pm) fazendo man Git em vez de man git . Parece contra-intuitivo que man git inclua o manual em git , mas não Git , em que man -f git retorna informações sobre ambos.

    

Answer 1

A coisa nos parênteses (que em alguns sistemas pode ser uma combinação de letras e números, mas na maioria das vezes é apenas um dígito) refere-se a uma seção no manual . "O manual" é o volume combinado de manuais disponíveis.

No meu sistema OpenBSD, estas seções estão localizadas no manual man(1) (também conhecido como "o manual do comando man "):

1         General commands (tools and utilities).
2         System calls and error numbers.
3         Library functions.
3p        perl(1) programmer's reference guide.
4         Device drivers.
5         File formats.
6         Games.
7         Miscellaneous information.
8         System maintenance and operation commands.
9         Kernel internals.

Os números das seções são basicamente os mesmos entre os sistemas, mas pode haver pequenos desvios. As seções não são padronizadas, pelo menos não pelo POSIX, então eu acho que elas são mais tradicionais.

Em alguns casos, você precisará saber qual seção está procurando. Esse é o caso para o manual printf , por exemplo. printf(1) refere-se ao utilitário printf do shell, enquanto printf(3) descreve a rotina da biblioteca C printf() . Se você digitar apenas man printf , provavelmente obterá printf(1) . Para obter o manual para a função da biblioteca C, use man 3 printf .

As seções parecem ter sido introduzidas com o Third Edition UNIX saindo do Bell Labs em 1971 (o primeiro UNIX escrito em C e não em assembly).

O manual da terceira edição do UNIX continha as seguintes seções :

I.    Commands
II.   System calls
III.  Subroutines
IV.   Special files
V.    File formats
VI.   User-maintained programs
VII.  Miscellaneous
VIII. Maintenance

    

Answer 2

extrair de man man (5 parágrafos):

   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 conventions), e.g. man(7), groff(7)
   8   System administration commands (usually only for root)
   9   Kernel routines [Non standard]

    

Answer 3

Os números referem-se à seção do manual da qual as informações são (originalmente, o volume físico do conjunto de manuais que você tinha na prateleira).

De man man :

   The table below shows the section numbers of the manual followed 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  conventions),  e.g.  man(7),
       groff(7)
   8   System administration commands (usually only for root)
   9   Kernel routines [Non standard]

Algumas "seções" adicionais foram adicionadas posteriormente. Por exemplo, o (3pm) no texto citado acima se refere a um módulo perl (ou biblioteca).

    

Answer 4

O número após o comando informa a você qual seção das páginas man a documentação desse comando está em ... por exemplo, grep (1) significa que a página man do grep pode ser encontrada na seção 1 das páginas man.

Diferentes sabores do UNIX e distribuições diferentes do Linux têm convenções diferentes sobre a documentação dos comandos em qual seção.