Handbuchseiten

 

 

Name

whatis - durchsucht die Indexdatenbank nach Kurzbeschreibungen

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