İSİM
whatis - tek satır kılavuz sayfası
tanımı görüntüler
ÖZET
whatis [-dlv?V] [-r|-w] [-s
list] [-m system[,...]] [-M path]
[-L locale] [-C file] name ...
Her kılavuz sayfasında kısa bir
açıklama bulunur. whatis kılavuz sayfa
adlarını arar ve eşleşen herhangi bir ad
kılavuz sayfası açıklamalarını
görüntüler.
name, joker karakterler (-w) içerebilir veya
düzenli bir ifade olabilir (-r). Bu seçenekleri
kullanarak, kabuğun yorumlanmasını durdurmak
için name'i tırnaklamak veya özel karakterlerden
kaçırmak (\) gerekebilir.
index veritabanları arama sırasında
kullanılır ve mandb programı tarafından
güncellenir. Yüklemenize bağlı olarak bu,
periyodik bir cron işi ile
çalıştırılabilir veya yeni kılavuz
sayfaları yüklendikten sonra elle
çalıştırılması gerekebilir.
Göreceli index veritabanından eski bir stil metin
whatis veritabanını üretmek için
şu komutu çalıştırın:
whatis -M manpath -w '*' | sort >
manpath/whatis
ki burada manpath /usr/man gibi bir kılavuz
sayfa hiyerarşisidir.
- -d, --debug
- Hata ayıklama bilgisini göster.
- -v, --verbose
- Ayrıntılı uyarı iletilerini
göster.
- -r, --regex
- Her name ögesini düzenli bir ifade olarak yorumla.
Bir name, bir sayfa adının herhangi bir
bölümüyle eşleşirse, bir
eşleşme yapılır. Bu seçenek,
veritabanı aramalarının niteliğinden
dolayı whatis'in biraz daha yavaş olmasına
neden olur.
- -w,
--wildcard
- Her name ögesini kabuk stili joker karakterlerini
içeren bir desen olarak yorumla. Bir eşleşme
için, genişletilmiş bir name tüm sayfa
adıyla eşleşmelidir. Bu seçenek,
veritabanı aramalarının niteliğinden
dolayı whatis'in biraz daha yavaş olmasına
neden olur.
- -l, --long
- Çıktıyı terminal genişliğine
kırpmayın. Normalde, çıktı,
kötü yazılmış NAME
bölümlerinden çirkin sonuçlardan
kaçınmak için terminal genişliğine
kesilir.
- -s liste,
--sections liste, --section liste
- Yalnızca verilen klavuz bölümlerinde arama
yapın. list, bölümlerin virgül veya
virgül ile ayrılmış bir listesidir.
list içindeki bir girdi, örneğin "3"
gibi basit bir bölümse, görüntülenen
açıklamalar listesinde "3", "3perl",
"3x" ve benzeri bölümlerdeki sayfalar bulunur;
list içindeki bir girdi, örneğin
"3perl" gibi bir uzantıya sahipse, liste el
kitabının tam kısmında yalnızca
sayfaları içerecektir.
-m system[,...],
--systems=system[,...]
Bu sistemin diğer işletim sisteminin
kılavuz sayfa adlarına erişimi varsa, bu seçenek
kullanılarak erişilebilir. NewOS'un kılavuz sayfa
adlarını aramak için
-m NewOS
seçeneğini kullanın.
Belirtilen system, virgülle
ayrılmış işletim sistemi adlarının
birleşimi olabilir. Yerel işletim sisteminin kılavuz
sayfa adlarını aramak için, argüman karakter
katarına man sistem adını ekleyin. Bu
seçenek, $SYSTEM ortam değişkeninin
üzerine yazılır.
- -M path, --manpath=path
- Aranacak şekilde iki nokta üst üstü ile
ayrılmış kılavuz sayfa hiyerarşileri
dizisi belirtin. Varsayılan olarak, whatis, boş veya
ayarlanmamışsa, $MANPATH ortam
değişkenini kullanır; bu durumda, $PATH ortam
değişkeninize dayalı uygun bir kılavuz yolu
belirleyecektir. Bu seçenek, $MANPATH
içeriğini geçersiz kılar.
- -L locale, --locale=locale
- whatis normalde mevcut yerel ayarınızı,
muhtemelen $LC_MESSAGES ve $LANG öğelerini de
içeren çeşitli ortam değişkenlerini
sorgulayan C işlevi setlocale (3)
çağrısı ile belirleyecektir. Belirlenen
değeri geçici olarak geçersiz kılmak
için doğrudan bir locale dizesini whatis 'a
sunmak için bu seçeneği kullanın. Sayfalar
için arama gerçekten başlayıncaya kadar etkili
olmayacağını unutmayın. Yardım
mesajı gibi çıktı her zaman
başlangıçta belirlenen yerel ayraçta
görüntülenir.
- -C file, --config-file=file
- ~/.manpath varsayılanı yerine bu
kullanıcı yapılandırma dosyasını
kullanın.
- -?, --help
- Bir yardım iletisi göster ve çık.
- --usage
- Kısa kullanım iletisini göster ve
çık.
- -V, --version
- Sürüm bilgisini göster.
ÇIKIŞ DURUMU
- 0
- Başarılı program
çalıştırma.
- 1
- Kullanım, sözdizimi ve yapılandırma dosya
hatası.
- 2
- İşlevsel hata.
- 16
- Belirtilen kriterle eşleşen hiçbir şey
bulunamadı.
- SYSTEM
- $SİSTEM ayarlanmışsa, -m
seçeneğine argüman olarak
belirtilmişçesine aynı etkiyi verecektir.
- MANPATH
- $MANYOLU ayarlanmışsa, değeri, iki nokta
üstüste ile ayrılmış
kullanılacak kılavuz sayfa arama yolu olarak
yorumlanır.
- MANWIDTH
- $MANWIDTH ayarlanmışsa, değeri terminal
genişliği olarak kullanılır (bkz.
--long seçeneği). Belirlenmezse, terminal
genişliği $COLUMNS değerini, varsa bir
ioctl (2) değerini kullanarak veya başka herhangi bir
şey başarısız olursa 80 karaktere geri
düşerek hesaplanır.
- /usr/share/man/index.(bt|db|dir|pag)
- Geleneksel bir evrensel index veritabanı
önbelleği.
- /var/cache/man/index.(bt|db|dir|pag)
- FHS uyumlu bir evrensel index veritabanı
önbelleği.
- /usr/share/man/.../whatis
- Geleneksel bir whatis metin veritabanı.
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).