Password function

man/de/man8/pam_panic.8

@@ -1,12 +1,12 @@
 '\" t
 .\"     Title: pam_panic
 .\"    Author: [see the "AUTHORS" section]
-.\"      Date: 2018-03-26
+.\"      Date: 2018-03-31
 .\"    Manual: PAM Panic Manual
 .\"    Source: PAM Panic Manual
 .\"  Language: German
 .\"
-.TH "PAM_PANIC" "8" "2018-03-26" "PAM Panic Manual" "PAM Panic Manual"
+.TH "PAM_PANIC" "8" "2018-03-31" "PAM Panic Handbuch" "PAM Panic Handbuch"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\" -----------------------------------------------------------------
@@ -21,28 +21,62 @@
 .\" -----------------------------------------------------------------
 
 .SH "NAME"
-pam_panic \- PAM module zur Authentifizierung durch Wechseldatentr\(:agern mit Panik-Funktion
+pam_panic \- PAM-Modul mit Panik-Funktion zum Sch\(:utzen von wichtigen Daten in Notsituationen
 
 
 .SH "\(:UBERSICHT"
 .HP \w'\fBpam_panic\&.so\fR\ 'u
-\fBpam_panic\&.so\fR [allow=\fIUUID(GPT)\fR] [reject=\fIUUID(GPT)\fR] [reboot] [poweroff] [serious=\fIUUID\fR]
+\fBpam_panic\&.so\fR [password] [allow=\fIUUID(GPT)\fR] [reject=\fIUUID(GPT)\fR] [reboot] [poweroff] [serious=\fIUUID\fR]
 
 
 .SH "BESCHREIBUNG"
 .PP
-Das pam_panic PAM module wurde mit dem Hintergedanken entwickelt, Personen mit wichtigen Daten zu sch\(:utzen.\&. Es bietet eine Panik-Function\&.
+Das pam_panic PAM Modul wurde mit dem Hintergedanken entwickelt, Personen mit wichtigen Daten zu sch\(:utzen\&. Es bietet eine Panik-Funktion\&.
 .PP
+Es gibt zwei M\(:oglichkeiten der Verwendung:
+.PD 0
+.PP
+Erste M\(:oglichkeit:
+.RS 2
 Man verwendet zwei Wecheldatentr\(:ager, die als Schl\(:ussel dienen\&.
 Hierbei funktioniert eines als Authentifizierungsschl\(:ussel und eines als Panikschl\(:ussel\&.
-Der Panikschl\(:ussel ruft die Panik-Funktion auf, die, sofern die Option \fBserious\fR aktiviert wurde, "\fBcryptsetup luksErase [UUID]\fR" ausf\(:uhrt\&.
-Dieses wird dann den luksHeader zerst\(:oren\&. 
-Das hei\(sst, dass die Daten auf den in den Optionen angegebenen Datentr\(:ager f\(:ur niemanden mehr lesbar sein werden\&.
+Der Panikschl\(:ussel f\(:uhrt die \fIPanikfunktion\fR aus\&. 
+.PD 0
+.PP
+Siehe dazu die Optionen \fBallow\fR und \fBreject\fR\&.
+.RE
+.PP
+Zweite M\(:oglichkeit:
+.RS 2
+Man verwendet zwei Passw\(:orter, die als Schl\(:ussel dienen\&.
+Dabei wird ein Schl\(:usselpasswort (Key password) und ein Panikpasswort (Panic password) festgelegt\&.
+Das Panikpasswort wird hierbei die \fIPanikfunktion\fR aufrufen\&.
+.PD 0
+.PP
+Siehe dazu die Option \fBpassword\fR\&.
+.RE
+
+.PD 1
+.PP
+Die Panikfunktion:
+.RS 2
+Das Verhalten der Panikfunktion wird durch die Argumente \fBreboot\fR, \fBpoweroff\fR und/oder \fBserious\fR definiert\&.
+.RE
 
 
 .SH "OPTIONEN"
 .PP
-\fBallow=\fR\fB\fIUUID(GPT)\fR\fR (erforderlich)
+\fBpassword\fR
+.RS 4
+Diese Option aktiviert die Passwortfunktion mit einem Panikpasswort und einem Schl\(:usselpasswort. Wenn \fBallow\fR und \fBreject\fR gesetzt sind, wird diese Option ignoriert.
+.PD 0
+.PP
+.PD 1
+Um die Passw\(:orter zu setzen steht das Programm \fBpam_panic_pw\fR(1) zur Verf\(:ugung.
+.RE
+
+.PP
+\fBallow=\fR\fB\fIUUID(GPT)\fR\fR
 .RS 4
 Diese Ger\(:ate-UUID wird zur Authentifizierung benutzt (Authentifierungsschl\(:ussel)\&.
 .PD 0
@@ -55,7 +89,7 @@ Weitere Informationen im Abschnitt \fBWIE BESTIMME ICH MEINE UUIDS\fR\&.
 .RE
 .PP
 
-\fBreject=\fR\fB\fIUUID(GPT)\fR\fR (erforderlich)
+\fBreject=\fR\fB\fIUUID(GPT)\fR\fR
 .RS 4
 Diese Ger\(:ate-UUID wird \fBreboot\fR, \fBpoweroff\fR und/oder die Panik-Funktion \fBserious\fR, sofern als Argument angegeben, aufrufen\& (Panikschl\(:ussel).
 .PD 0
@@ -86,7 +120,12 @@ Aus Sicherheitsgr\(:unden wird von dieser Option abgeraten\&.
 
 \fBserious=\fR\fB\fIUUID\fR\fR
 .RS 4
-Die Ger\(:ate-UUID, bei dem der luksHeaders zerst\(:ort werden w\(:urde, sobald der Wecheldatentr\(:ager mit der UUID des Arguments \fBreject=UUID(GPT)\fR eingelegt wurde\&.
+Die Ger\(:ate-UUID, dessen luksHeaders zerst\(:ort werden w\(:urde, sobald der Wecheldatentr\(:ager mit der UUID des Arguments \fBreject=UUID(GPT)\fR eingelegt wurde\&.
+Das hei\(sst, dass die Daten auf den in den Optionen angegebenen Datentr\(:ager f\(:ur niemanden mehr lesbar sein werden\&.
+.PD 0
+.PP
+Intern wird das Programm "\fBcryptsetup luksErase [UUID]\fR" ausgef\(:uhrt\&.
+.PD 1
 .PP
 (Eine Erinnerung daran, ein luksHeader-Backup zu machen bevor diese Funktion benutzt wird.\&.)
 .RE
@@ -104,6 +143,12 @@ auth       requisite    pam_panic.so auth=<UUID> reject=<UUID> reboot serious=<U
 .PP
 account    requisite    pam_panic.so
 .RE
+Oder auch:
+.RS 4
+auth       requisite    pam_panic.so password reboot serious=<UUID>
+.PP
+account    requisite    pam_panic.so
+.RE
 .PD 1
 
 
@@ -117,7 +162,7 @@ Um nachvollziehen zu k\(:onnen, welcher Wecheldatentr\(:ager welches ist, ist es
 .PP
 PAM_SUCCESS
 .RS 4
-Zugriff wurde gew\(:ahrt.\&.
+Zugriff wurde gew\(:ahrt\&.
 .RE
 .PP
 PAM_IGNORE
@@ -138,9 +183,9 @@ Der Wecheldatentr\(:ager wurde nicht erkannt\&.
 Shared object-Datei, die f\(:ur alles zust\(:andig ist\&.
 .RE
 .PP
-/usr/share/man/*/man8/pam_panic\&.8\&.gz
+/usr/local/bin/pam_panic_pw
 .RS 4
-Die Manpages\&.
+Programm zum Setzen und Ver\(:andern der Passw\(:orter\&.
 .RE
 
 
@@ -151,6 +196,7 @@ Fehlerberichte (m\(:oglichst auf Englisch) und Codeverbesserungen k\(:onnen hier
 
 .SH "SIEHE AUCH"
 .PP
+\fBpam_panic_pw\fR(1),
 \fBcryptsetup\fR(8),
 \fBpam\&.conf\fR(5),
 \fBpam\fR(8)\&.