You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
180 lines
6.5 KiB
180 lines
6.5 KiB
<?xml version="1.0" ?>
|
|
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
|
|
<!ENTITY % English "INCLUDE">
|
|
]>
|
|
|
|
<refentry lang="&language;">
|
|
<refentryinfo>
|
|
<title>KDE User's Manual</title>
|
|
<author>&Lauri.Watts; &Lauri.Watts.mail;</author>
|
|
<date>Jun 7, 2005</date>
|
|
<productname>Trinity Desktop Environment</productname>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle><command>tdesu</command></refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname><command>tdesu</command></refname>
|
|
<refpurpose>Runs a program with elevated privileges</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>tdesu</command>
|
|
|
|
<group choice="opt"><option>-c</option></group>
|
|
<group choice="opt"><option>-d</option></group>
|
|
<group choice="opt"><option>-f</option> <replaceable> file</replaceable></group>
|
|
<group choice="opt"><option>-i</option> <replaceable> icon name</replaceable></group>
|
|
<group choice="opt"><option>-n</option></group>
|
|
<group choice="opt"><option>-p</option> <replaceable> priority</replaceable></group>
|
|
<group choice="opt"><option>-r</option></group>
|
|
<group choice="opt"><option>-s</option></group>
|
|
<group choice="opt"><option>-t</option></group>
|
|
<group choice="opt"><option>-u</option> <replaceable>
|
|
user</replaceable></group>
|
|
<group choice="opt"><option>--nonewdcop</option></group>
|
|
|
|
<group><arg choice="req"><replaceable>command</replaceable> <arg><replaceable>arg1</replaceable></arg>
|
|
<arg><replaceable>arg2</replaceable></arg>
|
|
<arg rep="repeat"><replaceable></replaceable></arg></arg></group>
|
|
</cmdsynopsis>
|
|
<cmdsynopsis>
|
|
<command>tdesu</command>
|
|
<arg choice="opt">KDE Generic Options</arg>
|
|
<arg choice="opt">Qt Generic Options</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>&tdesu; is a graphical front end for the
|
|
&UNIX; <command>su</command> command for the Trinity Desktop Environment.
|
|
It allows you to run a program as different user by supplying the
|
|
password for that user. &tdesu; is an unprivileged program; it uses
|
|
the system's <command>su</command>.</para>
|
|
|
|
<para>&tdesu; has one additional feature: it can optionally remember passwords
|
|
for you. If you are using this feature, you only need to enter the
|
|
password once for each command.</para>
|
|
|
|
<para>This program is meant to be started from the command line or
|
|
from <filename>.desktop</filename> files.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Options</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><option>-c <replaceable>program</replaceable></option></term>
|
|
<listitem><para>This specifies the program to run as root. It has to be passed
|
|
in one argument. So if, for example, you want to start a new file manager, you
|
|
would enter at the prompt: <userinput><command>tdesu <option>-c <replaceable>kfm
|
|
-sw</replaceable></option></command></userinput></para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-d</option></term>
|
|
<listitem><para>Show debug information.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-f <replaceable>file</replaceable></option></term>
|
|
<listitem><para>This option allow efficient use of &tdesu; in
|
|
<filename>.desktop</filename> files. It tells &tdesu; to examine the
|
|
file specified by <parameter>file</parameter>. If this file is
|
|
writable by the current user, &tdesu; will execute the command as the
|
|
current user. If it is not writable, the command is executed as user
|
|
<parameter>user</parameter> (defaults to root).</para>
|
|
<para><parameter>file</parameter> is evaluated like this: if
|
|
<parameter>file</parameter> starts with a <literal>/</literal>, it is
|
|
taken as an absolute filename. Otherwise, it is taken as the name of a
|
|
global &tde; configuration file. For example: to configure the K display
|
|
manager, <application>tdm</application>, you could issue
|
|
<command>tdesu <option>-c tdmconfig -f
|
|
tdmrc</option></command></para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-i</option> <replaceable>icon name</replaceable></term>
|
|
<listitem><para>Specify icon to use in the password dialog. You may specify
|
|
just the name, without any extension.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-n</option></term>
|
|
<listitem><para>Do not keep the password. This disables the <guilabel>keep
|
|
password</guilabel> checkbox in the password dialog.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-p</option> <replaceable>priority</replaceable></term>
|
|
<listitem>
|
|
<para>Set priority value. The priority is an arbitrary number between 0 and
|
|
100, where 100 means highest priority, and 0 means lowest. The default is
|
|
50.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-r</option></term>
|
|
<listitem><para>Use realtime scheduling.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><option>-s</option></term>
|
|
<listitem><para>Stop the tdesu daemon. This is the daemon that caches
|
|
successful passwords in the background. This feature may also be disabled with
|
|
<option>-n</option> when &tdesu; is initially run.</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-t</option></term>
|
|
<listitem><para>Enable terminal output. This disables password keeping. This is
|
|
largely for debugging purposes; if you want to run a console mode app, use the
|
|
standard <command>su</command> instead.</para> </listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>-u</option> <replaceable> user</replaceable></term>
|
|
<listitem><para>While the most common use for &tdesu; is to run a command as
|
|
the superuser, you can supply any user name and the appropriate
|
|
password.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>su(1)</para>
|
|
|
|
<para>More detailed user documentation is available from <ulink
|
|
url="help:/tdesu">help:/tdesu</ulink>
|
|
(either enter this <acronym>URL</acronym> into &konqueror;, or run
|
|
<userinput><command>khelpcenter</command>
|
|
<parameter>help:/tdesu</parameter></userinput>).</para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Examples</title>
|
|
<para>Run <command>kfmclient</command> as user <systemitem
|
|
class="username">jim</systemitem>, and show the &konqueror; icon in the
|
|
password dialog:</para>
|
|
<screen><userinput><command>tdesu</command> <option>-u jim</option> <option>-i konqueror</option> <command>kfmclient</command></userinput></screen>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Authors</title>
|
|
<para>&tdesu; was written by
|
|
<personname><firstname>Geert</firstname><surname>Jansen</surname></personname> <email>jansen@kde.org</email>
|
|
and <personname><firstname>Pietro</firstname><surname>Iglio</surname></personname>
|
|
<email>iglio@fub.it</email>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|