$ man

Özet

man [-adho] [-t | -w] [-M manpath] [-P pager] [-S mansect] \
    [-m arch[:machine]] [-p [eprtv]] [mansect] page ...

man -f [-d] [-M manpath] [-P pager] [-S mansect] keyword ...
whatis [-d] [-s mansect] keyword ...

man -k [-d] [-M manpath] [-P pager] [-S mansect] keyword ...
apropos [-d] [-s mansect] keyword ...

Açıklama

man, çevrimiçi kılavuz belgelendirme sayfalarını bulur ve görüntüler. mansect belirtilirse, arama kılavuzun belirli bir bölümüyle sınırlandırılır.

Kılavuz Bölümleri

Kılavuzun bölümleri şunlardır:

1. Genel Komutlar Kılavuzu
2. Sistem Çağrıları Kılavuzu
3. Kütüphane Fonksiyonları Kılavuzu
4. Çekirdek Arayüzleri Kılavuzu
5. Dosya Biçimleri Kılavuzu
6. Oyunlar Kılavuzu
7. Çeşitli Bilgiler Kılavuzu
8. Sistem Yöneticisi Kılavuzu
9. Çekirdek Geliştirici Kılavuzu

Seçenekler

• -M manpath: Varsayılan arama yolu yerine iki nokta üst üste ile ayrılmış belirli bir kılavuz yolu kullanılmasını zorunlu kılar. manpath(1) sayfasına bakın. MANPATH ortam değişkenini geçersiz kılar.
• -P pager: Belirtilen sayfalayıcıyı kullanır. Renk desteği etkinse varsayılan olarak less -sR, etkin değilse less -s değerini alır. MANPAGER ortam değişkenini geçersiz kılar; bu değişken de PAGER ortam değişkenini geçersiz kılar.
• -S mansect: Aranan kılavuz bölümlerini belirtilen iki nokta üst üste ile ayrılmış listeyle sınırlandırır. Varsayılan değer 1:8:2:3:3lua:n:4:5:6:7:9:l şeklindedir. MANSECT ortam değişkenini geçersiz kılar.
• -a: Her bir sayfa argümanı için yalnızca bulunan ilk sayfa yerine tüm kılavuz sayfalarını görüntüler.
• -d: Ek hata ayıklama bilgileri yazdırır. Ayrıntı düzeyini artırmak için tekrarlanabilir. Kılavuz sayfasını görüntülemez.
• -f: whatis(1) komutunu taklit eder. man bu modda çağrıldığında seçeneklerin yalnızca bir alt kümesinin etkili olacağını unutmayın.
• -h: Kısa bir yardım mesajı görüntüler ve çıkar.
• -k: apropos(1) komutunu taklit eder. man bu modda çağrıldığında seçeneklerin yalnızca bir alt kümesinin etkili olacağını unutmayın.
• -m arch[:machine]: Diğer platformlara özgü kılavuz sayfalarının aranmasına olanak tanımak üzere varsayılan mimari ve makine ayarlarını geçersiz kılar. Bu seçenek macOS'te kabul edilir ancak uygulanmaz.
• -o: Yerelleştirilmemiş kılavuz sayfalarının kullanılmasını zorunlu kılar. Yerel ayara özgü aramaların nasıl çalıştığını görmek için Uygulama Notları bölümüne bakın. LC_ALL, LC_CTYPE ve LANG ortam değişkenlerini geçersiz kılar.
• -p [eprtv]: nroff(1) veya troff(1) çalıştırılmadan önce verilen önişlemciler listesini kullanır. MANROFFSEQ ortam değişkenini geçersiz kılar.
• -t: Kılavuz sayfası kaynağını troff(1) üzerinden göndererek kılavuz sayfalarının diğer biçimlere dönüştürülmesine olanak tanır.
• -w: Kılavuz sayfasının içeriği yerine kılavuz sayfasının konumunu görüntüler.

-p seçeneği için geçerli önişlemci argümanları şunlardır:

• e: eqn(1)
• p: pic(1)
• r: refer(1)
• t: tbl(1)
• v: vgrind(1)

apropos ve whatis Seçenekleri

• -d: man komutunun -d seçeneğiyle aynıdır.
• -s: man komutunun -S seçeneğiyle aynıdır.

man, apropos veya whatis taklit modunda çalıştırıldığında seçeneklerinin yalnızca bir alt kümesi dikkate alınır. Sağlanan apropos ve whatis uygulamasında -d, -M, -P ve -S seçenekleri eşdeğer işlevselliğe sahiptir. MANPATH, MANSECT ve MANPAGER ortam değişkenleri de benzer şekilde dikkate alınır.

Uygulama Notları

