APROPOS(1) Dienstprogramme fur Handbuchseiten APROPOS(1) BEZEICHNUNG apropos - Suche in Handbuchseiten und deren Kurzbeschreibungen UBERSICHT apropos [-dalv?V] [-e|-w|-r] [-s Liste] [-m System[,...]] [-M Pfad] [-L Locale] [-C Datei] Schlusselwort ... BESCHREIBUNG Jede Handbuchseite enthalt eine kurze Beschreibung. apropos durchsucht diese Beschreibungen nach dem Vorkommen von Schlusselwort. Das Schlusselwort ist gewohnlich ein regularer Ausdruck und hat den gleichen Effekt wie (-r). Es kann ausserdem nach einer bestimmten Zeichenkette (-e) oder nach Zeichenketten mit Platzhaltern (Wildcards, -w) gesucht werden. Bei Nutzung dieser Optionen kann es erforderlich sein, fur das Schlusselwort und Sonderzeichen eine Verarbeitung durch die Shell zu vermeiden. Fur Schlusselworter werden dafur Anfuhrungszeichen und fur Sonderzeichen Escape-Sequenzen (\) verwendet. Die Regeln fur die Standardsuche ermoglichen den Abgleich des Suchbegriffs mit dem Namen der Handbuchseite und Wortgrenzen in der Beschreibung. Bei der Suche wertet apropos die von mandb gepflegte Datenbank aus. Abhangig von Ihrer Installation wird die Datenbank periodisch per Cron-Job aktualisiert - oder Sie mussen nach der Installation neuer Handbuchseiten mandb manuell starten. OPTIONEN -d, --debug Ausgabe von Debug-Informationen -v, --verbose Ausgabe ausfuhrlicher Warnmeldungen -r, --regex Interpretiert jedes Schlusselwort als regularen Ausdruck. Dies ist das Standardverhalten. Jedes Schlusselwort wird unabhangig voneinander in den Befehlsnamen und in den Beschreibungen gesucht. Die Suche liefert auch Treffer uber Wortgrenzen hinweg. -w, --wildcard Interpretiert jedes Schlusselwort als Muster, das Shell-Platzhalter enthalt. Jedes Schlusselwort wird unabhangig voneinander in den Befehlsnamen und in den Beschreibungen gesucht. Wird ausserdem --exact vorgegeben, wird nur die Ubereinstimmung des Schlusselworts nach Ersetzung des regularen Ausdrucks mit der vollstandigen Beschreibung oder dem Namen einer Handbuchseite als Treffer gewertet. Anderenfalls gelten auch einzelne Worter in der Beschreibung als Treffer. -e, --exact Jedes Schlusselwort wird genau mit den Seitennamen und den Beschreibungen verglichen. -a, --and Zeigt nur Eintrage an, die alle angegebenen Schlusselworter enthalten. Standardverhalten ist die Anzeige aller Eintrage, die irgendeines der Schlusselworter enthalten. -l, --long Die Ausgabe wird nicht auf die Terminalbreite beschnitten. Normalerweise wird die Ausgabe auf die Terminalbreite gestutzt, um hassliche Ergebnisse schlecht geschriebener BEZEICHNUNGs-Abschnitte zu vermeiden. -s Liste, --sections=Liste, --section=Liste Durchsucht nur die vorgegebenen Abschnitte. Liste ist eine durch Kommas oder Doppelpunkte gegliederte Liste von Abschnitten. Wenn ein Eintrag in Liste ein einfacher Abschnitt ist (z. B. >>3<<), enthalt das Ergebnis Seiten aus den Abschnitten >>3<<, >>3perl<<, >>3x<< usw. Wird Abschnitt mit Suffix angegeben (z. B. >>3perl<<), werden die Ergebnisse nur in diesem speziellen Unterabschnitt gesucht. -m system[,...], --systems=System[,...] Wenn Ihr System auch auf die Handbuchseiten eines anderen Betriebssystems zugreifen kann, konnen diese mit dieser Option durchsucht werden. Um die Beschreibungen der Handbuchseiten von NewOS zu durchsuchen, verwenden Sie die Option -m NewOS. Fur System konnen Sie eine mit Kommas getrennte Liste von Betriebssystem-Namen eingeben. Um auch in den whatis-Beschreibungen des eigenen Systems zu suchen, verwenden Sie beim Aufruf des Programms den Systemnamen man als zusatzliches Argument. Diese Option setzt die Umgebungsvariable $SYSTEM ausser Kraft. -M Pfad, --manpath=Pfad Legt mehrere durch Doppelpunkte getrennte alternative Handbuch-Hierarchien fest, die durchsucht werden sollen. Standardmassig verwendet apropos die Umgebungsvariable $MANPATH. Wenn diese leer ist oder ihr kein Wert zugewiesen wurde, wird das Programm versuchen, auf Grundlage der Umgebungsvariablen $PATH einen geeigneten >>Manpath<< zu bestimmen. Diese Option uberschreibt den Inhalt von $MANPATH. -L Locale, --locale=Locale apropos wird in der Regel Ihre aktuelle Locale durch einen Aufruf der C-Funktion setlocale(3) bestimmen, welche verschiedene Umgebungsvariablen auswertet (darunter sind eventuell auch $LC_MESSAGES und $LANG). Um den ermittelten Wert vorubergehend ausser Kraft zu setzen, konnen Sie apropos mit dieser Option eine Locale vorgeben. Beachten Sie, dass dieser Wert erst wirksam wird, wenn die Suche tatsachlich beginnt. Programm-Meldungen wie Hilfe-Nachrichten werden immer in der zu Anfang ermittelten Locale angezeigt werden. -C Datei, --config-file=Datei Verwendung dieser benutzerspezifischen Konfigurationsdatei an Stelle der Vorgabe ~/.manpath -?, --help Hilfetext anzeigen und beenden --usage zeigt eine kurze Anwendungszusammenfassung an und beendet das Programm. -V, --version Versionsinformation anzeigen und beenden EXIT-STATUS 0 erfolgreiche Programmausfuhrung 1 Fehler beim Aufruf, in der Syntax oder in der Konfigurationsdatei 2 betriebsbedingter Fehler 16 keine Ergebnisse fur die angegebenen Suchkriterien UMGEBUNGSVARIABLEN SYSTEM Wenn $SYSTEM gesetzt ist, hat das die gleiche Wirkung wie die Verwendung als Argument fur die Option -m. MANPATH Wenn $MANPATH gesetzt ist, wird ihr Wert als der mit Kommas getrennte anzuwendende Hierarchie-Suchpfad fur Handbuchseiten interpretiert. Siehe den Abschnitt SUCHPFAD in der Handbuchseite manpath(5) fur das Standardverhalten und Details dazu, wie mit dieser Umgebungsvariable umgegangen wird. MANWIDTH Wenn $MANWIDTH gesetzt ist, wird ihr Wert als Terminalbreite verwendet (siehe die Option --long). Ist sie nicht gesetzt, wird die Terminalbreite mittels ioctl(2) oder mit dem Wert von $COLUMNS ermittelt, wenn diese Variable gesetzt ist. Wenn alles fehlschlagt, werden 80 Zeichen verwendet. POSIXLY_CORRECT Wenn $POSIXLY_CORRECT gesetzt ist, wobei sogar NULL erlaubt ist, wird die Standardsuche von apropos mit erweiterten regularen Ausdrucken (-r) ausgefuhrt. Heutzutage ist dies sowieso das Standardverhalten. DATEIEN /usr/share/man/index.(bt|db|dir|pag) ein traditioneller, globaler Zwischenspeicher fur die Index-Datenbank /var/cache/man/index.(bt|db|dir|pag) ein FHS-konformer, globaler Zwischenspeicher fur die Index-Datenbank /usr/share/man/.../whatis eine traditionelle whatis-Textdatenbank SIEHE AUCH man(1), whatis(1), mandb(8) AUTOR Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). FEHLER https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 APROPOS(1)