Man: Unterschied zwischen den Versionen

Aus Foxwiki
Saidmustafavi (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Saidmustafavi (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Zeile 2: Zeile 2:


Mit dem Befehl "man" kann man in einer Konsole eine Manual (Anleitung) für auf dem PC installierte Software oder andere Konsolenbefehle aufrufen.
Mit dem Befehl "man" kann man in einer Konsole eine Manual (Anleitung) für auf dem PC installierte Software oder andere Konsolenbefehle aufrufen.
==man – Anleitung zum Befehl anzeigen==
Wenn ihr über einen Befehl stolpert und nicht wisst, was er tut. Gebt einfach man ein, gefolgt von dem Befehl. Dann seht ihr eine Anleitung (Manual), wie dieser funktioniert. Mit den Pfeiltasten könnt ihr durch die Anleitung im Terminal scrollen. Mit der Taste Q beendet ihr die Anleitung.




Zeile 44: Zeile 48:
*''Bugs'' – bekannte Fehler
*''Bugs'' – bekannte Fehler
*''Files'' – Konfigurationsdateien u. Ä.
*''Files'' – Konfigurationsdateien u. Ä.
Es sind noch mehr Elemente denkbar, aber die hier aufgeführten sind die wohl geläufigsten.


==$MANPATH und die Datei manpath.config==
* Wie bereits erwähnt, enthält die Variable <code>$MANPATH</code> Informationen darüber, wo sich die Manpages überhaupt befinden<br>
* Genauere Informationen darüber erhalten Sie in der Konfigurationsdatei ''/etc/manpath.config.'' Wenn dem System neue Manpages hinzugefügt werden, wird diese Datei normalerweise bei Bedarf auch automatisch aktualisiert<br>
* Ein manueller Eingriff ist in der Regel nicht nötig. Um den aktuellen MANPATH zu ermitteln, geben Sie einfach das Kommando <code>manpath</code> ohne Parameter ein. Das Ergebnis sieht dann beispielsweise so aus:
archangel:/ # manpath
/usr/share/man:/usr/local/man:/usr/X11R6/man:/opt/gnome/share/man
* Ein weiterer wichtiger Pfad ist der, in dem das Mansystem seine Temporärdateien ablegt. Wie bereits erwähnt, sind Manpages im Rohformat komprimiert. Deshalb werden sie vor dem Anzeigen in ein temporäres Verzeichnis dekomprimiert<br>
* In der Regel handelt es sich hierbei um das Verzeichnis ''/var/cache/man.'' Dieses Verzeichnis wird, gestützt durch den Daemon cron, zyklisch von catman bereinigt<br>
* Um das Cache-Verzeichnis Ihres Computers ausfindig zu machen, geben Sie das Kommando <code>manpath -c</code> ein:
archangel:/ # manpath -c
/var/cache/man:/var/cache/man/local:/var/cache/man/opt






[[Category:Linux:Dokumentation]]
[[Category:Linux:Dokumentation]]

Version vom 5. November 2020, 13:33 Uhr

Funktion

Mit dem Befehl "man" kann man in einer Konsole eine Manual (Anleitung) für auf dem PC installierte Software oder andere Konsolenbefehle aufrufen.

man – Anleitung zum Befehl anzeigen

Wenn ihr über einen Befehl stolpert und nicht wisst, was er tut. Gebt einfach man ein, gefolgt von dem Befehl. Dann seht ihr eine Anleitung (Manual), wie dieser funktioniert. Mit den Pfeiltasten könnt ihr durch die Anleitung im Terminal scrollen. Mit der Taste Q beendet ihr die Anleitung.


Beispiel

so schreibt man das Kommando |

     man man
Datei:Screenshot 20201104 095015.png

Mehr Beispiele

man ls, man cat, man cp und soweiter und sofort.

Funktionsweise

  • Immer, wenn Sie eine man Page aufrufen, konsultiert das Programm man die in der Variablen $MANPATH enthaltenen Verzeichnisse. Hier können mehrere Verzeichnisse auf einmal hinterlegt sein
  • In nach Sektionen unterteilten Unterverzeichnissen befinden sich die Dateien der man Pages im komprimierten Zustand
  • Das man System dekomprimiert die angeforderte Datei und übergibt sie anschließend an einen Pager. Dieser zeigt daraufhin die gewünschte man Page an.

Sektionen

Das Man System ist in mehrere Sektionen unterteilt. Diese Sektionen sind folgendermaßen gegliedert:

  • ausführbare Programme für Benutzer
  • Systemaufrufe (Funktionen, die durch den Kernel unterstützt werden)
  • Bibliothek aufrufe (Libraries)
  • besondere Dateien (normalerweise in /dev)
  • Dateiformate und Konventionen
  • Spiele
  • Sonstiges (Makro-Pakete und Konventionen)
  • administrative Programme (nur für den User root)
  • Kernel-Routinen (nicht standardisiert)

Aufbau

Der Aufbau einer Manpage ist festgelegt und sollte immer die folgenden Elemente enthalten:

  • Name – die Bezeichnung des Elements mit einer kurzen Beschreibung
  • Synopsis – eine vollständige Kurzbeschreibung der Syntax
  • Description – eine ausführliche Beschreibung des Elements
  • Defaults – voreingestellte Parameter
  • Overview – ein Überblick über die komplexeren Zusammenhänge
  • Options – Optionen und deren Beschreibung
  • Return Values – Informationen über eventuelle Rückgabewerte, teilweise auch als Exit-Status bezeichnet
  • See also – Verweise auf artverwandte Themen
  • Bugs – bekannte Fehler
  • Files – Konfigurationsdateien u. Ä.