Korzystam z debian8 (jessie) i poszedłem znaleźć stronę podręcznika otwartego. zamiast tego dostałem ostrzeżenie:
$ man 3 open
No manual entry for open in section 3
See 'man 7 undocumented' for help when manual pages are not available.
Mam zainstalowany pakiet manpage-dev, więc gdzie jest programista manpage (man 3) dla open?
man
documentation
j0h
źródło
źródło
apropos
lubman --names-only
z jednym z--regex
lub--wildcard
. Zobaczyćman man
.open
nie jest funkcją, to wywołanie systemowe. To pedantyczna różnica, ale istotne jest to, że wywołania systemowe znajdują się w sekcji 2, a funkcje biblioteczne w sekcji 3.Odpowiedzi:
Chcesz
man 2 open
interfejsu biblioteki C. Nieman 3 open
. Rzeczywiście jest wmanpages-dev
(niemanpage-dev
).man 3 open
daje stronę podręcznika Perla.źródło
Sekcje strony man zostały opisane w samych stronach man. Wejdź
man man
w sesję powłoki, aby zobaczyć różne sekcje i ogólną treść:Sekcja 2 opisuje wywołania systemowe, podczas gdy sekcja 3 obejmuje procedury biblioteczne. Procedury biblioteczne, które są po prostu opakowaniem wywołań systemowych, opisano również w sekcji 2.
źródło
Aby wyjaśnić powód tego, strona podręcznika znajduje się w sekcji 2, ponieważ jest to wywołanie systemowe (zaimplementowane mniej więcej bezpośrednio jako część jądra, a nie biblioteka C).
To rozróżnienie może wydawać się nieco arbitralne, szczególnie w przypadku starszych wywołań systemowych, które są teraz funkcjami bibliotecznymi (fork nadal znajduje się w sekcji 2, mimo że jest teraz opakowaniem do klonowania), chyba że już go znasz. Ogólnie rzecz biorąc, najpierw spójrz do sekcji 3, a następnie wypróbuj sekcję 2, jeśli nie możesz jej znaleźć lub wygląda na to, że może nie być odpowiednia. Ponadto niektóre funkcje w sekcji 2 są wewnętrznymi lub przestarzałymi funkcjami specyficznymi dla systemu Linux, które nie powinny być wywoływane przez normalne programy (np. Getdents, gettid).
Możesz także zainstalować pakiet manpages-posix-dev, aby uzyskać zestaw stron napisany z przenośnej perspektywy, a nie zawierający informacje specyficzne dla systemu Linux. W tym pakiecie wszystkie strony podręczne dla funkcji C znajdują się w sekcji 3p.
źródło
Kiedy nie jestem pewien, w której sekcji jest określona strona podręczna, używam opcji -a.
Z przykładu na stronie man dla człowieka:
źródło
W tej sytuacji przydatne jest wyświetlenie całej listy wszystkich dostępnych stron o tej nazwie strony za pomocą jednego z poleceń:
Wynik będzie taki sam:
Lub przejrzyj zawartość wszystkich istniejących stron podręcznika, aby zidentyfikować wymagane:
źródło