whatis - afișează descrierile de paginilor de manual
pe o singură linie
whatis [-dlv?V] [-r|-w] [-s
listă] [-m sistem[,...]] [-M
calea] [-L identificator_localizare] [-C
fișier] nume ...
Fiecare pagină de manual are o descriere scurtă
disponibilă în interiorul acesteia. whatis caută
numele paginilor de manual și afișează descrierile
paginii de manual al oricărui nume ce coincide.
nume poate să conțină metacaractere
(-w) sau să fie o expresie regulată (-r).
Utilizând aceste opțiuni, poate fi necesar să
citați nume sau să eludați (\) caracterele
speciale pentru a împiedica interpretarea lor de către
shell.
Bazele de date index sunt utilizate în timpul
căutării, și sunt actualizate de programul
mandb. În funcție de instalare, acesta poate fi
executat de o sarcină «cron» periodică, sau
poate fi executat manual, după ce au fost instalate noi pagini de
manual. Pentru a produce o bază de date whatis de text
în stil vechi din baza de date relativă index,
lansați comanda:
whatis -M cale-manual -w '*' | sort >
cale-manual/whatis
unde cale-manual este o ierarhie de pagini de manual precum
/usr/man.
- -d, --debug
- Imprimă informațiile de depanare.
- -v, --verbose
- Imprimă mesaje de avertisment detaliate.
- -r, --regex
- Interpretează fiecare nume ca o expresie regulată.
Dacă un nume se potrivește cu orice parte a unui nume
de pagină, o potrivire va fi făcută. Această
opțiune cauzează whatis să fie oarecum mai
lent din cauza naturii căutărilor în bazele de
date.
- -w,
--wildcard
- Interpretează fiecare nume ca un model care conține
metacaractere în stil shell. Pentru ca o potrivire să fie
făcută, un nume expandat trebuie să se
potrivească cu numele întreg al paginii. Această
opțiune cauzează ca whatis să fie oarecum mai
lent din cauza naturii căutărilor în bazele de
date.
- -l, --long
- Nu reduce ieșirea la lățimea terminalului. În
mod normal, ieșirea va fi trunchiată la
lățimea terminalului pentru a evita rezultate nedorite din
secțiunile NUME scrise greșit.
- -s listă,
--sections=listă,
--section=listă
- Caută doar secțiunile de manual specificate.
listă, este o listă de secțiuni separate prin
două puncte sau virgulă. Dacă o intrare din
listă este o secțiune simplă, de exemplu
„3”, atunci lista de descrieri afișată va
include pagini din secțiunile „3”,
„3perl”, „3x”, și așa mai
departe; în timp ce, dacă o intrare din listă
are o extensie, de exemplu „3perl”, atunci lista va include
doar paginile din acea parte exactă a secțiunii de
manual.
- -m sistem[,...],
--systems=sistem[,...]
- Dacă acest sistem are acces la numele paginilor de manual ale altor
sisteme de operare, acestea pot fi accesate utilizând
această opțiune. Pentru a căuta numele paginilor ale
«Noului_SO», utilizați opțiunea -m
«Nou_SO».
sistem(ul) specificat poate fi o combinație de
nume de sisteme de operare separate prin virgulă. Pentru a
include o căutare pentru numele paginilor de manual ale
sistemului de operare nativ, includeți numele sistemului
man în șirul de argumente. Această
opțiune va suprascrie variabila de mediu $SYSTEM.
- -M calea, --manpath=calea
- Specificați un set alternativ de ierarhii de pagini de manual,
delimitate de două puncte, pentru căutare. În mod
implicit, whatis utilizează variabila de mediu
$MANPATH, cu excepția cazului în care aceasta este
goală sau nestabilită, caz în care va determina o
cale adecvată către paginile de manual, pe baza variabilei
de mediu $PATH. Această opțiune suprascrie
conținutul lui $MANPATH.
- -L identificator_localizare, --locale=identificator_localizare
- whatis va determina în mod normal localizarea curentă
printr-un apel la funcția C setlocale(3) care
interoghează diverse variabile de mediu, inclusiv
$LC_MESSAGES și $LANG. Pentru a suprascrie temporar
valoarea determinată, utilizați această
opțiune pentru a furniza un șir
identificator_localizare direct către whatis.
Rețineți că aceasta nu va avea efect
până când căutarea paginilor nu începe
efectiv. Ieșirea precum mesajul de ajutor va fi întotdeauna
afișată în localizarea determinată
inițial.
- -C fișier, --config-file=fișier
- Utilizează acest fișier de configurare al utilizatorului,
mai degrabă decât cel implicit din ~/.manpath.
- -?, --help
- Imprimă un mesaj de ajutor și iese.
- --usage
- Imprimă un mesaj scurt de utilizare și iese.
- -V, --version
- Afișează informații despre versiune.
- 0
- Executarea programului s-a încheiat fără erori.
- 1
- Eroare de utilizare, de sintaxă sau de fișier de
configurare.
- 2
- Eroare operațională.
- 16
- Nu s-a găsit nimic care să se potrivească cu
criteriile specificate.
- SYSTEM
- Dacă $SYSTEM este stabilit, acesta va avea același
efect ca și cum ar fi fost specificat ca argument la
opțiunea -m.
- MANPATH
- Dacă $MANPATH este stabilită, valoarea acesteia va fi
interpretată ca, calea delimitată de două puncte
pentru ierarhiile de pagini de manual care urmează să fie
utilizate.
Consultați secțiunea CALEA DE
CĂUTARE din manpath(5) pentru comportamentul implicit
și detalii despre modul în care este gestionată
această variabilă de mediu.
- MANWIDTH
- Dacă $MANWIDTH este stabilită, valoarea acesteia este
utilizată ca lățimea terminalului (consultați
opțiunea --long). Dacă nu este stabilită,
lățimea terminalului va fi calculată utilizând
valoarea de $COLUMNS, și ioctl(2) dacă este
disponibilă, sau se revine la 80 de caractere dacă orice
altceva eșuează.
- /usr/share/man/index.(bt|db|dir|pag)
- Memorie tampon a bazei de date index globală
tradițională.
- /var/cache/man/index.(bt|db|dir|pag)
- Memorie tampon a bazei de date index globală conform cu
FHS.
- /usr/share/man/.../whatis
- O bază de date text whatis tradițională.
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db