Por exemplo: man(1)
, find(3)
, updatedb(2)
?
O que significam os números entre parênteses ("colchetes" britânicos)?
Por exemplo: man(1)
, find(3)
, updatedb(2)
?
O que significam os números entre parênteses ("colchetes" britânicos)?
Respostas:
É a seção à qual a página de manual do comando está atribuída.
Estes são divididos como
As descrições originais de cada seção podem ser vistas no Manual do Programador Unix (página ii).
man 5 foo
A seção em que o comando está documentado no manual. A lista de seções está documentada no manual do homem. Por exemplo:
man 1 man
man 3 find
Isso é útil para quando comandos semelhantes ou exatamente iguais existem em seções diferentes
A razão pela qual os números de seção são significativos é que, há muitos anos, quando o espaço em disco era um problema maior do que agora, as seções podiam ser instaladas individualmente.
Muitos sistemas tinham apenas 1 e 8 instalados, por exemplo. Atualmente, as pessoas tendem a procurar os comandos no google.
Indica a seção das páginas do manual em que o comando está localizado. A opção -s no comando man pode ser usada para limitar uma pesquisa a determinadas seções.
Quando você visualiza uma página de manual, o canto superior esquerdo fornece o nome da seção, por exemplo:
Comandos do usuário printf (1)
Funções padrão da biblioteca C printf (3C)
Portanto, se você está tentando procurar funções C e não deseja ver acidentalmente uma página para um comando de usuário que compartilha o mesmo nome, você faria 'man -s 3C ...'
Como @Ian G diz , elas são as seções da página de manual. Vamos dar um passo além:
man man
e mostra as 9 seções da seguinte maneira:DESCRIPTION
man is the system's manual pager. Each page argument given
to man is normally the name of a program, utility or func‐
tion. The manual page associated with each of these argu‐
ments is then found and displayed. A section, if provided,
will direct man to look only in that section of the manual.
The default action is to search in all of the available sec‐
tions following a pre-defined order ("1 n l 8 3 2 3posix 3pm
3perl 5 4 9 6 7" by default, unless overridden by the SEC‐
TION directive in /etc/manpath.config), and to show only the
first page found, even if page exists in several sections.
The table below shows the section numbers of the manual fol‐
lowed 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]
A manual page consists of several sections.
man <section_num> <cmd>
Vamos imaginar que você esteja pesquisando no Google os comandos do Linux. Você encontra a página OPEN(2)
on-line: http://man7.org/linux/man-pages/man2/open.2.html .
Para ver isso nas páginas de manual do seu PC, basta digitar man 2 open
.
Para FOPEN(3)
uso man 3 fopen
, etc.
man <section_num> intro
Para ler as páginas de introdução para uma seção, digite man <section_num> intro
, como man 1 intro
, man 2 intro
, man 7 intro
, etc.
Para visualizar todas as introduções da página de manual em sucessão, uma após a outra, faça man -a intro
. A página de introdução da Seção 1 será aberta. Pressione qpara sair e, em seguida, pressione Enterpara visualizar a introdução da Seção 8. Pressione qpara sair e pressione Enterpara visualizar a introdução da Seção 3. Continue esse processo até concluir. Toda vez qque você pressionar , você voltará para a tela principal do terminal, mas você ainda estará em um prompt interativo e verá esta linha:
--Man-- next: intro(8) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]
Observe que a ordem da seção que o guiará man -a intro
é:
Essa ordem de pesquisa é intencional, como a man man
página explica:
The default action is to search in all of the available sections follow‐
ing a pre-defined order ("1 n l 8 3 2 3posix 3pm 3perl 5 4 9 6 7" by default, unless overrid‐
den by the SECTION directive in /etc/manpath.config)
Detalhes da Wikipedia sobre seções manuais: