| WHATIS(1) | Rokasgrāmatu lapotāja rīki | WHATIS(1) |
NOSAUKUMS
whatis - parādīt rokasgrāmatas lapu vienrindas aprakstus
KOPSAVILKUMS
whatis [-dlv?V] [-r|-w] [-s saraksts] [-m sistēma[,...]] [-M ceļš] [-L lokāle] [-C fails] nosaukums ...
APRAKSTS
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.
OPCIJAS
- -d, --debug
- Izvadīt atkļūdošanas informāciju.
- -v, --verbose
- Izvadīt detalizētus brīdinājuma ziņojumus.
- -r, --regex
- 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.
- -w, --wildcard
- 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.
- -l, --long
- 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ēļ.
- -s saraksts, --sections=saraksts, --section=saraksts
- 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.
- -m sistēma[,...], --systems=sistēma[,...]
- 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.
- -M ceļš, --manpath=ceļš
- 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.
- -L lokāle, --locale=lokāle
- 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ē.
- -C fails, --config-file=fails
- Izmantot šo lietotāja konfigurācijas failu noklusējuma ~/.manpath vietā.
- -?, --help
- Izvadīt palīdzības ziņojumu un iziet.
- --usage
- Izvadīt īsu lietošanas ziņojumu un iziet.
- -V, --version
- Parādīt versijas informāciju.
IZPILDES STATUSS
- 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.
VIDE
- SYSTEM
- Ja $SYSTEM ir iestatīts, tam būs tāda pati ietekme, it kā tas būtu norādīts kā opcijas -m arguments.
- MANPATH
- 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ĻŠ.
- MANWIDTH
- 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.
FAILI
- /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.
SKATĪT ARĪ
AUTORS
Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org).
KĻŪDAS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
| 2026-11-16 | 2.13.3 |