Qual é o significado do "1" em ls (1)? [duplicado]

2

Eu vejo funções referenciadas com números entre parênteses na documentação. O que isto significa? É preciso um argumento?

    
por Marty 06.02.2012 / 05:50

1 resposta

6

Páginas manuais Unix vêm em "seções"; veja man man para o que eles significam (na maioria das plataformas; suponho que o seu irá documentá-lo lá).

A seção 1 é "comandos de usuário", e isso significa "a página de manual da seção 1 para ls".

Você verá que crontab(1) e crontab(5) são um exemplo de onde você tem mais de uma página com um único nome em seções diferentes.

Para acessá-lo a partir da linha de comando, execute man 1 ls ou man 5 crontab .

Você também pode usar man -a crontab para percorrer a página com esse nome em todas as seções em que estiver presente.

(Por que isso? Porque quando as páginas do manual são impressas como livros, as seções são como o conteúdo se divide em referências úteis. Não que você veja isso mais, mas quando voltar ...)

Dependendo do sistema operacional, as seções são divididas de forma diferente, a entrada da Wikipédia para a página man tem uma boa explicação . Mas, por exemplo, no BSD, Linux e UNIX - a seção '3' é reservada para funções de biblioteca (particularmente aquelas na biblioteca C padrão). Então, se você está escrevendo código C, você pode ajustar sua pesquisa de seção para tornar os resultados um pouco mais rápidos. man 2 printf , ou man -s 2 printf produz a versão C e evita que você tenha que percorrer a página man do / usr / bin / printf que, de outra forma, apareceria em primeiro lugar, pois a primeira seção produziria um hit primeiro.

Lista de Seção de Páginas Man para Variantes BSD, Linux, UNIX: (através da wikipedia)

  1. Comandos gerais
  2. Chamadas do sistema
  3. Funções de biblioteca, cobrindo em particular a biblioteca padrão C
  4. Arquivos especiais (geralmente dispositivos, encontrados em / dev) e drivers
  5. Formatos e convenções de arquivo
  6. Jogos e protetores de tela
  7. Miscelânea
  8. Comandos de administração do sistema e daemons
por 06.02.2012 / 05:53