Man pages - Versionsgeschichte

OmasEnkel: /* LINUX-Hilfesystem im Überblick */

2007-05-21T08:40:12Z

‎LINUX-Hilfesystem im Überblick

Robi: Rechtschreibung

2006-12-29T20:58:57Z

Rechtschreibung

Griffin am 23. September 2006 um 15:30 Uhr

2006-09-23T15:30:00Z

Robi am 5. September 2006 um 18:14 Uhr

2006-09-05T18:14:29Z

Robi am 5. September 2006 um 15:47 Uhr

2006-09-05T15:47:55Z

Neue Seite

@@ Zeile 7: / Zeile 7: @@
 === LINUX-Hilfesystem im Überblick ===
 '''1 Programmierte Hilfe:'''
-: die meisten Programme erzeugen bei falschem Aufruf eine kurzen Hilfetext
+: Die meisten Programme erzeugen bei falschem Aufruf eine kurzen Hilfetext.
-: dieser kann auch meist mit mit der Option --help oder -h erzeugt werden
+: Dieser kann auch meist mit mit der Option --help oder -h erzeugt werden.
 '''2 Handbuchseiten oder ManPages'''
-: fast jedes Programm, ein Vielzahl von Konfigurationsdateien, System- und Bibliotheksaufrufe haben Handbuchseiten
+: Fast jedes Programm, ein Vielzahl von Konfigurationsdateien, System- und Bibliotheksaufrufe haben Handbuchseiten. Sie werden meist mit dem Programm mitinstalliert. Diese liegen in einem speziellem Format nach Sektionen sortiert mit einer definierten Gliederung in verschiedenen Verzeichnissen.
-: sie werden meist mit dem Programm mitinstalliert
+: Es gibt eine Indexdatei und einen Suchpath sowie eine Listorder.
-: liegen in einem Speziellem Format nach Sektionen sortiert mit einer definierten Gliederung in verschiedenen Verzeichnissen
+: Die Manpages können zur Anzeige in verschiedene Formate transformiert werden
 '''3 Info-Seiten'''
-: nach dem Prinzip von Hypertext aufgebautes Infosystem für einige Befehle
+: Nach dem Prinzip von Hypertext aufgebautes Infosystem für einige Befehle.
-: ist für einige Befehle wesentliche umfangreicher als die Manpages
+: Sie sind für einige Befehle wesentlich umfangreicher als die Manpages. Allerdings haben sie den Nachteil,dass sie meist auf der Kommandozeile abzurufen sind und für Neulinge schwer bedienbar sind.
 : Kann aber auch zB über den Konqueror angezeigt werden.
 '''4 HOWTOs'''
@@ Zeile 28: / Zeile 25: @@
 : oft unter /usr/share/doc  /usr/share/doc/packages /usr/src/linux/Documentation
 '''6 Informationen im Internet'''
 === Handbuchseiten ===

@@ Zeile 2: / Zeile 2: @@
-Angesicht der unzähligen Programme und Tools in Linux und deren Manigfaltigkeit der Optionen braucht man ein leistungsfähiges Hilfesystem
+Angesicht der unzähligen Programme und Tools in Linux und deren Mannigfaltigkeit der Optionen braucht man ein leistungsfähiges Hilfesystem
@@ Zeile 18: / Zeile 18: @@
 : nach dem Prinzip von Hypertext aufgebautes Infosystem für einige Befehle
 : ist für einige Befehle wesentliche umfangreicher als die Manpages
-: ist auf der Komandozeile für Neulinge meist schwer zu bedienen.
+: ist auf der Kommandozeile für Neulinge meist schwer zu bedienen.
 : Kann aber auch zB über den Konqueror angezeigt werden.
 '''4 HOWTOs'''
