Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gksu(1) [opensolaris man page]

GKSU(1) 						      General Commands Manual							   GKSU(1)

NAME
gksu - a Gtk+ su frontend SYNOPSIS
gksu [ options ] <command> gksudo [ options ] <command> 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 <user>, -u <user> Calls <command> as the specified user --message <message>, -m <message> Replaces the standard message shown to ask for password for the argument passed to the option --sudo-mode, -S Use sudo instead of su as backend authentication system. Notice that the X authorization magic will not work when using sudo for target users other than root. --title <title>, -t <title> Replaces the default title with the argument --icon <icon>, -i <icon> Replaces the default window icon with the argument --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 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 problems with the Xauthority magic. Run xhost to allow the target user to open win- dows on your display! This is ignored if running with sudo as backend for authentication. --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 VALUE
On success, gksu will return 0. If an authentication error ocurred, it will exit with error code 3. If the user canceled the dialog or closed the window, it will return error code 2. On other error conditions, gksu will return 1. NOTE
Note that <command> and 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 <kov@debian.org> for the Debian GNU/Linux system (but may be used by others). 2003 GKSU(1)

Check Out this Related Man Page

GKSU(1) 							   User Commands							   GKSU(1)

NAME
gksu - GTK+ frontend for su and sudo SYNOPSIS
gksu gksu [-u <user>] [options] <command> gksudo [-u <user>] [options] <command> 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. Notice that all the magic is done by the underlying library, libgksu. Also notice that the library will decide if it should use su or sudo as backend using the /apps/gksu/sudo-mode gconf key, if you call the gksu command. You can force the backend by using the gksudo command, or by using the --sudo-mode and --su-mode options. If no command is given, the gksu program will display a small window that allows you to type in a command to be run, and to select what user the program should be run as. The other options are disregarded, right now, in this mode. OPTIONS
--debug, -d Print information on the screen that might be useful for diagnosing and/or solving problems. --user <user>, -u <user> Call <command> as the specified user. --disable-grab, -g Disable the "locking" of the keyboard, mouse, and focus done by the program when asking for password. --prompt, -P Ask the user if they want to have their keyboard and mouse grabbed before doing so. --preserve-env, -k Preserve the current environments, does not set $HOME nor $PATH, for example. --login, -l Make this a login shell. Beware this may cause problems with the Xauthority magic. Run xhost to allow the target user to open win- dows on your display! --description <description|file>, -D <description|file> Provide a descriptive name for the command to be used in the default message, making it nicer. You can also provide the absolute path for a .desktop file. The Name key for will be used in this case. --message <message>, -m <message> Replace the standard message shown to ask for password for the argument passed to the option. Only use this if --description does not suffice. --print-pass, -p Ask 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. --su-mode, -w Force gksu to use su(1) as its backend for running the programs. --sudo-mode, -S Force gksu to use sudo(1) as its backend for running the programs. SEE ALSO
su(1), sudo(1) gksu version 2.0.x August 2006 GKSU(1)
Man Page