Qual é a diferença entre 'man' e 'man (#)'?

Question

Acabou de ver alguém referenciando man 7 regex no Stackoverflow. Eu tentei man regex e obtive uma saída muito semelhante - parece haver pequenas diferenças.

Então, o que é esse número mágico 7? A pesquisa de man 7 unix no Google me fornece resultados mais misteriosos, como o UNIX (7) ...

    

Answer 1

Sobre UNIX(7)

Para responder à sua pergunta sobre "UNIX (7)", esta é a convenção padrão de dizer "A página man do UNIX na seção 7 (diversos)".

Para abrir uma página como init(8) , você usaria este comando: man 8 init .

man regex vs man 7 regex

Para responder à sua pergunta sobre as "diferenças sutis" entre man regex e man 7 regex :

Por padrão,

man abre a página com o número da seção menor . Nesse caso, é a seção 3 (chamadas da biblioteca). Abrir a página da seção 7 (Diversos) é bem diferente.

Páginas em seções diferentes tratam de coisas diferentes, embora nesse caso elas sejam semelhantes, considere apt :

man -f apt :

apt (8)              - Advanced Package Tool
apt (1)              - annotation processing tool

Neste exemplo, apt da seção 8 (comandos de administração do sistema) é completamente não relacionado à página da seção 1 (programas executáveis ou comandos shell).

Para referência futura, use man -f PAGE_NAME para localizar todas as páginas com esse nome em todas as seções. Você pode então abrir uma página da seção desejada com man SECTION PAGE_NAME .

seções da página de manual

As várias seções da página são as seguintes e podem ser encontradas em man man :

  

1. Programas executáveis ou comandos de shell
  
2. Chamadas do sistema (funções fornecidas pelo kernel)
  
3. Chamadas de biblioteca (funções dentro de bibliotecas de programas)
  
4. Arquivos especiais (geralmente encontrados em /dev )
  
5. Formatos e convenções de arquivo, por exemplo, /etc/passwd
  
6. Jogos
  
7. Diversos (incluindo macrotembalagens e convenções), por ex. man(7) , groff(7)
  
8. Comandos de administração do sistema (geralmente apenas para raiz)
  
9. Rotinas do kernel [não padrão]
  

    

Answer 2

Os números das seções

man mostrará a manpage de qualquer seção, man 7 mostrará a página manpage da seção 7. Então, aqui 7 refere-se à seção do comando específico para o qual você está procurando a página de manual.

Uma seção, se fornecida, direcionará o homem a olhar apenas naquela seção        o manual.

As seções

Veja a tabela a seguir para os números de seção do manual, seguidos pelos        tipos de páginas que eles contêm.

  

1: Programas executáveis ou comandos de shell

     

2: Chamadas do sistema (funções fornecidas pelo kernel)

     

3: Chamadas de biblioteca (funções dentro de bibliotecas de programas)

     

4: Arquivos especiais (geralmente encontrados em / dev)

     

5: Formatos de arquivo e convenções, por exemplo, / etc / passwd

     

6: Jogos

     

7: Diversos (incluindo macrotembalagens e convenções), por ex.              homem (7), groff (7)

     

8: Comandos de administração do sistema (geralmente apenas para root). Visão geral de vários tópicos, convenções e protocolos,                    padrões de conjunto de caracteres e diversas outras coisas.

     

9: Rotinas do kernel [não padrão]

Comandos em mais de uma seção

Na maioria dos casos, você desejará usar o comando man sem n adicional. No entanto, em alguns casos, um comando aparecerá em mais de uma seção. Por exemplo, se você emitir o comando man open , obterá a página man para openvt da seção 1. Mas se você precisar ver a página man para abrir como um comando C (ou chamada de sistema, conforme a tabela acima), precisa emitir man 2 open .

Um exemplo muito parecido será man printf e man 3 printf . Por favor, emita os comandos e veja por si mesmo a diferença na saída.

Seu problema de man 7 unix (UNIX (7))

Então, isso UNIX (7) significa que pertence à seção 7.

Qual seção será mostrada por padrão se eu não fornecer um número de seção?

A ação padrão é pesquisar em todos os itens disponíveis seções, seguindo uma ordem pré-definida e para mostrar apenas a primeira página encontrado, mesmo que a página exista em várias seções.

Como sei o número da seção de um comando?

Se você precisar descobrir em quais seções um termo / comando se encaixa com man -k (equivalente ao comando apropos). Então, man -k printf            pesquisará as descrições curtas e os nomes das páginas de manual para a palavra-chave printf como expressão regular. Imprima quaisquer correspondências. (Equivalente a apropos -r printf ). Emita o comando, veja a tonelada que você recebe. Se precisar evitar correspondências de substring, (por exemplo, ele mostrará sprintf se você executar man -k printf ), será necessário usar ^term para limitá-lo, conforme abaixo,

man -k '^printf'
Printf (3o)          - Formatted output functions.
printf (1)           - format and print data
printf (3)           - formatted output conversion

Comando relacionado

Um comando relacionado é apropos , conforme indicado acima, que pesquisa os nomes e as descrições das páginas de manual. Se você não tiver certeza de qual página de manual está procurando, mas tenha uma ideia geral, use este comando.