WHATIS(1) Utilitare ale paginatorului de manual WHATIS(1) NUME whatis - afieaza descrierile de paginilor de manual pe o singura linie REZUMAT whatis [-dlv?V] [-r|-w] [-s lista] [-m sistem[,...]] [-M ruta] [-L identificator_localizare] [-C fiier] nume ... DESCRIERE Fiecare pagina de manual are o descriere scurta disponibila in interiorul acesteia. whatis cauta numele paginilor de manual i afieaza descrierile paginii de manual al oricarui nume ce coincide. nume poate sa conina metacaractere (-w) sau sa fie o expresie regulata (-r). Utilizand aceste opiuni, poate fi necesar sa citai nume sau sa eludai (\) caracterele speciale pentru a impiedica interpretarea lor de catre shell. Bazele de date index sunt utilizate in timpul cautarii, i sunt actualizate de programul mandb. In funcie de instalare, acesta poate fi executat de o sarcina <> periodica, sau poate fi executat manual, dupa ce au fost instalate noi pagini de manual. Pentru a produce o baza de date whatis de text in stil vechi din baza de date relativa index, lansai comanda: whatis -M ruta-manual -w '*' | sort > ruta-manual/whatis unde ruta-manual este o ierarhie de pagini de manual precum /usr/man. OPIUNI -d, --debug Imprima informaiile de depanare. -v, --verbose Imprima mesaje de avertisment detaliate. -r, --regex Interpreteaza fiecare nume ca o expresie regulata. Daca un nume se potrivete cu orice parte a unui nume de pagina, o potrivire va fi facuta. Aceasta opiune cauzeaza whatis sa fie oarecum mai lent din cauza naturii cautarilor in bazele de date. -w, --wildcard Interpreteaza fiecare nume ca un model care conine metacaractere in stil shell. Pentru ca o potrivire sa fie facuta, un nume expandat trebuie sa se potriveasca cu numele intreg al paginii. Aceasta opiune cauzeaza ca whatis sa fie oarecum mai lent din cauza naturii cautarilor in bazele de date. -l, --long Nu reduce ieirea la laimea terminalului. In mod normal, ieirea va fi trunchiata la laimea terminalului pentru a evita rezultate nedorite din seciunile NUME scrise greit. -s lista, --sections=lista, --section=lista Cauta doar seciunile de manual specificate. lista, este o lista de seciuni separate prin doua puncte sau virgula. Daca o intrare din lista este o seciune simpla, de exemplu ,,3", atunci lista de descrieri afiata va include pagini din seciunile ,,3", ,,3perl", ,,3x", i aa mai departe; in timp ce, daca o intrare din lista are o extensie, de exemplu ,,3perl", atunci lista va include doar paginile din acea parte exacta a seciunii de manual. -m sistem[,...], --systems=sistem[,...] Daca acest sistem are acces la numele paginilor de manual ale altor sisteme de operare, acestea pot fi accesate utilizand aceasta opiune. Pentru a cauta numele paginilor ale <>, utilizai opiunea -m <>. sistem(ul) specificat poate fi o combinaie de nume de sisteme de operare separate prin virgula. Pentru a include o cautare pentru numele paginilor de manual ale sistemului de operare nativ, includei numele sistemului man in irul de argumente. Aceasta opiune va suprascrie variabila de mediu $SYSTEM. -M ruta, --manpath=ruta Specificai un set alternativ de ierarhii de pagini de manual, delimitate de doua puncte, pentru cautare. In mod implicit, whatis utilizeaza variabila de mediu $MANPATH, cu excepia cazului in care aceasta este goala sau nestabilita, caz in care va determina o ruta adecvata catre paginile de manual, pe baza variabilei de mediu $PATH. Aceasta opiune suprascrie coninutul lui $MANPATH. -L identificator_localizare, --locale=identificator_localizare whatis va determina in mod normal localizarea curenta printr-un apel la funcia C setlocale(3) care interogheaza diverse variabile de mediu, inclusiv $LC_MESSAGES i $LANG. Pentru a suprascrie temporar valoarea determinata, utilizai aceasta opiune pentru a furniza un ir identificator_localizare direct catre whatis. Reinei ca aceasta nu va avea efect pana cand cautarea paginilor nu incepe efectiv. Ieirea precum mesajul de ajutor va fi intotdeauna afiata in localizarea determinata iniial. -C fiier, --config-file=fiier Utilizeaza acest fiier de configurare al utilizatorului, mai degraba decat cel implicit din ~/.manpath. -?, --help Imprima un mesaj de ajutor i iese. --usage Imprima un mesaj scurt de utilizare i iese. -V, --version Afieaza informaii despre versiune. STARE DE IEIRE 0 Executarea programului s-a incheiat fara erori. 1 Eroare de utilizare, de sintaxa sau de fiier de configurare. 2 Eroare operaionala. 16 Nu s-a gasit nimic care sa se potriveasca cu criteriile specificate. MEDIU SYSTEM Daca $SYSTEM este stabilit, acesta va avea acelai efect ca i cum ar fi fost specificat ca argument la opiunea -m. MANPATH Daca $MANPATH este stabilita, valoarea acesteia va fi interpretata ca fiind ruta de cautare a ierarhiei paginilor de manual delimitata prin doua puncte care trebuie utilizata. Consultai seciunea RUTA DE CAUTARE din manpath(5) pentru comportamentul implicit i detalii despre modul in care este gestionata aceasta variabila de mediu. MANWIDTH Daca $MANWIDTH este stabilita, valoarea acesteia este utilizata ca laimea terminalului (consultai opiunea --long). Daca nu este stabilita, laimea terminalului va fi calculata utilizand valoarea de $COLUMNS, i ioctl(2) daca este disponibila, sau se revine la 80 de caractere daca orice altceva eueaza. FIIERE /usr/share/man/index.(bt|db|dir|pag) Memorie tampon a bazei de date index globala tradiionala. /var/cache/man/index.(bt|db|dir|pag) Memorie tampon a bazei de date index globala conform cu FHS. /usr/share/man/.../whatis O baza de date text whatis tradiionala. CONSULTAI I apropos(1), man(1), mandb(8) AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). DEFECIUNI https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 WHATIS(1)