man pages: significado de '2' em STAT (2)? [duplicado]

Question

Qual é o significado do número, como 2 em STAT(2) , visto nas páginas man?

Por exemplo, man 2 stat produz uma página man com STAT(2) na parte superior e uma descrição que começa, The stat() function... , enquanto man stat produz uma página man com STAT(1) na parte superior e uma descrição que começa , The stat utility...

Eu notei a página para STAT(1) diz BSD General Commands Manual , enquanto que para STAT(2) diz BSD System Calls Manual , então talvez o número seja um código para o tipo de comando?

    

Answer 1

O número é uma "seção", existem várias seções. Geralmente

1 é o comando geral
2 é chamadas do sistema
3 é funções (por exemplo, em C)
4 é arquivos especiais 5 é formatos de arquivo (acho que arquivos de configuração)
6 é diferente.
7 são comandos do sistema

O motivo é que um "termo" pode estar em várias seções. ftp é um comando, pode ser um daemon e pode ter um arquivo de configuração.

Portanto, stat(1) está dizendo o comando general stat, enquanto stat(2) está dizendo a estatística de chamada do sistema. Pode ser confuso. Para o uso normal, geralmente você vê apenas 1 e 5. 3, por exemplo, é preenchido com chamadas de função C e tal.

    

Answer 2

Nos "bons e velhos tempos", as páginas man foram impressas e vieram com o mainframe / mini computadores (levou todos eles para casa para ler em um ponto). Eles vieram em volumes organizados por uso: comando, comando do sistema, chamada da biblioteca, chamada do sistema, formato de arquivo, etc. A página man(1) mostra os nomes dos volumes. Para visualizar uma página de um volume específico, você colocaria isso na linha de comando antes do nome da página de manual: Para ver stat(2) , você executaria man 2 stat . Caso contrário, o primeiro volume em que o nome é encontrado, stat(1) . Para descobrir se há várias entradas em volumes diferentes, você pode usar apropos -e stat .