<para>O &tdesu; é uma interface gráfica para o comando de &UNIX; <command>su</command> para o Ambiente de Trabalho K. Permite-lhe executar um programa com um utilizador diferente, indicando a senha desse utilizador. O &tdesu; é um programa sem privilégios; utiliza apenas o <command>su</command> do sistema.</para>
<para>O &tdesu; tem uma funcionalidade adicional: poderá recordar opcionalmente as senhas para si. Se estiver a usar esta funcionalidade, só terá de indicar uma vez a senha para cada comando.</para>
<listitem><para>Isto indica que o programa é executado como 'root'. Tem de ser passado um argumento. Assim se, por exemplo, quiser iniciar um novo gestor de ficheiros, iria introduzir na linha de comandos: <userinput><command>tdesu<option>-c <replaceable>kfm -sw</replaceable></option></command></userinput></para></listitem>
<listitem><para>Esta opção permite um uso eficiente do &tdesu; em ficheiros <filename>.desktop</filename>. Isto diz ao &tdesu; para examinar o ficheiro indicado em <parameter>ficheiro</parameter>. Se este ficheiro puder ser alterado pelo utilizador actual, o &tdesu; irá executar o comando com esse utilizador. Se não puder ser alterado, o comando é executado com o utilizador <parameter>utilizador</parameter> (o 'root', por omissão).</para>
<para>O <parameter>ficheiro</parameter> é avaliado da seguinte forma: se o <parameter>ficheiro</parameter> começar por um <literal>/</literal>, é usado como um ficheiro absoluto. Caso contrário, é tratado como o nome de um ficheiro de configuração global do &kde;. Por exemplo: para configurar o gestor de autenticações do KDE, o <application>tdm</application>, poderá usar o comando <command>tdesu <option>-c tdmconfig -f tdmrc</option></command></para></listitem>
<para>Indica o valor da prioridade. A prioridade é um número qualquer entre 0 e 100, onde o 100 corresponde à prioridade máxima e o 0 à mínima. O valor por omissão é 50.</para>
<listitem><para>Pára o servidor do 'tdesu'. Este é o servidor que coloca em 'cache' as senhas bem-sucedidas em segundo plano. Esta funcionalidade também poderá ser desactivada com o <option>-n</option>, quando o &tdesu; é executado inicialmente.</para></listitem>
<listitem><para>Permite enviar o resultado para o terminal. Isto desactiva a memorização de senhas. É largamente usado para efeitos de depuração; se você quiser executar uma aplicação no modo de consola, use o comando "<command>su</command>" normal.</para> </listitem>
<listitem><para>Embora a utilização mais comum do &tdesu; seja correr um comando como super-utilizador, poderá indicar qualquer nome de utilizador e a senha apropriada.</para>
<para>Está disponível mais documentação de utilizador detalhada em <ulink url="help:/tdesu">help:/tdesu</ulink> (tanto poderá indicar este <acronym>URL</acronym> no &konqueror;, como executar <userinput><command>khelpcenter</command> <parameter>help:/tdesu</parameter></userinput>).</para>
<para>Executar o <command>kfmclient</command> com o utilizador <systemitem class="username">ze</systemitem>, e mostrar o ícone do &konqueror; na janela de senhas:</para>
<para>O &tdesu; foi criado por <personname><firstname>Geert</firstname><surname>Jansen</surname></personname> <email>jansen@kde.org</email> e <personname><firstname>Pietro</firstname><surname>Iglio</surname></personname> <email>iglio@fub.it</email>. </para>