it-swarm-tr.com

Bir kılavuz sayfasındaki sayılar ne anlama geliyor?

Örneğin, man ls Yazdığımda LS(1) görüyorum. Ama man apachectl Yazarsam APACHECTL(8) görürsem ve man cd Yazarsam cd(n) ile biterim.

Varsa, parantez içindeki sayıların önemini merak ediyorum.

514
Wilduck

Sayı, kılavuzun o sayfanın hangi bölümüne ait olduğunu; 1 kullanıcı komutları, 8 ise sysadmin şeyleridir. İnsanın kendisi için man sayfası (man man) Açıklar ve standart olanları listeler:

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.

Farklı bölümlerde farklı sayfaları olan belirli terimler vardır (örn. Bölüm 1'de bir komut olarak printf, bölüm 3'te bir stdlib işlevi göründüğü için); bunun gibi durumlarda, istediğiniz numarayı seçmek için bölüm numarasını sayfa adından önce man öğesine aktarabilir veya eşleşen her sayfayı bir satırda göstermek için man -a kullanabilirsiniz:

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

Bir terimin man -k İle girdiği bölümleri söyleyebilirsiniz (apropos komutuna eşdeğer). Alt dize eşleşmeleri de yapar (örneğin, man -k printf Çalıştırırsanız sprintf gösterecektir), bu nedenle sınırlamak için ^term Kullanmanız gerekir:

$ 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

Bu bölüm numaralarının geçmişi Thompson ve Ritchie tarafından 1971'de orijinal nix Programcı El Kitabı .

Orijinal bölümler

  1. Komutları
  2. Sistem çağrıları
  3. Altyordamlar
  4. Özel dosyalar
  5. Dosya formatları
  6. Kullanıcı tarafından sağlanan programlar
  7. Çeşitli
59
KeithB

konqueror ayrıca standart olmayan bölümleri de açıklar: (fikir için @ greg0ire sayesinde)

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

Zaten açıklandığı anlamına gelir, ancak her bölümün giriş ile özel bir manuel sayfa olduğunu eklemek istiyorum: intro. Örneğin, man 1 intro veya man 3 intro ve bunun gibi.

21
php-coder

man kılavuzundan:

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]

Neden böyle ayrı olduklarına gelince - bazı çakışmalar var. Bazı manajlar, ne demek istediğinize bağlı olarak birden fazla bölümde bulunur.

Örneğin, man crontab ile man 5 crontab - Şansları, aramayı düşündüğünüz ikincisidir.

16
Shadur

Bunlar bölüm numaralarıdır. Sadece yaz man man veya konqueror açın ve man: // man yazın ve bu bölümlerin ne olduğunu göreceksiniz.

8
greg0ire

Genellikle, bir man sayfasına, parantez içine alınmış bölüm ekleyerek eklenir, örn .:

read(2)

Bu tarzın iki ana avantajı vardır:

  • bir man sayfasına referans verdiğiniz hemen anlaşılıyor - yani 'cf. 'cf. yerine (3)' ifadesini okuyun. bölüm 3 man sayfası okuma '
  • birden çok bölüm aynı ada sahip sayfalar içeriyorsa, bölümün belirtilmesi daha kesin olur

Man sayfaları bölümler halinde düzenlenmiştir, ör. Bölüm 1 tüm kullanıcı komut kılavuzu sayfalarını, Bölüm 2 sistem çağrıları için tüm kılavuz sayfalarını, Bölüm 3 kütüphane fonksiyonları içindir vb.

Komut satırında, bölümü açıkça belirtmezseniz, ilk eşleşen adam sayfasını alırsınız, varsayılan bölümde geçiş sırasına göre, ör .:

$ man read

fedora'da BASH_BUILTINS(1) görüntüler. Nerede

$ man 2 read

read() sistem çağrısı için kılavuz sayfasını görüntüler.

Bölümün konumsal belirtiminin taşınabilir olmadığını unutmayın - ör. Solaris'de şöyle belirtirsiniz:

$ man -s 2 read

Genellikle, man man Mevcut bazı bölümleri de listeler. Ama hepsi değil. Kullanılabilir tüm bölümleri listelemek için, varsayılan adam yolunda veya ortam değişkeninde $MANPATH Listelenen tüm dizinlerin alt dizinleri listelenebilir. Örneğin, bazı geliştirme paketlerinin yüklü olduğu bir Fedora 23 sisteminde /usr/share/man Aşağıdaki alt dizinlere sahiptir:

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

man önekine sahip dizinler her bölümü temsil ederken, diğer bölümler çevrilmiş bölümleri içerir. Böylece, boş olmayan bölümlerin bir listesini almak için böyle bir komut verilebilir:

$ 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

(p ile biten bölümler POSIX kılavuz sayfalarıdır)

Bir kılavuz sayfasını başka bir dilde görüntülemek (varsa), dille ilgili bir ortam değişkeni ayarlayabilir, örn .:

$ LC_MESSAGES=de_DE man read

Ayrıca, her bölümün intro adlı bir tanıtım el kitabı sayfası olmalıdır, ör. yoluyla görüntülenebilir:

$ man 2 intro
7
maxschlepzig

SVr4 için tanımlar:

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

Bunlar "genetik" UNIX için gerçek numaralandırmadır. POSIX sayı tanımlamaz.

4
schily