Özet
man [-adho] [-t | -w] [-M manpath] [-P pager] [-S mansect] [-m arch[:machine]] [-p [eprtv]]
[mansect] sayfa ...
man -f [-d] [-M manpath] [-P pager] [-S mansect] anahtar_kelime ...
whatis [-d] [-s mansect] anahtar_kelime ...
man -k [-d] [-M manpath] [-P pager] [-S mansect] anahtar_kelime ...
apropos [-d] [-s mansect] anahtar_kelime ...
Açıklama
man yardımcı programı, çevrimiçi kılavuz dokümantasyon sayfalarını bulur ve görüntüler. Eğer mansect belirtilirse, man aramayı kılavuzun belirli bölümüyle sınırlandırır.
Kılavuzun bölümleri şunlardır: 2. Sistem Çağrıları Kılavuzu (System Calls Manual) 3. Kütüphane İşlevleri Kılavuzu (Library Functions Manual) 4. Çekirdek Arayüzleri Kılavuzu (Kernel Interfaces Manual) 5. Dosya Biçimleri Kılavuzu (File Formats Manual) 6. Oyunlar Kılavuzu (Games Manual) 7. Çeşitli Bilgiler Kılavuzu (Miscellaneous Information Manual) 8. Sistem Yöneticisi Kılavuzu (System Manager's Manual) 9. Çekirdek Geliştirici Kılavuzu (Kernel Developer's Manual)
man programının anladığı seçenekler:
-M manpath Varsayılan arama yolu yerine iki nokta üst üste ile ayrılmış belirli bir kılavuz yolu kullanımını zorunlu kılar. Bkz. manpath(1). MANPATH ortam değişkenini geçersiz kılar.
-P pager Belirtilen sayfalayıcıyı (pager) kullanır. Renk desteği etkinse varsayılan olarak “less -sR”, aksi takdirde “less -s” olur. 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 iki nokta üst üste ile ayrılmış belirtilen listeyle sınırlandırır. Varsayılan olarak “1:8:2:3:3lua:n:4:5:6:7:9:l” değerini alır. MANSECT ortam değişkenini geçersiz kılar.
-a: Her 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 bilgisi yazdırır. Ayrıntı düzeyini artırmak için tekrarlayın. Kılavuz sayfasını görüntülemez.-f: whatis(1) programını taklit eder. man bu modda çağrıldığında seçeneklerin yalnızca bir alt kümesinin etkili olacağını unutmayın. Ayrıntılar için aşağıdaki whatis seçeneklerinin açıklamasına bakın.-h: Kısa yardım mesajını görüntüler ve çıkış yapar.-k: apropos(1) programını taklit eder. man bu modda çağrıldığında seçeneklerin yalnızca bir alt kümesinin etkili olacağını unutmayın. Ayrıntılar için aşağıdaki apropos seçeneklerinin açıklamasına bakın.
-m arch[:machine] Varsayılan mimari ve makine ayarlarını geçersiz kılarak diğer platforma özgü kılavuz sayfalarının aranmasına olanak tanır. 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 (locale) özgü aramaların nasıl çalıştığını görmek için UYGULAMA NOTLARI 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ırmadan önce verilen önişlemcilerin (preprocessors) listesini kullanır. Geçerli önişlemci argümanları:
e eqn(1) p pic(1) r refer(1) t tbl(1) v vgrind(1)
MANROFFSEQ ortam değişkenini geçersiz kılar.
-t: Kılavuz sayfalarının diğer biçimlere dönüştürülmesine olanak tanımak için kılavuz sayfası kaynağını troff(1) aracılığıyla gönderir.-w: Kılavuz sayfasının içeriği yerine kılavuz sayfasının konumunu görüntüler.
apropos ve whatis programlarının anladığı seçenekler:
-d: man programının -d seçeneğiyle aynıdır.-s: man programının -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ınacaktır. Spesifik olarak, sağlanan apropos ve whatis uygulamasında -d, -M, -P ve -S eşdeğer işleve sahiptir. Benzer şekilde MANPATH, MANSECT ve MANPAGER ortam değişkenleri de dikkate alınacaktır.
Uygulama Notları
Yerel Ayara (Locale) Özgü Aramalar
man yardımcı programı, farklı yerel ayarlardaki (locales) kılavuz sayfalarını destekler. Arama davranışı; boş olmayan bir dizeye sahip üç ortam değişkeninden birincisi tarafından belirlenir: LC_ALL, LC_CTYPE veya LANG. Ayarlanmışsa man, yerel ayara özgü kılavuz sayfalarını aşağıdaki mantığı kullanarak arayacaktır:
lang_country.charset lang.charset en.charset
Örneğin, LC_ALL “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ı arayacaktır:
/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 yardımcı programı, bir ‘/’ karakteri içerdiği sürece, dosyaya bir yol iletildiğinde belirli bir kılavuz sayfasını görüntülemeyi de destekler.
Ortam Değişkenleri
Aşağıdaki ortam değişkenleri man programının 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 NOTLARI 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” komutlarının çıktısı kullanılır. Ayrıntılar için UYGULAMA NOTLARI 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ı olmayan yollar yoksayılır. -M 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; veya yan yana iki adet iki nokta üst üste içeriyorsa, standart arama yolu iki nokta üst üste arasına eklenir. Bu koşulların hiçbiri karşılanmazsa, standart arama yolunu tamamen geçersiz kılar.
MANROFFSEQ nroff(1) veya troff(1) çalıştırmadan önce kılavuz kaynağı için önişlemcileri belirlemek için kullanılır. Ayarlanmamışsa varsayılan olarak tbl(1) olur. -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. Aksi takdirde, özel bir “tty” değerine ayarlanmışsa ve çıktı bir terminale yapılıyorsa, sayfalar ekranın tüm genişliği boyunca görüntülenebilir.
MANCOLOR Ayarlanmışsa 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. Bunun da bir 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 yardımcı programı başarı durumunda 0, bir hata oluşursa >0 değeri ile çıkış yapar.
Örnekler
stat(2) için kılavuz sayfasını gösterir:
$ man 2 stat
‘stat’ için tüm kılavuz sayfalarını gösterir.
$ man -a stat
Başlıkta veya gövdede düzenli ifadeyle (regular expression) eşleşen kılavuz sayfalarını listeler:
$ man -k '\<copy\>.*archive'
ls(1) için kılavuz sayfasını gösterir ve sayfalayıcı olarak cat(1) kullanır:
$ man -P cat ls
ls(1) kılavuz sayfasının konumunu gösterir:
$ 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)