<refentry id="kdmrc">
<refmeta>
<refentrytitle
>&kdmrc;</refentrytitle>
<manvolnum
>5</manvolnum>
<refmiscinfo class="date"
>6 de Março de 2003</refmiscinfo>
<refmiscinfo class="sectdesc"
>man5</refmiscinfo>
<refmiscinfo class="software"
>versão</refmiscinfo>
<refmiscinfo class="copyright"
>Copyright KDE</refmiscinfo>
</refmeta>

<!-- IMPORTANT -->
<!-- The stylesheets for man pages are white space sensitive! -->
<!-- Do not leave empty lines between elements unless you really mean
to, and preview the result before you are done with it. -->

<refnamediv>
<refname
>&kdmrc;</refname>
<refpurpose
>O Ficheiro de Configuração do &kdm;</refpurpose>
</refnamediv>

<refsect1>
<title
>Comentários Gerais do &kdmrc;</title>

<para
>O formato básico do ficheiro é <quote
>do tipo INI</quote
>. As opções ou <quote
>chaves</quote
> têm um nome e um valor, separados por um <literal
>=</literal
> e são colocadas em secções. As chaves só são válidas nas secções para as quais foram definidas e não serão aplicadas (acompanhadas de um erro não-fatal) se forem colocadas incorrectamente. Algumas chaves não se aplicam a ecrãs em particular, em que nesse caso são ignoradas. </para>

<para
>O formato para todas as chaves é <userinput
><option
><replaceable
>chave</replaceable
></option
>=<parameter
>valor</parameter
></userinput
>. Os nomes das chaves dependem da capitalização, ou seja, há distinção de maiúsculas. As secções são demarcadas por <literal
>[<replaceable
>Nome da Secção</replaceable
>]</literal
>. As linhas que comecem por <literal
>#</literal
> são comentários.</para>

<para
>Você poderá configurar cada ecrã do X individualmente.</para>
<para
>Cada ecrã tem um nome específico, o qual é composto pelo nome de uma máquina (o qual é vazio para os ecrãs locais indicados no ficheiro Xservers), um sinal de dois pontos (:) e um número de ecrã. Adicionalmente, um ecrã pertence a uma classe específica (a qual poderá ser ignorada na maioria dos casos; o centro de controlo não suporta de todo esta funcionalidade).</para>

<para
>As secções com configurações específicas do ecrã têm a sintaxe formal <quote
>[X-" máquina [":" número [ "_" classe ]] "-" sub-secção "]</quote
></para>

<para
>Você poderá usar o carácter especial <literal
>*</literal
> para a máquina, o número e a classe. Você poderá omitir os componentes restantes; estes serão assumidos como <quote
>*</quote
>, nesse caso. A parte da máquina poderá ter uma especificação de dominio como <quote
>.homelinux.org</quote
>.</para>

<para
>A forma como se sabe a secção a que é extraída uma configuração é indicada por estas regras:</para>

<para
>Uma correspondência exacta tem precedência sobre uma correspondência parcial (para a parte da máquina), a qual tem precedência por sua vez sobre um carácter especial.</para>

<para
>A precedência diminui da esquerda para a direita nas ocorrências exactas equivalentes</para>

<itemizedlist>
<title
>Exemplo: nome de ecrã "maquina:0", classe "dpy"</title>
<listitem>
<para
>O [X-maquina:0_dpy] precede</para>
</listitem>
<listitem>
<para
>O [X-maquina:0_*] (o mesmo que [X-maquina:0]) precede</para>
</listitem>
<listitem>
<para
>O [X-maquina:*_dpy] precede</para>
</listitem>
<listitem>
<para
>O [X-maquina:*_*] (o mesmo que [X-maquina]) precede</para>
</listitem>
<listitem>
<para
>O [X-*:0_dpy] precede</para>
</listitem>
<listitem>
<para
>O [X-*:0_*] (o mesmo que [X-*:0]) precede</para>
</listitem>
<listitem>
<para
>O [X-*:*_*] (o mesmo que [X-*])</para>
</listitem>
</itemizedlist>

<para
>Estas secções <emphasis
>NÃO</emphasis
> correspondem a este ecrã:</para>

<para
>[X-maquina_dele], [X-maquina:0_dec], [X-*:1], [X-:*]</para>

<para
>Se não for encontrada numa dada secção, é usado o valor predefinido.</para>

<note
><para
>O &kdmrc; está largamente comentado e esta documentação é baseada nesses comentários. Cada comentário aplica-se à secção ou chave seguinte.</para>

<para
>Todos os comentários serão perdidos se você alterar este ficheiro com a interface do &kcontrol;. Os valores predefinidos dizem respeito aos valores embutidos no &kdm;. Os valores definidos no &kdmrc; sobrepõem os predefinidos, como tal você não precisa de definir todas as opções se estas predefinições já forem convenientes.</para
></note>

</refsect1>

<refsect1 id="kdmrc-general">
<title
>General</title>

<para
>A secção <literal
>[General]</literal
> contém a maioria das opções globais e aplica-se a todas as instâncias do &kdm; e ecrãs.</para>

