<para>Program &tdesu; jest graficzną nakładką środkowiska KDE na systemowe polecenie <command>su</command>. Pozwala na uruchamianie programów z poziomem uprawnień innego użytkownika pytając o jego hasło. Program &tdesu; nie wymaga żadnych dodatkowych praw dostępu gdyż wykorzystuje on polecenie systemowe <command>su</command>.</para>
<para>Dodatkową funkcją programu &tdesu; jest opcjonalna możliwość zapamiętywania wprowadzanych haseł. Jeżeli jest włączona, to podanie hasła jest wymagane tylko raz dla każdego polecenia.</para>
<listitem><para>Określa polecenie, które należy uruchomić z poziomem uprawnień administratora. Polecenie musi podane jako jeden argument, dlatego na przykład jeżeli użytkownik chce uruchomić menedżera plików, powinien wprowadzić w linii poleceń: <userinput><command>tdesu <option>-c <replaceable>kfm -sw</replaceable></option></command></userinput></para></listitem>
<listitem><para>Parametr ten pozwala na efektywne wykorzystanie programu &tdesu; w plikach <filename>.desktop</filename>. Powoduje, iż &tdesu; sprawdza wskazany <parameter>plik</parameter> czy jest zapisywalny przez bieżącego użytkownika. Jeżeli tak, to polecenie zostanie wykonane z poziomem uprawnień bieżącego użytkownika, a jeżeli nie to polecenie zostanie wykonane z uprawnieniami użytkownika <parameter>użytkownik</parameter> (wartością domyślną jest administrator tzn. użytkownik root).</para>
<para>Ścieżka do pliku <parameter>plik</parameter> jest wyznaczana następująco: jeżeli <parameter>plik</parameter> rozpoczyna się od znaku <literal>/</literal> to traktowana jest jako ścieżka absolutna, jeżeli zaś nie to katalogiem podstawowym będzie katalog konfiguracji globalnej środowiska &kde;. Na przykład aby skonfigurować menedżer wyświetlania KDE <application>tdm</application>, można wprowadzić polecenie <command>tdesu <option>-c tdmconfig -f tdmrc</option></command></para></listitem>
<listitem><para>Nie przechowuj hasła. Opcja ta wyłącza działanie pola wyboru <guilabel>przechowuj hasło</guilabel> w oknie dialogowym wprowadzania hasła.</para></listitem>
<para>Określa priorytet wykonania programu. Jest to liczba całkowita z przedziału od 0 do 100, gdzie 100 oznacza najwyższy priorytet, a 0 najniższy. Wartością domyślną jest 50.</para>
<listitem><para>Zatrzymuje usługę &tdesu;. Jest to usługa przechowująca w tle poprawnie wprowadzone hasła. Funkcja ta może też być wyłączona przez podanie parametru <option>-n</option> przy uruchamianiu programu.</para></listitem>
<listitem><para>Włącza wyjście na terminal. Parametr wyłącza funkcję przechowywania haseł, zaś wykorzystywany jest najczęściej w celu poszukiwaniu błędów. W celu uruchomienia aplikacji w trybie konsolowym najlepiej jest jednak używać standardowego polecenia <command>su</command>.</para> </listitem>
<listitem><para>Chociaż najczęściej &tdesu; jest wykorzystywane do uruchamiania programów z poziomem uprawnień administratora, można też wybrać innych użytkowników podając nazwę użytkownika i odpowiednie hasło.</para>
<para>Szczegółowa dokumentacja jest dostępna pod adresem <ulink url="help:/tdesu">help:/tdesu</ulink> (należy go wprowadzić jako adres <acronym>URL</acronym> w programie &konqueror; lub wykonać polecenie <userinput><command>khelpcenter</command> <parameter>help:/tdesu</parameter></userinput>).</para>
<para>Uruchamia program <command>kfmclient</command> jako użytkownik <systemitem class="username">jim</systemitem>, i wyświetla ikonę &konqueror-dopelniacz; w oknie dialogowym pytania o hasło.</para>