OLD | NEW |
(Empty) | |
| 1 .\" ** You probably do not want to edit this file directly ** |
| 2 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). |
| 3 .\" Instead of manually editing it, you probably should edit the DocBook XML |
| 4 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. |
| 5 .TH "XDG\-SU" "1" "07/31/2006" "This is release 0.5 of the xdg\-su Manual" "" |
| 6 .\" disable hyphenation |
| 7 .nh |
| 8 .\" disable justification (adjust text to left margin only) |
| 9 .ad l |
| 10 .SH "NAME" |
| 11 xdg\-su \- run a GUI program as root after prompting for the root password |
| 12 .SH "SYNOPSIS" |
| 13 .HP 7 |
| 14 \fBxdg\-su\fR [\fB\-u\ \fR\fB\fIuser\fR\fR] \fB\-c\ \fR\fB\fIcommand\fR\fR |
| 15 .HP 7 |
| 16 \fBxdg\-su\fR {\fB\-\-help\fR \fB\-\-manual\fR \fB\-\-version\fR} |
| 17 .SH "DESCRIPTION" |
| 18 .PP |
| 19 xdg\-su provides a graphical dialog that prompts the user for a password to run |
| 20 \fIcommand\fR |
| 21 as |
| 22 \fIuser\fR |
| 23 or as root if no user was specified. |
| 24 .PP |
| 25 xdg\-su is for use inside a desktop session only. |
| 26 .PP |
| 27 xdg\-su discards any stdout and stderr output from |
| 28 \fIcommand\fR. |
| 29 .SH "OPTIONS" |
| 30 .TP |
| 31 \fB\-u \fR\fB\fIuser\fR\fR |
| 32 run |
| 33 \fIcommand\fR |
| 34 as |
| 35 \fIuser\fR. The default is to run as root. |
| 36 .TP |
| 37 \fB\-\-help\fR |
| 38 Show command synopsis. |
| 39 .TP |
| 40 \fB\-\-manual\fR |
| 41 Show this manualpage. |
| 42 .TP |
| 43 \fB\-\-version\fR |
| 44 Show the xdg\-utils version information. |
| 45 .SH "EXIT CODES" |
| 46 .PP |
| 47 An exit code of 0 indicates success while a non\-zero exit code indicates failur
e. The following failure codes can be returned: |
| 48 .TP |
| 49 \fB1\fR |
| 50 Error in command line syntax. |
| 51 .TP |
| 52 \fB2\fR |
| 53 One of the files passed on the command line did not exist. |
| 54 .TP |
| 55 \fB3\fR |
| 56 A required tool could not be found. |
| 57 .TP |
| 58 \fB4\fR |
| 59 The action failed. |
| 60 .SH "SEE ALSO" |
| 61 .PP |
| 62 \fBsu\fR(1) |
| 63 .SH "EXAMPLES" |
| 64 .PP |
| 65 .nf |
| 66 xdg\-su \-u root \-c "/opt/shinythings/bin/install\-GUI \-\-install fast" |
| 67 .fi |
| 68 .sp |
| 69 Runs the /opt/shinythings/bin/install\-GUI command with root permissions. |
| 70 .SH "AUTHOR" |
| 71 Kevin Krammer, Jeremy White. |
| 72 .br |
| 73 <kevin.krammer@gmx.at> |
| 74 .br |
| 75 <jwhite@codeweavers.com> |
OLD | NEW |