.TH GNOME XSU 8 "November 6th, 2001" "Gnome Xsu" "GNOME User's Manual" 

.SH NAME
Gnome Xsu \- 'su - username -c command' for GNOME

.SH SYNOPSIS
\fBxsu\fR
[ \fIOPTION\fR... ] 

.SH "DESCRIPTION"
.PP
\fBGnome Xsu\fR, is an interface for the command `su \- username \-c command`
in Gnome. When the user executes \fBxsu\fR, he will be prompted for a
command, a username and a password.
If the username and password
are correct xsu will execute the command as the entered user. So
if the username was root, then the command will be executed as
root.


.SH "SECURITY"
.PP
\fBGnome Xsu\fR uses the standard su binary to gain it's root access. This
way, all security issues should be solved.

The security of all older xsu versions was very bad. With xsu version 0.1.0
I introduced the use of a pipe to a secured non-Gnome SUID application. This
has been replaced with a special type of pipe to the standard su application.
For example the one from GNU sh-utils can be used with Gnome Xsu.

.SH "ISSUES"
.PP
\fBGnome Xsu\fR uses the Unix 'su' execute the command. This means that your
DISPLAY environment variable of the user must be set correctly. You can
put for example \fBexport DISPLAY=:0\fR in the file \fB/etc/profile\fR (bash).
You can also use the option --set-display which will set the DISPLAY
environment variable to ":0" before starting the command.


.SH "OPTIONS"
.PP 
This program follows the usual GNU command line syntax, with long
options starting with two dashes (`\-\-'). A summary of the options
supported by \fBxsu\fR is included below.


.PP
.\" Begin List
.TP
\fB\-c, \-\-command \fR\fICOMMAND\fR
Set the command to be executed

.TP
\fB\-u, \-\-username \fR\fIUSERNAME\fR
Set the username to execute the command as

.TP
\fB\-i, \-\-icon \fR\fIFILENAME\fR
Load another icon

.TP
\fB\-t, \-\-title \fR\fIWINDOWTITLE\fR
Set another window title

.TP
\fB\-a, \-\-set\-display \fR\fHOSTNAME:PORT\fR
Sets the DISPLAY environment variable to :0 before
starting the command if no second argument is given 
else use HOSTNAME:PORT as XServer host.

.TP
\fB\-m, \-\-message \fR\fIMESSAGE\fR

Set the message to be displayed; you can use the
character ^ in your message if you want to use a new
line, and the character ~ if you want to use a
tabulation.
If no message is set, then the default
message will be used

.TP
\fB\-d, \-\-unadaptable
Disables the username and command textboxes
if possible

.TP
\fB\-e, \-\-hide
Hides the username and command textboxes
if possible

.TP
\fB\-\-
Stops commandlineparsing and replaces the -c argument.
All other arguments that are behind the -- argument are
collected and will be used as the new -c argument.

.\" End List



.SH "EXAMPLES"
.PP
\fBxsu \-c\fR "\fIgmenu\fR"
\fB\-u\fR "\fIroot\fR"
\fB\-m\fR "\fITo start the Menu Editor^you have
to enter^the root password^here.\fR" 


.SH "BUGS"
.PP
Please report bugs to the Author.
.TP
\fBVersion 0.1.3\fR
The -d option does not work (fixed in 0.1.4).

.TP
\fBVersion 0.0.1 -> 0.0.4\fR 
Major security issues. These versions are "not" secure !

.SH "SEE ALSO"
.PP
\fBsu(1), sudo(1)\fR

.PP
XSU Homepage (Link to \fIhttp://xsu.freax.eu.org/\fR)


.SH "AUTHOR"
.PP
Philip Van Hoof <freax@pandora.be>

.PP
This man\-page was written by Jan Schaumann
<jschauma@netmeister.org> as part of "The Missing
Man Pages Project (Link to \fIhttp://www.netmeister.org/misc/m2p2/index.html\fR)".