<variablelist>
<varlistentry>
<term
><option
>Xservers</option
></term>
<listitem>
<para
>Se o valor começar por uma barra (<literal
>/</literal
>, esta chave indica o ficheiro onde estão listados os servidores de X a usar pelo &kdm;. O ficheiro está no formato normal do Xservers do &xdm;. Se o valor não começar por uma barra, esta chave é interpretada como se fosse uma única linha do ficheiro Xservers, &ie; corresponde exactamente a um servidor X.</para>
<para
>O valor por omissão é <parameter
>:0 local /usr/X11R6/bin/X</parameter
> </para
> <para
>Durante a instalação, o &kdm; irá tentar preencher a localização de um ficheiro <filename
>Xservers</filename
> existente, se conseguir encontrar algum.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>PidFile</option
></term>
<listitem>
<para
>Onde o &kdm; deverá guardar o seu <acronym
>PID</acronym
>. Por omissão deve-se deixar este campo em branco, o que significa <quote
>não guardar</quote
>. Você poderá querer indicar uma localização completa, como por exemplo <filename
>/var/run/xdm.pid</filename
>, de modo a que possa verificar com um programa se o &kdm; está em execução ou não.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>LockPidFile</option
></term>
<listitem>
<para
>Se o &kdm; deverá bloquear o ficheiro do <acronym
>PID</acronym
> para evitar que estejam várias instâncias do &kdm; em execução ao mesmo tempo. Deixe este valor como <quote
>true</quote
> (verdadeiro), a menos que seja corajoso. Isto não terá efeito a menos que você defina primeiro a opção <option
>PidFile</option
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AuthDir</option
></term>
<listitem>
<para
>Onde guardar os ficheiros de autorização. Por omissão é igual a <filename class="directory"
>/var/run/xauth</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AutoRescan</option
></term>
<listitem>
<para
>Se o &kdm; deverá reler automaticamente os ficheiros de configuração, ao constatar que foram alterados. Por omissão está igual a <quote
>true</quote
> (verdadeiro), e você não deverá ter necessidade de alterar este valor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ExportList</option
></term>
<listitem>
<para
>As variáveis de ambiente adicionais que o &kdm; deverá passar ao <filename
>kdm_config</filename
>, <filename
>kdm_greet</filename
>, <filename
>Xsetup</filename
>, <filename
>Xstartup</filename
>, <filename
>Xsession</filename
> e <filename
>Xreset</filename
>.</para>
<para
>Uma boa candidata é a <envar
>LD_LIBRARY_PATH</envar
>. O formato é:</para>
<screen
><userinput
><option
>ExportList</option
>=<parameter
>UMA_VARIAVEL,OUTRA_VARIAVEL_IMPORTANTE</parameter
></userinput
></screen>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>RandomFile</option
></term>
<listitem>
<para
>De onde o &kdm; deverá obter a entropia (<link linkend="gloss-entropy"
>entropy</link
>). O valor por omissão é o <filename
>/dev/mem</filename
>. Você não deverá ter necessidade de alterar isto.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FifoDir</option
></term>
<listitem>
<para
>Onde as <acronym
>FiFo</acronym
>s do comando deverão ser criadas. Deixe-a em branco para desactivar as <acronym
>FiFo</acronym
>s. O valor por omissão é <filename
>/var/run/xdmctl</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FifoGroup</option
></term>
<listitem>
<para
>A que grupo as <acronym
>FiFo</acronym
>s do comando deverão pertencer. Por omissão, deverá ser <parameter
>-1</parameter
> ou, efectivamente, <systemitem class="username"
>root</systemitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>ConfigVersion</option
></term>
<listitem>
<para
>Esta opção existe apenas com o intuito de limpar as actualizações automáticas. <emphasis
>Não</emphasis
> a altere, ou irá interferir com as futuras actualizações, e isso poderá fazer com que o &kdm; deixe de correr.</para>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-xdmcp">
<title
>Xdmcp</title>

<para
><indexterm
><primary
>&XDMCP;</primary
></indexterm
> Esta secção configura as ligações remotas através do &XDMCP;.</para>

<variablelist>
<title
>Chaves da secção [Xdmcp] do &kdmrc;</title>
<varlistentry>
<term
><option
>Enable</option
></term>
<listitem>
<para
>Se o &kdm; deverá atender os pedidos de &XDMCP;. Por omissão é igual a <parameter
>true</parameter
> (verdadeiro)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Port</option
></term>
<listitem>
<para
>O porto de <acronym
>UDP</acronym
> onde o &kdm; deverá atender os pedidos de &XDMCP;. O valor por omissão é igual a <parameter
>177</parameter
> e não deverá ser alterado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>KeyFile</option
></term>
<listitem>
<para
>O ficheiro com as chaves privadas dos terminais X. É obrigatório para a autenticação do &xdm;. A opção por omissão é deixar este campo em branco.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Xaccess</option
></term>
<listitem>
<para
>O ficheiro de controlo de acessos do &XDMCP;, no formato normal do <filename
>Xaccess</filename
> do &xdm;.</para>
<para
>O valor por omissão é um ficheiro chamado <acronym
>Xaccess</acronym
> na mesma pasta que o &kdmrc;. Você poderá colocar a localização do seu ficheiro <filename
>Xaccess</filename
> do &xdm; em utilização aqui.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ChoiceTimeout</option
></term>
<listitem>
<para
>O número de segundos a esperar por uma resposta do ambiente de trabalho depois de o utilizador ter escolhido uma máquina do selector. O valor por omissão é <parameter
>15</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>RemoveDomainname</option
></term>
<listitem>
<para
>Retira o nome do domínio dos nomes das ligações remotas, se for igual ao domínio local. O valor por omissão é <parameter
>true</parameter
> (verdadeiro).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>SourceAddress</option
></term>
<listitem>
<para
>Usa o endereço <acronym
>IP</acronym
> numérico da ligação recebida em vez do nome da máquina. Use isto nas máquinas com vários nomes. O valor por omissão é <parameter
>false</parameter
> (falso).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>Willing</option
></term>
<listitem>
<para
>O programa invocado para gerar dinamicamente as respostas aos pedidos de pesquisa por difusão do &XDMCP;.</para>
<para
>Por omissão, não é invocado nenhum programa, e a mensagem <quote
>Willing to manage</quote
> (disposto a gerir) é enviada como resposta.</para>
<para
>Você poderia colocar aqui a localização de um <filename
>Xwilling</filename
> existente se já configurou algum.</para>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-shutdown">
<title
>Desligar</title>
<para
></para>

<variablelist>
<title
>As chaves da secção [Shutdown] (desligar) do &kdmrc;</title>

<varlistentry>
<term
><option
>HaltCmd</option
></term>
<listitem>
<para
>O comando a ser executado para desligar o sistema. O valor por omissão é <command
>/sbin/shutdown</command
> <option
>-h</option
> <parameter
>now</parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>RebootCmd</option
></term>
<listitem>
<para
>O comando usado para reiniciar o sistema. O valor por omissão é o <command
>/sbin/shutdown</command
> <option
>-r</option
> <parameter
>now</parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowFifo</option
></term>
<listitem>
<para
>Se uma pessoa pode desligar o sistema através da <acronym
>FiFo</acronym
> global de comandos</para>
<para
>O valor por omissão é <parameter
>False</parameter
> (falso).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowFifoNow</option
></term>
<listitem>
<para
>Se alguém poderá interromper as sessões em execução ao desligar o sistema através da <acronym
>FiFo</acronym
> global de comandos.</para>
<para
>O valor por omissão é <parameter
>true</parameter
> (verdadeiro).</para>
<para
>Isto não terá efeito a menos que você tenha definido previamente a opção <option
>AllowFifo</option
>.</para>
</listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-core">
<title
>X-*-Core</title>

<para
>A configuração básica de todos os ecrãs. Os tempos estão indicados em segundos a menos que haja alguma referência em contrário.</para>

<para
>Algumas estimativas latas do número de segundos que o &kdm; irá gastar no máximo ao executar certas acções:</para>

<variablelist>
<varlistentry>
<term
>Abrir uma ligação ao &X-Server; (OpenTime)</term>
<listitem
><para
><option
>OpenRepeat</option
> * (<option
>OpenTimeout</option
> + <option
>OpenDelay</option
>)</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Iniciar um &X-Server; local (ServerTime)</term>
<listitem>
<para
><option
>ServerAttempts</option
> * <option
>ServerTimeout</option
></para
></listitem>
</varlistentry>

<varlistentry>
<term
>Iniciar uma ligação local</term>
<listitem>
<para
><option
>StartAttempts</option
> * (ServerTime + OpenTime)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Iniciar uma ligação remota</term>
<listitem>
<para
><option
>StartAttempts</option
> * OpenTime</para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title
>Chaves da secção [X-*-Core] do &kdmrc;</title>

<varlistentry>
<term
><option
>OpenDelay</option
></term>
<listitem>
<para
>Quanto tempo de espera ao fim de vários erros antes de repetir o início da ligação. O valor por omissão é <parameter
>15</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>OpenTimeout</option
></term>
<listitem
><para
>Quanto tempo de espera até expirar o XOpenDisplay. O valor por omissão é <parameter
>120</parameter
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>OpenRepeat</option
></term>
<listitem>
<para
>Quantas tentativas de invocação do XOpenDisplay. O valor por omissão é 5.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>StartAttempts</option
></term>
<listitem>
<para
>Tentar iniciar uma ligação este número máximo de vezes. Se isto falhar, a ligação é desactivada. O valor por omissão é <parameter
>4</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>StartInterval</option
></term>
<listitem>
<para
>O contador do <option
>StartAttempt</option
> é reinicializado no fim deste período. O valor por omissão é <parameter
>30</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>PingInterval</option
></term>
<listitem>
<para
>Efectua um 'ping' ao ambiente remoto no fim do período indicado por este valor em minutos. O valor por omissão é <parameter
>5</parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>PingTimeout</option
></term>
<listitem>
<para
>Esperar este tempo por uma resposta a um 'ping'. O valor por omissão é <parameter
>5</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>TerminateServer</option
></term>
<listitem>
<para
>Reinicia em vez de inicializar de novo o &X-Server; local depois da saída da sessão. Use isto se achar que o servidor está com fugas de memória ou não está a libertar os recursos. O valor por omissão é <parameter
>False</parameter
> (falso).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ResetSignal</option
></term>
<listitem>
<para
>O sinal necessário para reinicializar o &X-Server; local. O valor por omissão é  o <parameter
>1</parameter
>, que equivale a um <command
>SIGHUP</command
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>TermSignal</option
></term>
<listitem>
<para
>O sinal necessário para terminar o &X-Server; local. O valor por omissão é o <parameter
>15</parameter
>, que equivale a um <command
>SIGTERM</command
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ResetForAuth</option
></term>
<listitem>
<para
>Indica se é necessário reinicializar o &X-Server; para que este leia o ficheiro inicial <filename
>Xauth</filename
>.</para>
<para
>O valor por omissão é falso</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Authorize</option
></term>
<listitem>
<para
>Cria as autorizações de X para as ligações locais. O valor por omissão é verdadeiro.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AuthName</option
></term>
<listitem>
<para
>Quais os mecanismos de autorização do X que deverão ser usados.</para>
<para
>O valor por omissão é <parameter
>XDM-AUTHORIZATION-1,MIT-MAGIC-COOKIE-1</parameter
> e você deverá ter muito cuidado ao alterar isto a menos que tenha a certeza do que está a fazer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AuthFile</option
></term>
<listitem>
<para
>O nome do ficheiro <filename
>Xauth</filename
> deste &X-Server;. A opção por omissão é deixar este campo em branco, o que significa que será usado um nome aleatório na <option
>AuthDir</option
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Resources</option
></term>
<listitem>
<para
>Indica um ficheiro com os recursos do X para a saudação, para o selector e para o fundo. A interface do &kde; não tem nada disto em conta, por isso você não irá necessitar disto a menos que utilize um selector alternativo ou outro gerador do fundo do ecrã que não o <command
>kdmdesktop</command
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Xrdb</option
></term>
<listitem>
<para
>O programa <command
>xrdb</command
> a usar para ler os recursos indicados em cima. Por omissão é o <filename
>/usr/X11R6/bin/xrdb</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Setup</option
></term>
<listitem>
<para
>A program to run before the greeter is shown. You should start <command
>kdmdesktop</command
> there. Also, <command
>xconsole</command
> can be started by this script. The default is to leave this key empty.</para>
<!-- note about xdm Xsetup and docu for it -->
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Startup</option
></term>
<listitem>
<para
>Um programa a executar antes de iniciar a sessão de um utilizador. Você deveria executar o <command
>sessreg</command
> aí, bem como alterar a pertença da consola, &etc;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Reset</option
></term>
<listitem>
<para
>Um programa a executar depois da sessão de um utilizador sair.  Você deveria executar o <command
>sessreg</command
> aí, bem como alterar a pertença da consola, &etc;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Session</option
></term>
<listitem>
<para
>O programa que é executado, usando o utilizador que se liga. É suposto interpretar o argumento da sessão (veja o <option
>SessionTypes</option
>) e inicia uma sessão apropriada de acordo com ele.</para>
<para
>O valor por omissão é <parameter
><command
>/usr/X11R6/bin/xterm</command
> <option
>-ls</option
> <option
>-T</option
></parameter
>, mas se o &kdm; conseguir localizar um ficheiro Xsession já configurado durante a instalação, a localização do mesmo será preenchida em alternativa.</para>
<!-- Link to the xsession chapter -->
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FailsafeClient</option
></term>
<listitem>
<para
>O programa a executar se o <option
>Session</option
> falhar.</para>
<para
>O valor por omissão é <parameter
><command
>/usr/X11R6/bin/xterm</command
></parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>UserPath</option
></term>
<listitem>
<para
>A <envar
>PATH</envar
> do programa <option
>Session</option
>. O valor por omissão é igual a <parameter
>/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin</parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>SystemPath</option
></term>
<listitem>
<para
>A localização do <application
>Setup</application
>, <application
>Startup</application
> e do <application
>Reset</application
>, &etc;.</para>
<para
>O valor por omissão é <parameter
>/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>SystemShell</option
></term>
<listitem>
<para
>A linha de comandos por omissão. O valor predefinido é <parameter
>/bin/sh</parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>UserAuthDir</option
></term>
<listitem>
<para
>Onde colocar o ficheiro de autorização do &X-Server; do utilizador se não for possível criar o <filename
>~/.Xauthority</filename
>. O valor por omissão é o <parameter
><filename class="directory"
>/tmp</filename
></parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AutoReLogin</option
></term>
<listitem>
<para
>Se for igual a <parameter
>true</parameter
> (verdadeiro), o &kdm; irá reiniciar automaticamente uma sessão depois de um estoiro do &X-Server;, ou se este for morto por um <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>Delete</keycap
></keycombo
>. O valor por omissão é <parameter
>false</parameter
> (falso).</para>
<note
><para
>Se activar isto irá abrir um buraco de segurança: o bloqueio seguro de um ecrã poderá ser ignorado, a menos que utilize o bloqueio do ecrã característico do &kde;.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowRootLogin</option
></term>
<listitem>
<para
>Permitir as autenticações do <systemitem class="username"
>root</systemitem
>. O valor por omissão é <parameter
>true</parameter
> (verdadeiro).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowNullPasswd</option
></term>
<listitem>
<para
>Permite a ligação de um utilizador se este tiver uma senha em branco. O valor por omissão é <parameter
>true</parameter
> (verdadeiro).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowShutdown</option
></term>
<listitem>
<para
>Quem é que tem permissões para desligar o sistema. Isto aplica-se tanto à saudação como à <acronym
>FiFo</acronym
> de comandos. O valor por omissão é <parameter
>All</parameter
> (todos).</para>
<para
>Os valores possíveis são:</para>

<variablelist>
<varlistentry>
<term
><parameter
>None</parameter
></term>
<listitem
><para
>Não é mostrado nenhum botão de <guibutton
>Desligar...</guibutton
> de todo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Root</parameter
></term>
<listitem
><para
>A senha do 'root' deverá ser introduzida para desligar.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>All</parameter
></term>
<listitem
><para
>Toda a gente poderá desligar a máquina.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>AllowSdForceNow</option
></term>
<listitem>
<para
>Quem é que tem permissões para interromper todas as sessões ainda em execução ao desligar-se. Os valores possíveis são os mesmos que para o <option
>AllowShutdown</option
>, e o valor por omissão é o <parameter
>All</parameter
> (todos)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>DefaultSdMode</option
></term>
<listitem>
<para
>A escolha por omissão para a condição/temporização da finalização.</para>
<para
>Os valores possíveis são:</para>

<variablelist>
<varlistentry>
<term
><parameter
>Schedule</parameter
></term>
<listitem
><para
>Desligar após todas as sessões terem terminado (possivelmente de uma vez). Esta é a opção por omissão.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>TryNow</parameter
></term>
<listitem
><para
>Desligar, se não existirem nenhumas sessões abertas, caso contrário não faz nada.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>ForceNow</parameter
></term>
<listitem>
<para
>Desligar incondicionalmente.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>InteractiveSd</option
></term>
<listitem
><para
>Se este valor for <parameter
>false</parameter
> (falso), o utilizador deverá seleccionar a condição/temporização da finalização directamente na janela de finalização. Se for <parameter
>true</parameter
> (verdadeiro), as opções não serão mostradas mas será pedido ao utilizador o que fazer se existirem sessões abertas. O valor por omissão é <parameter
>true</parameter
>.</para>
<note
><para
>A interacção não está implementada de momento. Se esta for igual a 'true' (verdadeiro), uma finalização forçada irá acontecer, ignorando o valor da opção <option
>AllowSdForceNow</option
>!</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>SessSaveFile</option
></term>
<listitem>
<para
>O local onde, em relação à pasta pessoal do utilizador, onde guardar a última sessão seleccionada. O valor por omissão é o <filename
>.wmrc</filename
>.</para>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-greeter">
<title
>X-*-Greeter</title>

<para
>A configuração da saudação para todos os ecrãs.</para>

<variablelist>
<title
>Chaves para a secção [X-*-Greeter] do &kdmrc;</title>

<varlistentry>
<term
><option
>SessionTypes</option
></term>
<listitem>
<para
>Os tipos de sessão que os utilizadores poderão seleccionar. É aconselhável ter o <parameter
>default</parameter
> (por omissão) e o <parameter
>failsafe</parameter
> (de recurso) aqui listados (este é o valor por omissão)</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="option-guistyle"
><option
>GUIStyle</option
></term>
<listitem>
<para
>O estilo gráfico da saudação. Os valores disponíveis são o <parameter
>Default</parameter
>, <parameter
>Windows</parameter
>, <parameter
>Platinum</parameter
>, <parameter
>Motif</parameter
>, <parameter
>MotifPlus</parameter
>, <parameter
>CDE</parameter
>, <parameter
>SGI</parameter
> e todos os outros estilos que você tenha instalados como o <parameter
>Keramik</parameter
> ou o <parameter
>HighColor</parameter
>.</para>
<para
>O valor por omissão é <parameter
>Default</parameter
> (predefinido).</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="option-colorscheme"
><option
>ColorScheme</option
></term>
<listitem>
<para
>O esquema de cores da saudação. O valor por omissão é o <parameter
>Default</parameter
> (predefinido). Todos os esquemas de cores que tenha instalados, como por exemplo o <parameter
>Pumpkin</parameter
> (Abóbora) poderão ser usados aqui.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="option-logoarea"
><option
>LogoArea</option
></term>
<listitem>
<para
>O que deverá ser mostrado ao lado dos campos de texto.</para>
<para
>Os valores possíveis são:</para>
<variablelist>
<varlistentry>
<term
><parameter
>Logo</parameter
></term>
<listitem
><para
>A imagem indicada pelo <option
>LogoPixmap</option
>. Esta é a opção predefinida</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Clock</parameter
></term>
<listitem>
<para
>Um relógio analógico</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>None</parameter
></term>
<listitem>
<para
>Nothing</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>LogoPixmap</option
></term>
<listitem>
<para
>A imagem a mostrar no caso da opção <option
>LogoArea</option
>=<parameter
>Logo</parameter
>. O valor por omissão é <parameter
>kdelogo.png</parameter
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term id="option-greeterposfixed"
><option
>GreeterPosFixed</option
></term>
<term
><option
>GreeterPosX</option
></term>
<term
><option
>GreeterPosY</option
></term>
<listitem>
<para
>Normalmente a saudação está centrada no ecrã. Use estas opções se quiser que esta apareça noutro lado do ecrã. O valor por omissão para o <option
>GreeterPosFixed</option
> é estar definido como <parameter
>false</parameter
> (falso), onde neste caso a alteração das outras duas opções não fará efeito.</para>
</listitem>
</varlistentry>

<varlistentry>
<term id="option-greetstring"
><option
>GreetString</option
></term>
<listitem>
<para
>O cabeçalho da saudação.</para>
<para
>Os seguintes caracteres serão substituídos pelos seus valores:</para>
<variablelist>
<varlistentry>
<term
><parameter
>%d</parameter
></term>
<listitem
><para
>O ecrã ('display') actual.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%h</parameter
></term>
<listitem
><para
>o nome da máquina, provavelmente sem o domínio.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%n</parameter
></term>
<listitem
><para
>O nome do nó, provavelmente o nome da máquina sem o domínio.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%s</parameter
></term>
<listitem
><para
>O sistema operativo</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%r</parameter
></term>
<listitem
><para
>A versão do sistema operativo</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%m</parameter
></term>
<listitem
><para
>O tipo da máquina ('hardware')</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>%%</parameter
></term>
<listitem
><para
>Um <literal
>%</literal
></para>
</listitem>
</varlistentry>
</variablelist>

<para
>O texto por omissão é <parameter
>Bem-vindo ao %s em %n</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>GreetFont</option
></term>
<listitem
><para
>O tipo de letra do cabeçalho. O valor por omissão é <parameter
>charter,24,bold</parameter
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>StdFont</option
></term>
<listitem>
<para
>O tipo de letra normal usado na saudação. O valor por omissão é <parameter
>helvetica,12</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FailFont</option
></term>
<listitem>
<para
>O tipo de letra usado para a mensagem de <errorname
>A Autenticação Falhou</errorname
>. O valor por omissão é <parameter
>helvetica,12,bold</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>AntiAliasing</term>
<listitem
><para
>Se os tipos de letra na saudação deverão ser suavizados ('antialiased'). O valor por omissão é <parameter
>false</parameter
> (falso)</para
></listitem>
</varlistentry>

<varlistentry>
<term
>NumLock</term>
<listitem>
<para
>O que fazer com o modificador Num Lock na altura em que a saudação está em execução.</para>

<variablelist>
<varlistentry>
<term
><parameter
>On</parameter
></term>
<listitem
><para
>Liga o Num Lock</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Off</parameter
></term>
<listitem
><para
>Desliga o Num Lock</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Keep</parameter
></term>
<listitem
><para
>Não altera o estado (esta é a opção por omissão)</para>
</listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term
><option
>Language</option
></term>
<listitem>
<para
>A língua a usar na saudação. Por omissão é igual a <parameter
>en_US</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ShowUsers</option
></term>
<listitem>
<para
>Indicar quais os utilizadores (e as suas imagens) que devem ser mostrados na saudação.</para>
<para
>Os valores disponíveis são:</para>
<variablelist>
<varlistentry>
<term
><parameter
>NotHidden</parameter
></term>
<listitem
><para
>Todos os utilizadores excepto os listados em <option
>HiddenUsers</option
>. Este é o valor por omissão.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Selected</parameter
></term>
<listitem
><para
>Só os utilizadores enumerados no <option
>SelectedUsers</option
></para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>None</parameter
></term>
<listitem>
<para
>Não é mostrada nenhuma lista de utilizadores de todo. Os utilizadores deverão indicar um nome de utilizador correcto.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>SelectedUsers</option
></term>
<listitem
><para
>Só terá efeito se o <option
>ShowUsers</option
> for igual a <parameter
>Selected</parameter
>. Indique aqui uma lista separada por vírgulas dos utilizadores a mostrar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>HiddenUsers</option
></term>
<listitem
><para
>Só terá efeito se o <option
>ShowUsers</option
> for igual a <parameter
>NotHidden</parameter
>. Indique aqui uma lista separada por vírgulas dos utilizadores a mostrar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>MinShowID</option
></term>
<listitem
><para
>Este é um caso especial para o <option
>HiddenUsers</option
>. Para além dos utilizadores aí indicados, os utilizadores com um <acronym
>UID</acronym
> menor do que este número (e que não o <systemitem class="username"
>root</systemitem
>) serão também escondidos. O valor por omissão é o <parameter
>0</parameter
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>MaxShowID</option
></term>
<listitem
><para
>Um complemento ao <option
>MinShowID</option
>. Os utilizadores com um <acronym
>UID</acronym
> maior do que este número também serão escondidos. O valor por omissão é <parameter
>65535</parameter
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>SortUsers</option
></term>
<listitem>
<para
>Se for igual a <parameter
>false</parameter
> (falso), os utilizadores são listados pela ordem que aparecem no ficheiro <filename
>/etc/passwd</filename
>. Se for <parameter
>true</parameter
> (verdadeiro), são ordenados alfabeticamente. O valor por omissão é <parameter
>true</parameter
> (verdadeiro).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FaceSource</option
></term>
<listitem
><para
>Indica de onde as imagens dos utilizadores deverão ser extraídas. Os valores disponíveis são:</para>

<variablelist>
<varlistentry>
<term
><parameter
>AdminOnly</parameter
></term>
<listitem
><para
>Do <filename
>$<envar
>KDEDIR</envar
>/share/apps/kdm/pics/users/$<envar
>USER</envar
>.png</filename
>. Este é o valor por omissão.</para>
</listitem
></varlistentry>
<varlistentry>
<term
><parameter
>UserOnly</parameter
></term>
<listitem
><para
>Do ficheiro do utilizador <filename
>$<envar
>HOME</envar
>/.face</filename
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>PreferAdmin</parameter
></term>
<listitem
><para
>Preferir o <filename
>$<envar
>USER</envar
>.png</filename
>, com último recurso em <filename
>$<envar
>HOME</envar
>/.face</filename
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>PreferUser</parameter
></term>
<listitem
><para
>A outra forma inversa.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>PreselectUser</option
></term>
<listitem
><para
>Indica se deverá ser pré-seleccionado um utilizador e qual, nesse caso, na autenticação.</para>
<note
><para
>Se activar esta funcionalidade, poderá estar a abrir um buraco de segurança, dado que apresenta um utilizador válido a um potencial atacante, sendo que nesse caso este <quote
>só</quote
> necessitará de adivinhar a senha.</para
></note>
<para
>Os valores disponíveis são:</para>

<variablelist>
<varlistentry>
<term
><parameter
>None</parameter
></term>
<listitem
><para
>Não pré-selecciona nenhum utilizador. Este é o valor por omissão.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Previous</parameter
></term>
<listitem
><para
>O utilizador que se ligou com sucesso da última vez.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>Default</parameter
></term>
<listitem>
<para
>O utilizador indicado na opção <option
>DefaultUser</option
>.</para
></listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term
><option
>DefaultUser</option
></term>
<listitem
><para
>O utilizador a pré-seleccionar se a opção <option
>PreselectUser</option
> for igual a <parameter
>Default</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>FocusPasswd</option
></term>
<listitem
><para
>Se este valor for verdadeiro, o campo de introdução da senha ficará logo em primeiro plano, se for seleccionado um utilizador. O valor por omissão é <parameter
>False</parameter
> (falso).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>EchoMode</option
></term>
<listitem>
<para
>O campo de introdução da senha disfarça o texto nele introduzido. Aqui você poderá indicar como é que isso é feito:</para>
<variablelist>
<varlistentry>
<term
><parameter
>NoEcho</parameter
></term>
<listitem>
<para
>Não é mostrado nada. O cursor não se mexe.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>OneStar</parameter
></term>
<listitem>
<para
>É mostrado um <literal
>*</literal
> por cada carácter introduzido. Este é o valor por omissão.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>ThreeStars</parameter
></term>
<listitem
><para
>É mostrado um <literal
>***</literal
> por cada carácter introduzido.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>UseBackground</option
></term>
<listitem
><para
>Se for verdadeiro, o &kdm; irá alterar o fundo através do <command
>krootimage</command
>. Caso contrário, o programa <command
>Setup</command
> deverá ser usado para alterar o fundo. O valor por omissão é <parameter
>true</parameter
> (verdadeiro)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>BackgroundCfg</option
></term>
<listitem
><para
>O ficheiro de configuração a usar para o <command
>krootimage</command
> se o <option
>UseBackground</option
> for igual a <parameter
>true</parameter
> (verdadeiro). O valor por omissão é <parameter
><filename
>$<envar
>KDEDIR</envar
>/share/config/kdm/backgroundrc</filename
></parameter
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>GrabServer</option
></term>
<listitem>
<para
>Manter o &X-Server; em primeiro plano durante todo o tempo que a saudação se encontra visível. Isto poderá ser mais seguro, mas irá desactivar o fundo e os outros clientes de X iniciados no programa <command
>Setup</command
>. O valor por omissão é <parameter
>false</parameter
> (falso)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>GrabTimeout</option
></term>
<listitem
><para
>Quantos segundos a esperar por uma captura bem-sucedida.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>AuthComplain</option
></term>
<listitem
><para
>Avisar se não puder ser criada a autorização local do X. O valor por omissão é <parameter
>true</parameter
> (verdadeiro). Esta opção ainda não está implementada, como tal se for alterada não terá efeito.</para
></listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-core-local">
<title
>X-:*-Core</title>

<para
>Configuração básica para os ecrãs locais.</para>

<variablelist>
<title
>Chaves da secção [X-:*-Core] do &kdmrc;</title>

<varlistentry>
<term
><option
>ServerAttempts</option
></term>
<listitem>
<para
>Quantas tentativas de execução do &X-Server;. A execução implica também a validação do arranque. O valor por omissão é <parameter
>1</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ServerTimeout</option
></term>
<term
><option
>AllowShutdown</option
></term>
<term
><option
>AllowRootLogin</option
></term>
<term
><option
>AllowNullPasswd</option
></term>
<listitem
><para
>O mesmo que para a secção [X-*-Core].</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>NoPassEnable</option
></term>
<listitem
><para
>Activa as autenticação sem senha para este ecrã. <emphasis
>Use com bastante cuidado!</emphasis
> O valor por omissão é <parameter
>false</parameter
> (falso).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>NoPassUsers</option
></term>
<listitem
><para
>Os utilizadores que não precisam de indicar nenhuma senha para se ligarem. <emphasis
>Nunca</emphasis
> indique o <systemitem class="username"
>root</systemitem
>.</para
></listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-greeter-local">
<title
>X-:*-Greeter</title>

<para
>A configuração da saudação para os ecrãs locais</para>

<variablelist>
<title
>Chaves para a secção [X-:*-Greeter] do &kdmrc;</title>

<varlistentry>
<term
><option
>AuthComplain</option
></term>
<listitem
><para
>O mesmo que para a secção [X-*-Greeter].</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>GreeterScreen</option
></term>
<listitem
><para
>O ecrã em que a saudação deverá ser mostrada para as configurações com vários ecrãs. A numeração começa em <parameter
>0</parameter
> e corresponde à ordem de listagem na secção ServerLayout activa do <filename
>XF86Config</filename
>. O <parameter
>-1</parameter
> significa utilizar o ecrã do canto superior esquerdo e o <parameter
>-2</parameter
> significa usar o ecrã superior direito. O valor por omissão é <parameter
>0</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>LoginMode</option
></term>
<listitem
><para
>Indica se a saudação dos ecrãs locais deverá iniciar no selector das máquinas (remoto) ou no modo de autenticação (local) e se é permitido mudar para o outro modo.</para>
<para
>Os valores disponíveis são:</para>
<variablelist>
<varlistentry>
<term
><parameter
>LocalOnly</parameter
></term>
<listitem
><para
>Só é permitida a autenticação local. Este é o valor por omissão.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>RemoteOnly</parameter
></term>
<listitem
><para
>Só é permitida a escolha de uma máquina remota.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>DefaultLocal</parameter
></term>
<listitem
><para
>Inicia no modo local, mas permite a mudança para o modo remoto.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><parameter
>DefaultRemote</parameter
></term>
<listitem
><para
>Inicia no modo remoto, mas permite a mudança para o modo local.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>ChooserHosts</option
></term>
<listitem
><para
>Uma lista separada por vírgulas com as máquinas a adicionar automaticamente ao menu de autenticação remota. O nome especial <parameter
>*</parameter
> significa que será feita uma difusão. O valor por omissão é <parameter
>*</parameter
>.</para>
</listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-core-local-first">
<title
>X-:0-Core</title>
<para
>Configuração básica para apenas o primeiro ecrã local</para>

<variablelist>
<title
>Chaves para a secção [X-:0-Core] do &kdmrc;</title>

<varlistentry>
<term
><option
>AutoLoginEnable</option
></term>
<listitem
><para
>Activa a autenticação automática neste ecrã. <emphasis
>Use com bastante cuidado!</emphasis
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>AutoLoginUser</option
></term>
<listitem
><para
>O utilizador a ligar-se automaticamente. <emphasis
>Nunca</emphasis
> escolha o <systemitem class="username"
>root</systemitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>AutoLoginPass</option
></term>
<listitem
><para
>A senha para o utilizador se ligar automaticamente. Esta <emphasis
>não</emphasis
> é obrigatória a menos que o utilizador se ligue num domínio de <acronym
>NIS</acronym
> ou de Kerberos. Se você usar esta opção, deverá fazer um <userinput
><command
>chmod</command
> <option
>600</option
> <filename
>kdmrc</filename
></userinput
> por razões óbvias.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>AutoLoginSession</option
></term>
<listitem>
<para
>A sessão com a qual o utilizador se irá ligar automaticamente. Isto torna-se inútil após a primeira autenticação do utilizador, dado que terá precedência a última sessão usada.</para
></listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1 id="kdmrc-x-greeter-local-first">
<title
>X-:0-Greeter</title>
<para
>A configuração da saudação para o primeiro ecrã local</para>

<variablelist>
<title
>Chaves da secção [X-:0-Greeter] do &kdmrc;</title>
<varlistentry>
<term
><option
>PreselectUser</option
></term>
<term
><option
>DefaultUser</option
></term>
<listitem
><para
>Estas opções são as mesmas que para a secção [X-*-Greeter].</para
></listitem>
</varlistentry>
</variablelist>

</refsect1>
</refentry>


