it-swarm-id.com

Apa arti angka-angka di halaman manual?

Jadi, misalnya, ketika saya mengetik man ls Saya melihat LS(1). Tetapi jika saya mengetik man apachectl Saya melihat APACHECTL(8) dan jika saya mengetik man cd Saya berakhir dengan cd(n).

Saya bertanya-tanya apa arti angka dalam tanda kurung, jika ada.

514
Wilduck

Nomornya sesuai dengan bagian mana dari manual dari mana halaman itu berasal; 1 adalah perintah pengguna, sedangkan 8 adalah hal sysadmin. Halaman manual untuk man itu sendiri (man man) menjelaskannya dan mencantumkan yang standar:

MANUAL SECTIONS
    The standard sections of the manual include:

    1      User Commands
    2      System Calls
    3      C Library Functions
    4      Devices and Special Files
    5      File Formats and Conventions
    6      Games et. al.
    7      Miscellanea
    8      System Administration tools and Daemons

    Distributions customize the manual section to their specifics,
    which often include additional sections.

Ada istilah tertentu yang memiliki halaman berbeda di bagian yang berbeda (mis. printf saat perintah muncul di bagian 1, sebagai fungsi stdlib muncul di bagian 3); dalam kasus seperti itu Anda dapat meneruskan nomor bagian ke man sebelum nama halaman untuk memilih yang Anda inginkan, atau menggunakan man -a untuk menampilkan setiap halaman yang cocok secara berurutan:

$ man 1 printf
$ man 3 printf
$ man -a printf

Anda dapat memberi tahu bagian mana yang termasuk dalam istilah man -k (setara dengan perintah apropos). Ini akan melakukan pencocokan substring juga (mis. Akan menampilkan sprintf jika Anda menjalankan man -k printf), jadi Anda perlu menggunakan ^term untuk membatasi:

$ man -k '^printf'
printf               (1)  - format and print data
printf               (1p)  - write formatted output
printf               (3)  - formatted output conversion
printf               (3p)  - print formatted output
printf [builtins]    (1)  - bash built-in commands, see bash(1)
524
Michael Mrozek

Sejarah nomor bagian ini kembali ke yang asli Manual Program Unix oleh Thompson dan Ritchie pada tahun 1971.

Bagian aslinya adalah

  1. Perintah
  2. Panggilan sistem
  3. Subrutin
  4. File khusus
  5. Format file
  6. Program yang dikelola pengguna
  7. Lain-lain
59
KeithB

konqueror juga menjelaskan bagian yang tidak standar: (terima kasih kepada @ greg0ire untuk idenya)

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
34
Babken Vardanyan

Apa artinya sudah dijelaskan, tetapi saya juga ingin menambahkan bahwa setiap bagian memiliki halaman manual khusus dengan pengantar: intro. Sebagai contoh, lihat man 1 intro atau man 3 intro dan seterusnya.

21
php-coder

Dari halaman manual 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]

Mengapa mereka terpisah seperti itu - ada beberapa tumpang tindih. Halaman manual tertentu ada di lebih dari satu bagian tergantung pada apa yang Anda maksud.

Sebagai contoh, bandingkan man crontab dengan man 5 crontab - kemungkinan yang terakhir adalah yang Anda maksudkan untuk dicari.

16
Shadur

Ini adalah nomor bagian. Ketik saja man man atau buka konqueror dan ketik man: // man dan Anda akan melihat apa saja bagian ini.

8
greg0ire

Seringkali, halaman manual dirujuk melalui suffix dengan bagian yang dilampirkan dalam tanda kurung, mis .:

read(2)

Gaya ini memiliki dua keunggulan utama:

  • segera jelas bahwa Anda mereferensikan halaman manual - yaitu Anda dapat menulis sesuatu seperti 'lih. baca (3) 'bukannya' lih. bagian 3 halaman manual baca '
  • jika beberapa bagian berisi halaman manual dengan nama yang sama, menentukan bagian tersebut lebih tepat

Halaman manual disusun dalam beberapa bagian, mis. Bagian 1 mencakup semua halaman manual perintah pengguna, Bagian 2 semua halaman manual untuk panggilan sistem, Bagian 3 adalah untuk fungsi perpustakaan dll.

Di baris perintah, jika Anda tidak secara spesifik menentukan bagian Anda mendapatkan halaman manual pertama yang cocok, dalam urutan traversal bagian default, mis .:

$ man read

menampilkan BASH_BUILTINS(1) di Fedora. Dimana

$ man 2 read

menampilkan halaman manual untuk read() panggilan sistem.

Perhatikan bahwa spesifikasi posisi bagian ini tidak portabel - mis. pada Solaris Anda akan menentukannya seperti ini:

$ man -s 2 read

Biasanya, man man Juga mencantumkan beberapa bagian yang tersedia. Namun belum tentu semuanya. Untuk mendaftarkan semua bagian yang tersedia, seseorang dapat mendaftar subdirektori dari semua direktori yang terdaftar di path man default atau variabel lingkungan $MANPATH. Misalnya pada sistem Fedora 23 dengan beberapa paket pengembangan yang diinstal /usr/share/man Memiliki subdirektori berikut:

cs  es  id  man0p  man2   man3x  man5x  man7x  man9x  pt_BR  sk  zh_CN
da  fr  it  man1   man2x  man4   man6   man8   mann   pt_PT  sv  zh_TW
de  hr  ja  man1p  man3   man4x  man6x  man8x  pl     ro     tr
en  hu  ko  man1x  man3p  man5   man7   man9   pt     ru     zh

Direktori dengan awalan man mewakili setiap bagian - sedangkan yang lainnya berisi bagian yang diterjemahkan. Dengan demikian, untuk mendapatkan daftar bagian yang tidak kosong, seseorang dapat mengeluarkan perintah seperti ini:

$ find /usr/share/man -type f  | sed '[email protected]^.*/man\(..*\)/.*[email protected]\[email protected]' \
    | sort -u | column
0p  1p  3   4   6   8
1   2   3p  5   7

(bagian yang diakhiri dengan p adalah halaman manual POSIX)

Untuk melihat halaman manual dalam bahasa lain (jika tersedia) seseorang dapat mengatur variabel lingkungan terkait bahasa, mis .:

$ LC_MESSAGES=de_DE man read

Selain itu, setiap bagian harus memiliki halaman manual pengantar bernama intro, mis. dapat dilihat melalui:

$ man 2 intro
7
maxschlepzig

Definisi untuk SVr4 adalah:

1 User Commands
2 System Calls
3 library Functions
4 File Formats
5 Standards, Environment and Macros (e.g. man(5))
6 Games and Demos
7 Device and Network Interfaces, Special Files
8 Maintenance Procedures
9 Kernel and Driver entry points and structures

Ini adalah penomoran aktual untuk UNIX "genetik". POSIX tidak mendefinisikan angka.

4
schily