WHATIS(1) Rokasgrāmatu lapotāja rīki WHATIS(1)

whatis - parādīt rokasgrāmatas lapu vienrindas aprakstus

whatis [-dlv?V] [-r|-w] [-s saraksts] [-m sistēma[,...]] [-M ceļš] [-L lokāle] [-C fails] nosaukums ...

Katrā rokasgrāmatas lapā ir pieejams īss apraksts. whatis meklē rokasgrāmatas lapu nosaukumos un parāda rokasgrāmatas lapu aprakstus visiem atbilstošajiem nosaukumiem.

nosaukums var saturēt aizstājējzīmes (-w) vai būt regulārā izteiksme (-r). Izmantojot šīs opcijas, var būt nepieciešams nosaukumu likt pēdiņās vai īpašajām rakstzīmēm likt priekšā atpakaļvērsto slīpsvītru (\), lai čaula tās neinterpretētu.

Meklēšanā tiek izmantotas index datubāzes, ko atjaunina programma mandb. Atkarībā no jūsu instalācijas to var palaist periodisks cron uzdevums, vai arī tā jāpalaiž manuāli pēc jaunu rokasgrāmatas lapu instalēšanas. Lai no relatīvās index datubāzes izveidotu vecā stila teksta whatis datubāzi, izpildiet komandu:

whatis -M manpath -w '*' | sort > manpath/whatis

kur manpath ir rokasgrāmatas lapu hierarhija, piemēram, /usr/man.

Izvadīt atkļūdošanas informāciju.
Izvadīt detalizētus brīdinājuma ziņojumus.
Interpretēt katru nosaukumu kā regulāro izteiksmi. Ja nosaukums atbilst jebkurai lapas nosaukuma daļai, tiek konstatēta atbilstība. Datubāzes meklēšanas rakstura dēļ šī opcija padara whatis nedaudz lēnāku.
Interpretēt katru nosaukumu kā šablonu ar čaulas stila aizstājējzīmēm. Lai tiktu konstatēta atbilstība, izvērstajam nosaukumam jāatbilst visam lapas nosaukumam. Datubāzes meklēšanas rakstura dēļ šī opcija padara whatis nedaudz lēnāku.
Neapgriezt izvadi līdz termināļa platumam. Parasti izvade tiek apgriezta līdz termināļa platumam, lai izvairītos no neglītiem rezultātiem slikti uzrakstītu NAME sadaļu dēļ.
Meklēt tikai norādītajās rokasgrāmatas sadaļās. saraksts ir ar koliem vai komatiem atdalīts sadaļu saraksts. Ja kāds saraksta ieraksts ir vienkārša sadaļa, piemēram, "3", tad parādītajā aprakstu sarakstā būs lapas no sadaļām "3", "3perl", "3x" utt.; savukārt, ja saraksta ierakstam ir paplašinājums, piemēram, "3perl", sarakstā būs tikai lapas no šīs konkrētās rokasgrāmatas sadaļas daļas.
Ja šai sistēmai ir piekļuve citu operētājsistēmu rokasgrāmatas lapu nosaukumiem, tiem var piekļūt ar šo opciju. Lai meklētu NewOS rokasgrāmatas lapu nosaukumos, izmantojiet opciju -m NewOS.

Norādītā sistēma var būt ar komatiem atdalītu operētājsistēmu nosaukumu kombinācija. Lai iekļautu meklēšanu vietējās operētājsistēmas rokasgrāmatas lapu nosaukumos, iekļaujiet argumentu virknē sistēmas nosaukumu man. Šī opcija ignorē vides mainīgo $SYSTEM.

Norādīt alternatīvu ar koliem atdalītu rokasgrāmatas lapu hierarhiju kopu, kurā meklēt. Pēc noklusējuma whatis izmanto vides mainīgo $MANPATH, ja vien tas nav tukšs vai iestatīts; tādā gadījumā tā noteiks piemērotu manpath, pamatojoties uz jūsu vides mainīgo $PATH. Šī opcija ignorē $MANPATH saturu.
whatis parasti nosaka jūsu pašreizējo lokāli, izsaucot C funkciju setlocale(3), kas vaicā dažādus vides mainīgos, iespējams, arī $LC_MESSAGES un $LANG. Lai uz laiku ignorētu noteikto vērtību, izmantojiet šo opciju, lai whatis tieši padotu lokāles virkni. Ņemiet vērā, ka tā stāsies spēkā tikai tad, kad faktiski sāksies lapu meklēšana. Tāda izvade kā palīdzības ziņojums vienmēr tiks rādīta sākotnēji noteiktajā lokālē.
Izmantot šo lietotāja konfigurācijas failu noklusējuma ~/.manpath vietā.
-?, --help
Izvadīt palīdzības ziņojumu un iziet.
Izvadīt īsu lietošanas ziņojumu un iziet.
Parādīt versijas informāciju.

0
Veiksmīga programmas izpilde.
1
Lietošanas, sintakses vai konfigurācijas faila kļūda.
2
Darbības kļūda.
16
Netika atrasts nekas, kas atbilstu norādītajiem kritērijiem.

Ja $SYSTEM ir iestatīts, tam būs tāda pati ietekme, it kā tas būtu norādīts kā opcijas -m arguments.
Ja $MANPATH ir iestatīts, tā vērtība tiek interpretēta kā izmantojamais ar koliem atdalītais rokasgrāmatas lapu hierarhiju meklēšanas ceļš.

Noklusējuma uzvedību un sīkāku informāciju par to, kā tiek apstrādāts šis vides mainīgais, skatiet manpath(5) sadaļā MEKLĒŠANAS CEĻŠ.

Ja $MANWIDTH ir iestatīts, tā vērtība tiek izmantota kā termināļa platums (skatiet opciju --long). Ja tas nav iestatīts, termināļa platums tiks aprēķināts, izmantojot $COLUMNS vērtību un ioctl(2), ja pieejams, vai, ja nekas cits neizdodas, tiks izmantotas 80 rakstzīmes.

/usr/share/man/index.(bt|db|dir|pag)
Tradicionāla globāla index datubāzes kešatmiņa.
/var/cache/man/index.(bt|db|dir|pag)
FHS atbilstoša globāla index datubāzes kešatmiņa.
/usr/share/man/.../whatis
Tradicionāla whatis teksta datubāze.

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/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2026-11-16 2.13.3