summaryrefslogtreecommitdiffstats
path: root/doc/man/kcheckpass
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/kcheckpass')
-rw-r--r--doc/man/kcheckpass/CMakeLists.txt7
-rw-r--r--doc/man/kcheckpass/kcheckpass.149
2 files changed, 56 insertions, 0 deletions
diff --git a/doc/man/kcheckpass/CMakeLists.txt b/doc/man/kcheckpass/CMakeLists.txt
new file mode 100644
index 000000000..65c83b94f
--- /dev/null
+++ b/doc/man/kcheckpass/CMakeLists.txt
@@ -0,0 +1,7 @@
+file( GLOB _man_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.1 )
+
+install(
+ FILES ${_man_files}
+ DESTINATION ${MAN_INSTALL_DIR}/man1
+ COMPONENT doc
+)
diff --git a/doc/man/kcheckpass/kcheckpass.1 b/doc/man/kcheckpass/kcheckpass.1
new file mode 100644
index 000000000..fa5a4c817
--- /dev/null
+++ b/doc/man/kcheckpass/kcheckpass.1
@@ -0,0 +1,49 @@
+.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
+.TH KCHECKPASS 1 "June 2006" "Trinity Desktop Environment" "authentication software"
+.SH NAME
+kcheckpass
+\- The KCheckPass authentication software
+.SH SYNOPSIS
+\fBkcheckpass\fP
+.SH DESCRIPTION
+\fBKCheckPass\fP is TDE's authentication program. It is meant to be
+used by any software in need of user authentication, most
+notably screensavers.
+.sp 1
+It enhances security be the following means:
+.br
+.IP " \-"
+It's only a small program, which is hopefully simple enough to
+allow it to be SUID root. Setting it to SUID root is necessary
+on Shadow Password systems.
+.IP " \-"
+No other program in need of user authentication, must be
+SUID root.
+.IP " \-"
+It provides a single implementation to check passwords. So one only must take a closer look at \fBKCheckPass\fP to ensure password security. It's much easier for programs using \fBKCheckPass\fP to preserve security.
+.PP
+.br
+\fBTechnique:\fP
+.sp 1
+\fBKCheckPass\fP is a simple password checker. Just invoke and send it the password on stdin.
+.sp 1
+If the password was accepted, the program exits with 0;
+.br
+if it was rejected, it exits with 1. Any other exit code signals an error.
+
+.SH AUTHORS
+.nf
+Olaf Kirch <[email protected]>
+.br
+Christian Esken <[email protected]>
+.br
+Oswald Buddenhagen <[email protected]>
+.br
+
+.br
+.fi
+Please use http://bugs.trinitydesktop.org to report bugs; do not mail the authors directly.
+.PP
+This manual page was written by Holger Hartmann <[email protected]> for the Debian Project, but may be used by others. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.
+.PP
+On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL.