O que significam os parênteses e o número após um comando Unix ou função C?

Respostas:

221

Seções da página de manual.

  1. Comando UNIX comum que pode ser usado por todos os usuários. por exemplols(1)
  2. Chamadas de sistema Unix e C, por exemplo mmap(2)
  3. Rotinas da biblioteca C para programas C, por exemplo system(3)
  4. Arquivos especiais, por exemplo sudoers(4)
  5. Formatos de arquivo do sistema, por exemplo lmhosts(5)
  6. Jogos, por exemplo fortune(6)
  7. Diversos, por exemplo regex(7)
  8. Comandos de administração do sistema que são executados apenas pela raiz, por exemplo iwconfig(8)
  9. (Específico do Linux), por exemploksoftirqd(9)

A razão por trás das seções é que existem coisas que compartilham páginas de manual - mkdir(1)é o comando usado para criar um diretório, enquanto mkdir(2)é uma chamada do sistema que pode ser usada para criar um diretório em um programa C. Assim, as diferentes seções.

Referências anotadas [1,2] (como sugerido):
http://www.gsp.com/support/man/ - As páginas de manual do FreeBSD organizadas de acordo com as seções
http://manpages.unixforum.co.uk/man-pages/ linux / suse-linux-10.1 / - Páginas de manual do SUSE organizadas de acordo com as seções
http://www.december.com/unix/ref/mansec.html - Mais uma tabela para as seções de páginas de manual. Base inicial da lista (consulte as edições mais antigas desta postagem para obter detalhes)

[1] explicações e exemplos são invenções espontâneas na minha cabeça, para o assunto.
[2] não que seja academicamente correto, mas o pedido de referência é uma das coisas que retardou o crescimento da wikipedia. céticos estão tentando obter outros referenciar tudo e alguns dos contribuidores apenas ficar maneira muito irritado para responder mais nada, nem que aqueles que tentar adicionar coisas inúteis / sem fundamento estão devidamente removido da piscina (eles só obter a marca de referência-request marcado em suas adições, conteúdo não removido ...)

bubu
fonte
5
Games (6) tem uma seção própria!
Jaywalker
5
na verdade, é mais um programa divertido do que jogos. caesar (6) e fortuna (6) estão em mais engraçado .... e se você acha bcd (6) é um jogo de ... bem, eu iria colocar o emblema guru unix em você
bubu
25
Para exibir as informações, use o comando: man <number> <command>example: man 1 mkdirandman 2 mkdir
Donny Kurnia
@DonnyKurnia o único fato mais importante é preciso saber - você pode descobrir a si mesmo descansar a partir de agora, na verdade
n611x007
OTOH, os céticos tornaram sua resposta mais valiosa do que o stackoverflow.com/a/62972/4145951 "competitivo" , por isso estou votando positivamente. ;)
Nemo
83

Um trecho 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  conven‐
      tions), e.g. man(7), groff(7)
  8   System administration commands (usually only for root)
  9   Kernel routines [Non standard]
ssapkota
fonte
3
"Unix é fácil: digite man mane o resto vem por si só"
gerrit 19/07/12
1
Isso não é aplicável no macOS .
Franklin Yu
36

O número refere-se à seção da página de manual em que o comando ou função C está.

Então você pode acessar a página de manual mount(8)executando o comando:

man 8 mount

Ou ftok(2)assim:

man 2 ftok
Wuffers
fonte
2
Por curiosidade, por que não é man mount(8)ou man ftok(2)?
JAB
7
@JAB: Porque a maioria das conchas aceita os parênteses especialmente. Você não pode usar parênteses em nenhum comando do shell (sem querer fazer algo especial).
Wuffers 15/06
Bem, isso é interessante.
JAB
+1 Esta é a coisa mais essencial que você precisa saber - você pode descobrir o resto sozinho (mesmo sem perceber man man).
N611x007
3

Estes são números de seção. Se você quiser ler a seção 2 do mount, execute:

man 2 mount

Algumas páginas de manual têm várias seções.

jftuga
fonte
3

Estes são os mannúmeros das seções.

Seções e exemplos para páginas de manual do linux:

  • 1 - Programas ou comandos do shell - cp, rm, dd e ps.
  • 2 - Chamadas do sistema - fork, exec, ioctl e poll.
  • 3 - Chamadas de biblioteca - printf, malloc, pthread_ * calls, cos, sin, tan etc.
  • 4 - dispositivos, por exemplo, nulo (/ dev / null), porta, aleatória, lp.
  • 5 - Formatos de arquivo - usuários, grupos, hosts, host.equiv.
  • 6 - jogos.
  • 7 - Diversos (geralmente visões gerais) - glob, intro, tcp, uri, url, locale.
  • 8 - Sys Admin comandos e daemons - arp, montagem, rota, useradd, userdel etc.

Observe que existem diferenças entre a lista de seções man para linux e as variantes do Unix System V (por exemplo, Solaris, BSD, SCO, Venix). Mais detalhes no wiki da página de manual .

Curiosamente, Ken Thompson e Denis Ritchie, os famosos criadores de Unix e C, escreveram as primeiras páginas de manual - por insistência de seu gerente. Isso soa familiar?

Para selecionar um número de seção específico para uma entrada man no linux ( printfpossui entradas nas seções 1 e 3).

man 3 printf

Para visualizar todas as entradas do manual paracfdisk (use qem ENDuma página para chegar à próxima página:

man -a cfdisk

Para listar todas as entradas para um determinado comando, useapropos

apropos cfdisk
suspeito
fonte
2

É o número da seção manual. No tempo presente, referia-se à pasta física que continha aquela página de manual específica.

Na página de manmanual em um sistema Linux moderno:

   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]
Flup
fonte
0

Seções de páginas de manual, incluindo não padronizadas no Arch Linux:

0     Header files
0p    Header files (POSIX)
1     Executable programs or shell commands
1p    Executable programs or shell commands (POSIX)
2     System calls (functions provided by the kernel)
3     Library calls (functions within program libraries)
3n    Network Functions
3p    Perl Modules
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
l     Local documentation
n     New manpages

(obrigado a @ greg0ire pela ideia de usar o konqueror)

Babken Vardanyan
fonte