-: nicht Einzelkomandos sondern komplette Lösungen
+: nicht Einzelkommandos sondern komplette Lösungen
 : zum Teil mit auf dem Rechner installiert
 : [http://tldp.org/docs.html#howto HOWTOs in verschieden Formaten]
@@ Zeile 36: / Zeile 36: @@
 ==== Aufruf der Manpage zur Anzeige der Hilfedatei ====
-* der häufigste Aufruf auf der Komandozeile
+* der häufigste Aufruf auf der Kommandozeile
 <pre>
 man KommandoName
@@ Zeile 58: / Zeile 58: @@
   * echo $MANPATH                   #Ausgabe des SuchPath der Manpages
-mit der Option -L LANG-Umgebung können wir versuchen die Anzeigereihenfolge der verschiedene Spachen zu beeinflussen. Normalerweise sollten die SuSE Rechner so konfiguriert sein, das wenn Deutsche Einstellungen an den Umgebungsvariable gesetzt sind, sollte es deutsche Manpages zum Suchbegriff geben sollte, diese Vorrang vor der Englischen Manualpages haben sollten. Es ist aber so, dass es den überwiegende Teil der Manpages nur in Englisch gibt.
+mit der Option -L LANG-Umgebung können wir versuchen die Anzeigereihenfolge der verschiedene Sprachen zu beeinflussen. Normalerweise sollten die SuSE Rechner so konfiguriert sein, das wenn Deutsche Einstellungen an den Umgebungsvariable gesetzt sind, sollte es deutsche Manpages zum Suchbegriff geben sollte, diese Vorrang vor der Englischen Manpages haben sollten. Es ist aber so, dass es den überwiegende Teil der Manpages nur in Englisch gibt.
 <pre>
@@ Zeile 122: / Zeile 122: @@
 umount2 (2)          - mount and unmount filesystems
 </pre>
-Um also Infomationen über das Admin Kommando '''umount''' zu erhalten, müssen wir uns die '''umount (8)''' Datei ansehen
+Um also Informationen über das Admin Kommando '''umount''' zu erhalten, müssen wir uns die '''umount (8)''' Datei ansehen
@@ Zeile 132: / Zeile 132: @@
-: '''man passwd''' liefert uns eine passwd(1) Manpage mit der Beschreibung des änderen des Passwortes
+: '''man passwd''' liefert uns eine passwd(1) Manpage mit der Beschreibung zum ändern des Passwortes
 : '''man -a passwd''' es werden uns mehrere Manpages nacheinander ausgegeben erst die letzte passwd(5) ist die gesuchte
-: '''man 5 passwd''' wir erhalen sofort die Manpage mit der Beschreibung der Konfigurationsdatei gleichen Namens
+: '''man 5 passwd''' wir erhalten sofort die Manpage mit der Beschreibung der Konfigurationsdatei gleichen Namens
@@ Zeile 148: / Zeile 148: @@

← Nächstältere Version		Version vom 23. September 2006, 15:30 Uhr
Zeile 151:		Zeile 151:

	[[Benutzer:Robi\|Robi]] 20:14, 5. Sep 2006 (CEST)		[[Benutzer:Robi\|Robi]] 20:14, 5. Sep 2006 (CEST)
		+
		+
		+	[[Allgemeines \| Zurück zu Allgemeines]]

	[[Category:Allgemeines]]		[[Category:Allgemeines]]

← Nächstältere Version		Version vom 5. September 2006, 18:14 Uhr
Zeile 1:		Zeile 1:
−	<!--~~robi~~ in ~~Arbeit~~-->	+	== Hilfe unter LINUX ==
		+
		+
		+	Angesicht der unzähligen Programme und Tools in Linux und deren Manigfaltigkeit der Optionen braucht man ein leistungsfähiges Hilfesystem
		+
		+
		+	=== LINUX-Hilfesystem im Überblick ===
		+	'''1 Programmierte Hilfe:'''
		+	: die meisten Programme erzeugen bei falschem Aufruf eine kurzen Hilfetext
		+	: dieser kann auch meist mit mit der Option --help oder -h erzeugt werden
		+	'''2 Handbuchseiten oder ManPages'''
		+	: fast jedes Programm, ein Vielzahl von Konfigurationsdateien, System- und Bibliotheksaufrufe haben Handbuchseiten
		+	: sie werden meist mit dem Programm mitinstalliert
		+	: liegen in einem Speziellem Format nach Sektionen sortiert mit einer definierten Gliederung in verschiedenen Verzeichnissen
		+	: es gibt eine Indexdatei und einen Suchpath sowie eine Listorder
		+	: die Manpages können zur Anzeige in verschiedene Formate transformiert werden
		+	'''3 Info-Seiten'''
		+	: nach dem Prinzip von Hypertext aufgebautes Infosystem für einige Befehle
		+	: ist für einige Befehle wesentliche umfangreicher als die Manpages
		+	: ist auf der Komandozeile für Neulinge meist schwer zu bedienen.
		+	: Kann aber auch zB über den Konqueror angezeigt werden.
		+	'''4 HOWTOs'''
		+	: nicht Einzelkomandos sondern komplette Lösungen
		+	: zum Teil mit auf dem Rechner installiert
		+	: [http://tldp.org/docs.html#howto HOWTOs in verschieden Formaten]
		+	'''5 lokale Dokumentationen'''
		+	: typischerweise Paketdokumentation und Beispieldateien
		+	: oft unter /usr/share/doc /usr/share/doc/packages /usr/src/linux/Documentation
		+	'''6 Informationen im Internet'''
		+
		+
		+
		+
		+	=== Handbuchseiten ===
		+
		+	==== Aufruf der Manpage zur Anzeige der Hilfedatei ====
		+
		+	* der häufigste Aufruf auf der Komandozeile
		+	<pre>
		+	man KommandoName
		+	</pre>
		+	* Im Konqueror '''man:Kommandoname''' im URL-Eingabefeld
		+	* weiter Möglichkeiten xman emacs und viele andere
		+
		+
		+
		+
		+	==== Häufig benötigte Aufrufe rund um Manpages====
		+
		+
		+	* man -a KommandoName #alle Handbuchseiten aller Sektionen
		+	* man ? KommandoName #nur Seiten der Sektion '''?'''
		+	* man -l ./KommandoName.1.gz #Anzeigen des Inhaltes einer Manpagedatei
		+	* man -t KommandoName \| DRUCKER #Seite wird in Postscript umgewandelt und zum DRUCKER gesendet
		+	* apropos Kommando #Liste aller Manpages mit "Kommando" im Beschreibung oder Name
		+	* whatis Kommando #sucht wie apropos doch nur im Namen ; gibt Beschreibung als Text aus
		+	* mandb #aktualisieren der Datenbank
		+	* echo $MANPATH #Ausgabe des SuchPath der Manpages
		+
		+	mit der Option -L LANG-Umgebung können wir versuchen die Anzeigereihenfolge der verschiedene Spachen zu beeinflussen. Normalerweise sollten die SuSE Rechner so konfiguriert sein, das wenn Deutsche Einstellungen an den Umgebungsvariable gesetzt sind, sollte es deutsche Manpages zum Suchbegriff geben sollte, diese Vorrang vor der Englischen Manualpages haben sollten. Es ist aber so, dass es den überwiegende Teil der Manpages nur in Englisch gibt.
		+
		+	<pre>
		+	man -Lde man # sollte die deutschen manpage von man(1) anzeigen
		+	man -Len man # sollte die englische Manpage von man(1) anzeigen
		+	</pre>
		+
		+
		+
		+
		+	==== Manpages in anderes Format übertragen ====
		+
		+	# man ls \| rman > ./man_ls.txt # erzeugt Textdatei von Manpage ls(1)
		+	# man -T ls \| ps2pdf - > ./man-ls.pdf # erzeugt eine PDF-Datei von ls(1)
		+	# man -T ls > ./man-ls.ps # erzeugt eine PostSkript-Datei von ls(1)
		+	# man ls \| rman -f html > ./man-ls.html # erzeugt eine html-Datei von ls(1)
		+
		+
		+
		+
		+	==== Der innere Gliederung der Manpage ====
		+	Manpages besteht aus mehreren Teilen. Die üblichen Bezeichnungen der Abschnitte sind
		+
		+	NAME, SYNTAX, BESCHREIBUNG, OPTIONEN, DATEIEN, SIEHE AUCH, FEHLER, und AUTOR.
		+	bzw.
		+	NAME, SYNOPSIS, DESCRIPTION, OPTIONS, FILES, SEE ALSO, BUGS, and AUTHOR.
		+
		+
		+
		+
		+
		+
		+	==== Die Sektionen oder Abschnitte ====
		+
		+	Die einzelnen Handbuchseiten werden in Sektionen gegliedert auf dem Rechner abgelegt.
		+	Anhand der Sektion der Manpage kann man erkennen, um welchen inhaltlichen Zusammenhang es sich bei dieser Manpage handelt.
		+
		+
		+	Die wichtigsten Sektionen (Abschnitte) in folgender Tabelle
		+	<pre>
		+	1 Ausführbare Programme oder Shellbefehle
		+	2 Systemaufrufe (Kernelfunktionen)
		+	3 Bibliotheksaufrufe (Funktionen in System-Bibliotheken)
		+	4 Spezielle Dateien (gewöhnlich in /dev)
		+	5 Dateiformate und Konventionen, z. B. /etc/passwd
		+	6 Spiele
		+	7 Makropakete und Konventionen, z. B. man(7), groff(7)
		+	8 Systemadministrationsbefehle (in der Regel nur für root)
		+	9 Kernelroutinen [Nicht Standard]
		+	n neu [veraltet]
		+	l lokal [veraltet]
		+	p öffentlich [veraltet]
		+	o alt [veraltet]
		+	</pre>
		+	Anhand der Sektion kann man also feststellen ob es sich um eine Beschreibung eines Kommandos oder zB um die Beschreibung einer Kernelfunktion, oder um die Beschreibung eines Admin Befehls handelt.
		+
		+	Anhand der Ausgabe von zB '''apropos ''' kann man sofort sehen um was es sich bei dieser Manpage handelt
		+	<pre>
		+	# apropos umount
		+	umount (2) - mount and unmount filesystems
		+	smbumount (8) - smbfs umount for normal users
		+	umount (8) - unmount file systems
		+	umount2 (2) - mount and unmount filesystems
		+	</pre>
		+	Um also Infomationen über das Admin Kommando '''umount''' zu erhalten, müssen wir uns die '''umount (8)''' Datei ansehen
		+
		+
		+
		+
		+	==== Beispiel für Benutzung====
		+
		+	* Wir möchten gerne wissen was die einzelnen Felder in der /etc/passwd für Bedeutung haben.
		+
		+
		+	: '''man passwd''' liefert uns eine passwd(1) Manpage mit der Beschreibung des änderen des Passwortes
		+	: '''man -a passwd''' es werden uns mehrere Manpages nacheinander ausgegeben erst die letzte passwd(5) ist die gesuchte
		+	: '''man 5 passwd''' wir erhalen sofort die Manpage mit der Beschreibung der Konfigurationsdatei gleichen Namens
		+
		+
		+
		+
		+	==== Handbuchseiten im WWW ====
		+
		+	* [http://tldp.org/docs.html#man tldp.org]
		+	* [http://www.die.net/doc/linux/man/ die.net]
		+	* [http://www.penguin-soft.com/penguin/man penguin-soft]
		+
		+	* eine [http://www.linux-praxis.de/lpic1/manpages/index2.html überschauliche Auswahl häufig benötigter Befehle] in gekürzter Deutscher Übersetzung
		+
		+
		+
		+
		+	[[Benutzer:Robi\|Robi]] 20:14, 5. Sep 2006 (CEST)
		+
		+	[[Category:Allgemeines]]