WHATIS(1) Utilitare ale paginatorului de manual WHATIS(1)

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.

Imprimă informațiile de depanare.
Imprimă mesaje de avertisment detaliate.
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.
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.
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.
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.
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.

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.
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.
Utilizează acest fișier de configurare al utilizatorului, mai degrabă decât cel implicit din ~/.manpath.
-?, --help
Imprimă un mesaj de ajutor și iese.
Imprimă un mesaj scurt de utilizare și iese.
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.

Dacă $SYSTEM este stabilit, acesta va avea același efect ca și cum ar fi fost specificat ca argument la opțiunea -m.
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.

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ă.

apropos(1), man(1), mandb(8)

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

https://gitlab.com/cjwatson/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2022-03-17 2.10.2