Co oznacza liczba w nawiasach wyświetlana po nazwach poleceń Uniksa na stronach podręcznika?

Odpowiedzi:

484

Jest to sekcja, do której przypisana jest strona podręcznika dla polecenia.

Są one podzielone jako

  1. Ogólne polecenia
  2. Połączenia systemowe
  3. Funkcje biblioteki C.
  4. Pliki specjalne (zwykle urządzenia, te znalezione w / dev) i sterowniki
  5. Formaty plików i konwencje
  6. Gry i wygaszacze ekranu
  7. Miscellanea
  8. Polecenia i demony administracji systemu

Oryginalne opisy poszczególnych sekcji można znaleźć w Podręczniku programisty Unixa (strona ii).

Ian G.
źródło
123
Najważniejsze informacje: aby uzyskać dostęp do strony podręcznika podanej jako „foo (5)”:man 5 foo
Steve Bennett,
1
Ten link miał tę samą listę, ale była wersją tego podręcznika w wersji v5. Pozwoliłem sobie na aktualizację linku odpowiedzi z jednym do The Internet Archive, które miało wersję v7, do której oryginalna odpowiedź wydawała się prowadzić (na podstawie adresu URL).
Jeroen
80

Część polecenia jest udokumentowana w instrukcji. Lista rozdziałów jest udokumentowana w podręczniku mężczyzny. Na przykład:

man 1 man
man 3 find

Jest to przydatne, gdy w różnych sekcjach istnieją podobne lub dokładnie takie same polecenia

Vinko Vrsalovic
źródło
102
A w „dawnych czasach” numery sekcji odpowiadały segregatorowi, w którym znajdowała się papierowa wersja strony podręcznika.
Darron
51

Powodem, dla którego numery sekcji są znaczące, jest to, że wiele lat temu, gdy miejsce na dysku stanowiło większy problem, teraz sekcje można instalować osobno.

Na przykład w wielu systemach zainstalowano tylko 1 i 8. Obecnie ludzie zwykle szukają poleceń w Google.

LepardUK
źródło
10

Zauważ też, że w innych systemach uniksowych metoda określania sekcji różni się. Na przykład w solaris jest to:

man -s 1 man
DRZEWO
źródło
8

Wskazuje sekcję stron podręcznika man, w których znajduje się polecenie. Przełącznik -s w poleceniu man może służyć do ograniczenia wyszukiwania do niektórych sekcji.

Podczas przeglądania strony podręcznika w lewym górnym rogu podaje się nazwę sekcji, np .:

Polecenia użytkownika printf (1)
Standardowe funkcje biblioteki C printf (3C)

Więc jeśli próbujesz wyszukać funkcje C i nie chcesz przypadkowo wyświetlić strony z poleceniem użytkownika o tej samej nazwie, zrobiłbyś 'man -s 3C ...'

Dave Costa
źródło
6

Jak mówi @Ian G , są to sekcje strony podręcznika. Przejdźmy jednak o krok dalej:

1. Zobacz stronę man dla polecenia man za pomocą man man, i pokazuje 9 sekcji w następujący sposób:

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>

Wyobraźmy sobie, że przeglądasz polecenia Linuksa. Znajdziesz OPEN(2)pg online: http://man7.org/linux/man-pages/man2/open.2.html .

Aby zobaczyć to na stronach podręcznika na komputerze, po prostu wpisz man 2 open.

Do FOPEN(3)użytku man 3 fopenitp.

3) man <section_num> intro

Aby przeczytać strony ogólne na temat sekcji, wpisać man <section_num> intro, takie jak man 1 intro, man 2 intro, man 7 intro, itd.

Aby wyświetlić kolejno wszystkie wprowadzane strony podręcznika, wykonaj kolejno jeden po drugim man -a intro. Otworzy się strona wprowadzająca do Sekcji 1. Naciśnij, qaby wyjść, następnie naciśnij, Enteraby wyświetlić wprowadzenie do Sekcji 8. Naciśnij, qaby wyjść, a następnie naciśnij, Enteraby wyświetlić wprowadzenie do Sekcji 3. Kontynuuj ten proces, aż się zakończy . Za każdym razem po uderzeniu qprzeniesie Cię z powrotem do głównego ekranu terminala, ale nadal będziesz wyświetlać interaktywne monity i zobaczysz następujący wiersz:

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

Pamiętaj, że kolejność sekcji, która man -a introCię poprowadzi, to:

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

Ta kolejność wyszukiwania jest celowa, ponieważ man manstrona wyjaśnia:

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)

Związane z:

  1. Szukaj w Google hasła „linux, co liczba oznacza w nawiasie po funkcji?” - https://www.google.com/search?q=linux+what+does+the+number+mean+in+parenthesis+after+a+funkcja%3F&oq=linux+what+does+the+number+mean + w + nawiasie + po + funkcji + a% 3F i aqs = chrome..69i57j69i64.9867j0j7 & sourceid = chrome & ie = UTF-8
  2. /superuser/297702/what-do-the-parentheses-and-number-after-a-unix-command-or-c-function-mean
  3. /unix/3586/what-do-the-numbers-in-a-man-page-mean
Gabriel Staples
źródło
2
Niezwykle przydatne informacje, nie jestem pewien, dlaczego oddano głosy, ale masz moje +1.
harperville
2

Szczegóły Wikipedii na temat części instrukcji:

  1. Ogólne polecenia
  2. Połączenia systemowe
  3. Funkcje biblioteki, obejmujące w szczególności bibliotekę standardową C.
  4. Pliki specjalne (zwykle urządzenia, te znalezione w / dev) i sterowniki
  5. Formaty plików i konwencje
  6. Gry i wygaszacze ekranu
  7. Miscellanea
  8. Polecenia i demony administracji systemu
Bob Setterbo
źródło
4
Ta odpowiedź stała się bezużyteczna; link, który nie był również w poprzednio przyjętej odpowiedzi, zepsuł się i został zredagowany, teraz ta odpowiedź nic nie dodaje.
Ben Voigt,