Was bedeutet die Zahl in Klammern hinter dem Namen des Unix-Befehls in den Manpages?

Question

Zum Beispiel: man(1) , find(3) , updatedb(2) ?

Was bedeuten die Zahlen in Klammern (brit. "brackets")?

Answer 1

Dies ist der Abschnitt, dem die Manpage für den Befehl zugeordnet ist.

Diese sind aufgeteilt in

1. Allgemeine Befehle
2. Systemaufrufe
3. C-Bibliotheksfunktionen
4. Spezielle Dateien (normalerweise Geräte, die sich in /dev befinden) und Treiber
5. Dateiformate und Konventionen
6. Spiele und Bildschirmschoner
7. Gemischtes
8. Systemverwaltungsbefehle und Dämonen

Die Originalbeschreibungen der einzelnen Abschnitte finden Sie in der Handbuch für Unix-Programmierer (Seite ii).

Um auf eine Manpage mit dem Namen "foo(5)" zuzugreifen, führen Sie aus:

man 5 foo

Answer 2

Der Abschnitt des Befehls ist im Handbuch dokumentiert. Die Liste der Abschnitte ist im man's manual dokumentiert. Zum Beispiel:

man 1 man
man 3 find

Dies ist nützlich, wenn ähnliche oder genau gleiche Befehle auf verschiedenen Abschnitten existieren

Answer 3

Der Grund, warum die Abschnittsnummern so wichtig sind, liegt darin, dass vor vielen Jahren, als Speicherplatz noch ein größeres Problem war als heute, die Abschnitte einzeln installiert werden konnten.

Auf vielen Systemen waren zum Beispiel nur 1 und 8 installiert. Heutzutage neigen die Leute dazu, die Befehle stattdessen bei Google nachzuschlagen.

Answer 4

Als @Ian G sagt sind die Abschnitte der Handbuchseiten. Lassen Sie uns aber noch einen Schritt weiter gehen:

1. Siehe die Manpage für das Programm man Befehl mit man man und zeigt die 9 Abschnitte wie folgt an:

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.

2. man <section_num> <cmd>

Nehmen wir an, Sie googeln nach Linux-Befehlen. Sie finden die OPEN(2) pg online: open(2) - Linux Handbuchseite .

Um dies in den Man Pages auf Ihrem PC zu sehen, geben Sie einfach ein man 2 open .

Für FOPEN(3) verwenden. man 3 fopen etc.

3. man <section_num> intro

Um die Einführungsseiten zu einem Abschnitt zu lesen, geben Sie ein man <section_num> intro , wie zum Beispiel man 1 intro , man 2 intro , man 7 intro etc.

Um alle Manpage-Intros nacheinander anzuzeigen, führen Sie Folgendes aus man -a intro . Die Einführungsseite für Abschnitt 1 wird geöffnet. Drücken Sie q zum Beenden, dann drücken Sie Enter um die Einleitung zu Abschnitt 8 zu sehen. Drücken Sie q zum Beenden, dann drücken Sie Enter um die Einleitung zu Abschnitt 3 zu sehen. Fahren Sie mit diesem Vorgang fort, bis Sie fertig sind. Jedes Mal, wenn Sie auf q kehren Sie zum Hauptbildschirm des Terminals zurück, aber Sie befinden sich immer noch in einer interaktiven Eingabeaufforderung, und Sie sehen diese Zeile:

--Man-- next: intro(8) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]

Beachten Sie, dass die Reihenfolge der Abschnitte, die man -a intro führt Sie durch:

1. Abschnitt 1
2. Abschnitt 8
3. Abschnitt 3
4. Abschnitt 2
5. Abschnitt 5
6. Abschnitt 4
7. Abschnitt 6
8. Abschnitt 7

Diese Suchreihenfolge ist beabsichtigt, da die man man Seite erklärt:

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)

Warum haben sie diese Reihenfolge gewählt? Ich weiß es nicht (bitte antwortet in den Kommentaren, wenn ihr es wisst), aber stellt einfach fest, dass diese Reihenfolge korrekt und beabsichtigt ist.

Verwandt:

1. Google-Suche nach "linux what does the number mean in parenthesis after a function?"
2. SuperUser: Was bedeuten die Klammern und die Zahl nach einem Unix-Befehl oder einer C-Funktion?
3. Unix und Linux: Was bedeuten die Zahlen in einer Manpage?

Answer 5

Beachten Sie auch, dass auf anderen Unix-Systemen die Methode zur Angabe des Abschnitts unterschiedlich ist. Auf Solaris ist es zum Beispiel so:

man -s 1 man