Yerel ayara özgü aramalar: man, farklı yerel ayarlardaki kılavuz sayfalarını destekler. Arama davranışı, boş olmayan bir dizeye sahip üç ortam değişkeninden ilki tarafından belirlenir: LC_ALL, LC_CTYPE veya LANG. Tanımlanmışlarsa, man yerel ayara özgü kılavuz sayfalarını şu mantığa göre arar:

lang_country.charset
lang.charset
en.charset

Örneğin, LC_ALL değişkeni ja_JP.eucJP olarak ayarlanmışsa, man /usr/share/man dizinindeki bölüm 1 kılavuz sayfalarını değerlendirirken aşağıdaki yolları arar:

/usr/share/man/ja_JP.eucJP/man1
/usr/share/man/ja.eucJP/man1
/usr/share/man/en.eucJP/man1
/usr/share/man/man1

Belirli kılavuz dosyalarını görüntüleme: man, bir / karakteri içerdiği sürece dosyaya giden yol iletildiğinde belirli bir kılavuz sayfasının görüntülenmesini de destekler.

Ortam Değişkenleri

Aşağıdaki ortam değişkenleri man komutunun yürütülmesini etkiler:

• LC_ALL, LC_CTYPE, LANG: Yerel ayara özgü kılavuz sayfalarını bulmak için kullanılır. Geçerli değerler locale(1) komutu çalıştırılarak bulunabilir. Ayrıntılar için Uygulama Notları bölümüne bakın. -o seçeneğinden etkilenir.
• MACHINE_ARCH, MACHINE: Platforma özgü kılavuz sayfalarını bulmak için kullanılır. Ayarlanmamışsa, sırasıyla sysctl hw.machine_arch ve sysctl hw.machine çıktısı kullanılır. Ayrıntılar için Uygulama Notları bölümüne bakın. -m seçeneğine karşılık gelir.
• MANPATH: man(1) tarafından kullanılan standart arama yolu, MANPATH ortam değişkeninde bir yol belirtilerek değiştirilebilir. Geçersiz yollar veya kılavuz veritabanı barındırmayan yollar yoksayılır. -M seçeneği ile geçersiz kılınır. MANPATH iki nokta üst üste ile başlıyorsa varsayılan listenin sonuna eklenir; iki nokta üst üste ile bitiyorsa varsayılan listenin başına eklenir; yan yana iki adet iki nokta üst üste içeriyorsa standart arama yolu bu iki nokta üst üste işaretlerinin arasına yerleştirilir. Bu koşulların hiçbiri karşılanmazsa standart arama yolunu tamamen geçersiz kılar.
• MANROFFSEQ: nroff(1) veya troff(1) çalıştırılmadan önce kılavuz kaynağı için önişlemcileri belirlemek üzere kullanılır. Ayarlanmamışsa varsayılan olarak tbl(1) değerini alır. -p seçeneğine karşılık gelir.
• MANSECT: Aranan kılavuz bölümlerini belirtilen iki nokta üst üste ile ayrılmış listeyle sınırlandırır. -S seçeneğine karşılık gelir.
• MANWIDTH: Sayısal bir değere ayarlanmışsa, kılavuz sayfalarının görüntüleneceği genişlik olarak kullanılır. Özel tty değerine ayarlanmışsa ve çıktı bir terminale yönlendiriliyorsa, sayfalar ekranın tüm genişliği boyunca görüntülenebilir.
• MANCOLOR: Ayarlanırsa renk desteğini etkinleştirir.
• MANPAGER: Dosyaları görüntülemek için kullanılan program. Ayarlanmamışsa ve renk desteği etkinse less -sR kullanılır. Ayarlanmamışsa ve renk desteği devre dışıysa PAGER kullanılır. Onun da değeri yoksa less -s kullanılır.

Dosyalar

• /etc/man.conf: Sistem yapılandırma dosyası.
• /usr/local/etc/man.d/*.conf: Yerel yapılandırma dosyaları.

Çıkış Durumu

man, başarı durumunda 0, bir hata oluşması durumunda >0 değeriyle çıkar.

Örnekler

stat(2) için kılavuz sayfasını göstermek:

man 2 stat

stat için tüm kılavuz sayfalarını göstermek:

man -a stat

Başlıkta veya gövdede düzenli ifadeyle eşleşen kılavuz sayfalarını listelemek:

man -k '\<copy\>.*archive'

ls(1) için kılavuz sayfasını göstermek ve sayfalayıcı olarak cat(1) kullanmak:

man -P cat ls

ls(1) kılavuz sayfasının konumunu göstermek:

man -w ls

Ayrıca Bakınız

apropos(1), intro(1), mandoc(1), manpath(1), whatis(1), intro(2), intro(3), intro(3lua), intro(4), intro(5), man.conf(5), intro(6), intro(7), mdoc(7), intro(8), intro(9)