Syntax
whatis [-dhV] [-r|-w] [-m System[,…]] [-M Pfad] Schlüsselwort …
Beschreibung
Innerhalb jeder Manualseite ist eine Kurzbeschreibung vorhanden. whatis sucht Schlüsselwort in den Kurzbeschreibungen der Indexdatenbank. Falls es eine solche nicht im Manualpfad gibt, durchsucht es die whatis- Datenbank nach Schlüsselwort. Diese Version von whatis kann Schlüsselwörter suchen, die Wildcards oder reguläre Ausdrücke enthalten.mandb erzeugt die Indexdatenbank für jeden Manualpfad. Um eine Datei im alten Stil als whatis- Datenbank aus der Indexdatenbank zu erzeugen, ist folgender Befehl einzugeben
whatis -M Pfad -w ‚*‘ | sort > manpath/whatis
wobei Pfad eine Manualhierarchie wie /usr/man ist.
Optionen
- -d, –debug
- Ausgeben von Fehlerinformationen.
- -r, –regex
- Interpretiert jedes Schlüsselwort als regulären Ausdruck. Wenn ein Schlüsselwort irgendeinem Teil eines Seitennamens entspricht, wird eine Übereinstimmung gefunden.
- -w, –wildcard
- Das Schlüsselwort kann Wildcards wie in der Shell beinhalten. Um eine Übereinstimmung zu finden, muß ein expandiertes Schlüsselwort mit einem kompletten Seitennamen übereinstimmen.
-m System [,…], –systems=System[,…]
Wenn auch Manualseiten von einem anderen Betriebssystem installiert sind, so kann auf sie mit dieser Option zugegriffen werden. Um beispielsweise die Manualseiten von NewOS zu durchsuchen, muß -m NewOS angegeben werden.Das angegebene System kann eine durch Kommata abgetrennte Aufzählung von Betriebssystemnamen sein. Die normalen Seiten werden durch den Betriebssystemnamen man angesprochen. Diese Option überschreibt die Umgebungsvariable $SYSTEM.
- -M Pfad, –manpath=Pfad
- Gibt die Manualpfade an. Wenn mehrere Pfade angegeben werden, müssen diese durch Doppelpunkte getrennt sein. Als Default benutzt whatis manpath, um den Suchpfad zu bestimmen. Diese Option überschreibt die Umgebungsvariable $MANPATH.
- -h, –help
- Zeigt einen Hilfstext an.
- -V, –version
- Zeigt Programmversion und Autor an.
Dateien
- /var/catman/…/index.(bt|db|dir|pag)
- Die FSSTND complianten globalen Indexdatenbanken.
- /usr/man/…/whatis
- Traditionelle whatis Datenbank.
Siehe Auch
apropos(1) , man(1) , mandb(8) .Fehler
Wenn die -r oder -w Optionen benutzt werden und Shell-Metazeichen in einem Schlüsselwort vorkommen, kann es notwendig sein, Schlüsselwort zu quoten, damit die Shell nicht versucht, diese Zeichen zu interpretieren.Die -r und -w Optionen können verwirrende Ausgaben erzeugen und verlangsamen die Suche.
Autor
Wilf. (G.Wilford@ee.surrey.ac.uk), die deutsche Übersetzung ist von Anke Steuernagel (a_steuer@informatik.uni-kl.de) und Nils Magnus (magnus@informatik.uni-kl.de).