1KDESU(1) KDE User's Manual KDESU(1)
2
6 kdesu - Runs a program with elevated privileges
7
9 kdesu [-c command] [-d] [-f file] [-i icon name] [-n] [-p priority]
10 [-r] [-s] [-t] [-u user] [--noignorebutton] [--attach winid]
11 kdesu [KDE Generic Options] [Qt(TM) Generic Options]
13
15 KDE su is a graphical front end for the UNIX® su command for the K
16 Desktop Environment. It allows you to run a program as different user
17 by supplying the password for that user. KDE su is an unprivileged
18 program; it uses the system's su.
19 KDE su has one additional feature: it can optionally remember passwords
21 for you. If you are using this feature, you only need to enter the
22 password once for each command.
23 This program is meant to be started from the command line or from
25 .desktop files.
26 Since kdesu is no longer installed in
28 $(kf5-config --prefix)/bin but in kf5-config --path libexec and
29 therefore not in your Path, you have to use $(kf5-config --path
30 libexec)kdesu to launch kdesu.
31
33 -c command
34 This specifies the command to run as root. It has to be passed in
35 one argument. So if, for example, you want to start a new file
36 manager, you would enter at the prompt: $(kf5-config --path
37 libexec)kdesu -c Dolphin
38 -d
40 Show debug information.
41 -f file
43 This option allow efficient use of KDE su in .desktop files. It
44 tells KDE su to examine the file specified by file. If this file is
45 writable by the current user, KDE su will execute the command as
46 the current user. If it is not writable, the command is executed as
47 user user (defaults to root).
48 file is evaluated like this: if file starts with a /, it is taken
50 as an absolute filename. Otherwise, it is taken as the name of a
51 global KDE configuration file.
52 -i icon name
54 Specify icon to use in the password dialog. You may specify just
55 the name, without any extension.
56 -n
58 Do not keep the password. This disables the keep password checkbox
59 in the password dialog.
60 -p priority
62 Set priority value. The priority is an arbitrary number between 0
63 and 100, where 100 means highest priority, and 0 means lowest. The
64 default is 50.
65 -r
67 Use realtime scheduling.
68 -s
70 Stop the kdesu daemon. This is the daemon that caches successful
71 passwords in the background. This feature may also be disabled with
72 -n when KDE su is initially run.
73 -t
75 Enable terminal output. This disables password keeping. This is
76 largely for debugging purposes; if you want to run a console mode
77 app, use the standard su instead.
78 -u user
80 While the most common use for KDE su is to run a command as the
81 superuser, you can supply any user name and the appropriate
82 password.
83 --noignorebutton
85 Do not display an ignore button.
86 --attach winid
88 Makes the dialog transient for an X app specified by winid.
89
91 su(1)
92 More detailed user documentation is available from help:/kdesu (either
94 enter this URL into Konqueror, or run khelpcenter help:/kdesu).
95
97 Run kfmclient as user jim, and show the Konqueror icon in the password
98 dialog:
99 $(kf5-config --path libexec)kdesu -u jim -i konqueror kfmclient
101
103 KDE su was written by Geert Jansen <g.t.jansen@stud.tue.nl> and Pietro
104 Iglio <iglio@fub.it>.
105
107 Lauri Watts <lauri@kde.org>
108 Author.
109K Desktop Environment 2010-09-18 KDESU(1)