Ö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 aracı, çevrimiçi kılavuz dokümantasyon sayfalarını bulur ve görüntüler. Eğer mansect belirtilirse, man aramayı kılavuzun belirli o bölümüyle sınırlandırır.
Kılavuzun bölümleri şunlardır: 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
man aracının anladığı seçenekler:
-M manpath Varsayılan arama yolu yerine, iki nokta üst üste ile ayrılmış belirli bir kılavuz yolunu 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”, değilse “less -s” değerini alır. MANPAGER ortam değişkenini geçersiz kılar; bu değişken de kendi içinde 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 liste ile 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 bağımsız değişkeni için yalnızca bulunan ilk sayfa yerine tüm kılavuz sayfalarını görüntüler.-d: Ek hata ayıklama bilgilerini yazdırır. Ayrıntı düzeyini artırmak için tekrarlayın. Kılavuz sayfasını görüntülemez.-f: whatis(1) aracı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 bir yardım iletisi görüntüler ve çıkar.-k: apropos(1) aracı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] Diğer platformlara özgü kılavuz sayfalarının aranmasına olanak tanıyacak şekilde varsayılan mimari ve makine ayarlarını geçersiz kılar. Bu seçenek macOS üzerinde 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ı öğrenmek 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ırılmadan önce verilen önişlemciler listesini kullanır. Geçerli önişlemci bağımsız değişkenleri:
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 araçlarının anladığı seçenekler:
-d: man aracının -d seçeneğiyle aynıdır.-s: man aracının -S seçeneğiyle aynıdır.
man aracı apropos veya whatis taklit modunda çalıştırıldığında, seçeneklerinin yalnızca bir alt kümesi dikkate alınacaktır. Özellikle, sunulan apropos ve whatis uygulamasında -d, -M, -P ve -S seçenekleri eşdeğer işlevselliğe sahiptir. Benzer şekilde MANPATH, MANSECT ve MANPAGER ortam değişkenleri de dikkate alınacaktır.
Uygulama Notları
Yerel Ayara Özgü Aramalar man aracı farklı yerel ayarlardaki kılavuz sayfalarını destekler. Arama davranışı; LC_ALL, LC_CTYPE veya LANG ortam değişkenlerinden boş olmayan bir dizeye sahip olan ilk değişkene göre belirlenir. 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 değişkeni “ja_JP.eucJP” olarak ayarlanmışsa, man /usr/share/man altındaki 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 aracı, bir ‘/’ karakteri içerdiği sürece, dosyaya giden bir yol geçirildiğinde belirli bir kılavuz sayfasının görüntülenmesini de destekler.
Ortam
Aşağıdaki ortam değişkenleri man aracı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” çı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 bu iki noktanın arasına yerleştirilir. Bu koşullardan hiçbiri karşılanmazsa standart arama yolunu geçersiz kılar.
MANROFFSEQ nroff(1) veya troff(1) çalıştırılmadan önce kılavuz kaynağı için önişlemcileri belirlemek amacıyla 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ış liste ile 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 veriliyorsa, 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. Eğer 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 aracı başarı durumunda 0 ile, bir hata oluşursa >0 ile çıkar.
Örnekler
stat(2) için kılavuz sayfasını göster:
$ man 2 stat
‘stat’ için tüm kılavuz sayfalarını göster.
$ man -a stat
Başlıkta veya gövdede düzenli ifadeyle (regular expression) eşleşen kılavuz sayfalarını listele:
$ man -k '\<copy\>.*archive'
ls(1) için kılavuz sayfasını göster ve sayfalayıcı (pager) olarak cat(1) kullan:
$ man -P cat ls
ls(1) kılavuz sayfasının konumunu göster:
$ man -w ls
Ayrıca Bkz.
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)
macOS 26.4 9 Ocak 2021 macOS 26.4