User Commands GKSU(1)
NAME
gksu - a Gtk+ su frontend
SYNOPSIS
gksu [ options ]
gksudo [ options ]
DESCRIPTION
This manual page documents briefly gksu and gksudo
gksu is a frontend to su and gksudo is a frontend to sudo.
Their primary purpose is to run graphical commands that need root without the need to run an X terminal emulator and using su directly. OPTIONS These programs follow the usual GNU command line syntax,with long options starting with two dashes (`-'). A summary
of options is included below. Common Options:--user
Calls, -u as the specified user --message
Replaces the standard message shown to ask for password for the argument passed to the option, -m --sudo-mode, -S
Use sudo instead of su as backend authentication sys-
tem. Notice that the X authorization magic will not work when using sudo for target users other than root.--title
, -t Replaces the default title with the argument --icon
Replaces the default window icon with the argument, -i --print-pass, -p
Asks gksu to print the password to stdout, just like
ssh-askpass. Useful to use in scripts with programs
that accept receiving the password on stdin.--disable-grab, -g
SunOS 5.10 Last change: 2003 1 User Commands GKSU(1) Disables the "locking" of the keyboard, mouse, and focus done by the program when asking for password--ssh-fwd, -s
Strip the host part of the $DISPLAY variable, so that
GKSu will work on SSH X11 Forwarding.--login, -l
Makes this a login shell. Beware this may cause prob-
lems with the Xauthority magic. Run xhost to allow the target user to open windows on your display! This isignored if running with sudo as backend for authentica-
tion.--preserve-env, -k
Preserve the current environments, does not set $HOME
nor $PATH, for example.
FILES/etc/gksu.conf
Configuration file to setup system-wide defaults for
gksu/gksudo. It provides an option to force the
display grabing, also. RETURN VALUEOn success, gksu will return 0. If an authentication error
ocurred, it will exit with error code 3. If the user can-
celed the dialog or closed the window, it will return errorcode 2. On other error conditions, gksu will return 1.
NOTE Note thatand all its arguments should be passed as one single argument to gksu just like one would to when
using su.SEE ALSO
su(1), gksuexec(1).
AUTHOR This manual page was written by Gustavo Noronha Silva
for the Debian GNU/Linux system (but may be used by others). SunOS 5.10 Last change: 2003 2