rev 5140 - in trunk/packages/kdebase/debian: . man

[Sune Vuorela]

Author: pusling-guest
Date: 2006-12-13 13:12:00 +0100 (Wed, 13 Dec 2006)
New Revision: 5140

Modified:
   trunk/packages/kdebase/debian/changelog
   trunk/packages/kdebase/debian/man/kdesu.1
Log:
add a bit to kdesu manpage


Modified: trunk/packages/kdebase/debian/changelog
===================================================================
--- trunk/packages/kdebase/debian/changelog	2006-12-13 10:52:30 UTC (rev 5139)
+++ trunk/packages/kdebase/debian/changelog	2006-12-13 12:12:00 UTC (rev 5140)
@@ -1,3 +1,11 @@
+kdebase (4:3.5.5a.dfsg.1-4) unstable; urgency=low
+
+  +++ Changes by Sune Vuorela:
+  * Add a section to man page about how to use sudo as kdesu backend 
+    (Closes: #399823, #384416)
+
+ -- Debian Qt/KDE Maintainers <debian-qt-kde at lists.debian.org>  Wed, 13 Dec 2006 13:09:33 +0100
+
 kdebase (4:3.5.5a.dfsg.1-3) unstable; urgency=high
 
   * Urgency high for etch's KDE artwork.

Modified: trunk/packages/kdebase/debian/man/kdesu.1
===================================================================
--- trunk/packages/kdebase/debian/man/kdesu.1	2006-12-13 10:52:30 UTC (rev 5139)
+++ trunk/packages/kdebase/debian/man/kdesu.1	2006-12-13 12:12:00 UTC (rev 5140)
@@ -9,6 +9,8 @@
 KDE su is a graphical front end to the Unix \fBsu\fR utility. It allows you to run programs as another user by entering their password. It is not a SUID root program, but runs unprivileged. The system program \fBsu\fR is used for acquiring special privileges.
 .PP
 \fBkdesu\fR has the ability to store passwords for the convenience of users. The passwords are NOT written to disk, but stored in memory using a special program, \fBkdesud\fR. This is only done if the user specifies that the password be remembered. In this case, passwords are stored in memory for a certain period of time before being removed. \fBkdesud\fR runs in such a way that only the user who entered the password originally can use it, though no one, not even the user who originally entered the password, can retrieve the password that is stored by \fBkdesud\fR. Through these measures, users can avoid having to repeatedly enter root passwords or other passwords, without a significant risk to overall system security.
+.PP
+\fBkdesu\fR uses normally \fBsu\fR to gain root by using the root password. \fBkdesu\fR can also be configured to use other commands to gain root like sudo to use users password.
 .SH OPTIONS
 .SS Generic options:
 .TP
@@ -74,6 +76,16 @@
 .B command
 Specifies the command to run
 
+.SH CONFIGURATION FILES
+.PP
+\fBkdesu\fR can be configured with a default configuration file /etc/kde3/kdesurc and with a per user configuration file in .kde/share/config. Alternative a section could be added to kdeglobals.
+.SH EXAMPLE
+The configuration item for the configuration files is the following:
+.br
+[super-user-command] 
+.br
+super-user-command=sudo
+
 .SH SEE ALSO
 Full user documentation is available through the KDE Help Center. You can also enter the URL
 .BR help:/kdesu/