<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!ENTITY kappname "&kdm;">
  <!ENTITY package "kdebase">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE" 
> <!-- change language only here -->
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &kdm;</title>

<authorgroup>
<author
> <firstname
>Neal</firstname
> <surname
>Crook</surname
> <affiliation
><address
><email
>nac@forth.org</email
></address
></affiliation
> </author>
<othercredit role="developer">
<firstname
>Steffen</firstname>
<surname
>Hansen</surname>
<affiliation
><address
><email
>stefh@dit.ou.dk</email
></address
></affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>
<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Revisão</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@rnl.ist.utl.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit>

</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Neal Crook</holder>
</copyright>

<date
>2000-12-12</date>
<releaseinfo
>0.05.02</releaseinfo>

<abstract>
<para
>Este documento descreve o &kdm;, o Gestor de Ligações do KDE. O &kdm; também é conhecido como o <quote
>Gestor de Autenticação</quote
>.</para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdm</keyword>
<keyword
>xdm</keyword>
<keyword
>gestor de ecrã</keyword>
<keyword
>gestor de autenticação</keyword>
</keywordset>
</bookinfo>

<!-- ********************************************************************** -->  

 
<chapter id="Introduction"
> 

<title
>Introdução</title
> 

<para
> O &kdm; oferece uma interface gráfica que lhe permite autenticar-se num sistema. Ele pede-lhe o 'login' (utilizador) e a senha, autentica o utilizador e inicia uma "sessão". O &kdm; é um substituto do <application
>xdm</application
>, o Gestor de Ligações do X e é superior a ele em vários aspectos.</para
> <para
> A interface com o utilizador do &kdm; é feita através de duas janelas. A janela principal tem estas funcionalidades:</para>

<itemizedlist
> <listitem
><para
>Um campo de "<guilabel
>Utilizador</guilabel
>" para você poder dar o nome do seu utilizador no sistema.</para
></listitem
> <listitem
><para
>Um campo "<guilabel
>Senha</guilabel
>" para poder introduzir a sua senha ou palavra-passe.</para
></listitem
> <listitem
><para
>Uma região à esquerda dos campos "<guilabel
>Utilizador</guilabel
>" e "<guilabel
>Senha</guilabel
>" que pode ser usado para mostrar uma imagem estática ou um relógio analógico.</para
></listitem
> <listitem
><para
>(Opcionalmente) uma imagem gráfica de cada utilizador (por exemplo, uma fotografia digitalizada). Se carregar nessa imagem, o efeito é o mesmo de escrever o nome do utilizador associado a essa imagem no campo "<guilabel
>Utilizador</guilabel
>". (Esta funcionalidade é uma imitação da janela de autenticação do IRIX).</para
></listitem
> <listitem
><para
>Uma lista "<guilabel
>tipo de sessão</guilabel
>" que permite ao &kdm; ser usado para iniciar as sessões com vários tipos de gestor de janelas ou ambientes gráficos no sistema, como por exemplo o KDE, o KDE2 e o GNOME.</para
></listitem
> <listitem
><para
>Um botão "<guibutton
>OK</guibutton
>" que valida o utilizador e a senha e tenta iniciar uma sessão com o tipo seleccionado.</para
></listitem
> <listitem
><para
>Um botão "<guibutton
>Cancelar</guibutton
>" que limpa o texto dos campos "<guilabel
>Utilizador</guilabel
>" e "<guilabel
>Senha</guilabel
>".</para
></listitem
> <listitem
><para
>(Opcionalmente) um botão "<guibutton
>Desligar</guibutton
>" que mostra a janela de terminação "<guibutton
>Desligar</guibutton
>".</para
></listitem
> </itemizedlist>

<para
>A janela "<guilabel
>Desligar</guilabel
>" apresenta um conjunto de opções exclusivas que poderão então ser seleccionadas:</para>

<variablelist
> <varlistentry
> <term
>Desligar</term
> <listitem
><para
>Termina o sistema de uma forma controlada, para o preparar para ser desligado.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Reiniciar</term
> <listitem
><para
>Termina o sistema e arranca-o. Para os sistemas que utilizam o <application
>Lilo</application
>, pode ser usada uma lista opcional que lhe permite seleccionar um 'kernel' de sistema operativo para ser usado no arranque.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Reiniciar o Servidor X</term
> <listitem
><para
>Termina e reinicia o servidor do X. Tipicamente, poderá querer usar esta opção se alterou de alguma forma a configuração do seu X11.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Modo de Consola</term
> <listitem
><para
>Desliga o servidor do X e remete o sistema para o modo de consola. Isto é feito ao mudar o sistema para o 'runlevel' 3. Tipicamente, o gestor do sistema poderá usar esta opção antes de actualizar ou reconfigurar os programas do X11.</para
></listitem
> </varlistentry
> </variablelist>

<para
>Se carregar no botão "<guibutton
>OK</guibutton
>" inicia a acção seleccionada; se carregar no "<guibutton
>Cancelar</guibutton
>" volta para a janela principal do &kdm;. </para>

<para
>O próximo capítulo explica como configurar o &kdm;. Os capítulos subsequentes descrevem como configurar o seu sistema para usar o &kdm;, como o compilar e instalar a partir do código-fonte, e como aprender mais sobre o &kdm; e sobre o projecto do KDE.</para
> 

</chapter>

<!-- *********************************************************************** -->
<chapter id="Configuring-kdm">
<title
>Configurar o &kdm;</title>

<para
>Este capítulo assume que o &kdm; já está instalado e pronto no seu sistema e que, simplesmente, o utilizador pretende apenas alterar o seu comportamento de alguma forma. Se o seu problema for mais sério, avance para os capítulos posteriores. </para
> 

<para
>Quando o &kdm; se inicia, ele lê a sua configuração a partir do ficheiro <filename
>kdmrc</filename
>. Dado que o &kdm; precisa correr antes de qualquer utilizador se autenticar, não está associado com nenhum utilizador em particular. Como tal, não é possível ter um ficheiro <filename
>$HOME/share/config/kdmrc</filename
> específico para cada utilizador; todos partilham a versão comum do <filename
>kdmrc</filename
>, localizada em <filename
>$KDEDIR/share/config/kdmrc</filename
>. Daí, parte-se do princípio que a configuração do &kdm; só poderá ser alterada por aqueles utilizadores que tiverem acesso de escrita ao <filename
>$KDEDIR/share/config/kdmrc</filename
> (o que normalmente está restrito aos administradores de sistema que se ligam como "root"). </para
> 

<!-- ** nac TODO the link to local kderc doesn't work.. I get a security ** -->
<!-- error; yet I can point to the file manually. what should it be? --> 

<para
>Poderá ver o ficheiro <filename
>kdmrc</filename
> que está em uso actualmente no seu sistema (e que se localiza em <filename
>$KDEDIR/share/config/kdmrc</filename
>), e poderá configurar o &kdm;, bastando para tal editar este ficheiro. Em alternativa, poderá usar a ferramenta de configuração gráfica oferecida pelo Centro de Controlo do KDE (situada em <menuchoice
><guisubmenu
>Aplicações</guisubmenu
> <guisubmenu
>Sistema</guisubmenu
> <guimenuitem
>Gestor de Autenticação</guimenuitem
></menuchoice
>), o qual se encontra descrito nos <ulink url="help:/kcontrol/login-manager.html"
>ficheiros de ajuda do KControl</ulink
>.</para>

<para
>O resto deste capítulo descreve o conteúdo do ficheiro <literal
>kdmrc</literal
>. Se se sentir bem a usar a ferramenta gráfica de configuração, não existe a necessidade de ler mais nada.</para>

<!-- ** nac: updated KDM keys list from code of 2000-06-06 -->

<para
>Existem quatro secções no <literal
>kdmrc</literal
>:</para>

<sect1 id="KDM">
<title
>KDM</title>
<para
>A chaves desta secção são:</para>
<screen
>StdFont
FailFont
GreetFont
GreetString
SessionTypes
LogoArea
LogoPixmap
ShutdownButton
Shutdown
Restart
ConsoleMode
UserView
Users
NoUsers
SortUsers
GUIStyle
</screen>

<para
>Uma curta descrição das chaves:</para>
<variablelist
> <varlistentry
> <term
><parameter
>*Font</parameter
></term
> <listitem
><para
>Um identificador de tipo de letra formatado da seguinte forma: Courier,12,5,iso-8859-1,50,0.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>GreetString</parameter
></term
> <listitem
><para
>O título da janela de autenticação do &kdm;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>SessionTypes</parameter
></term
> <listitem
><para
>Uma lista separada por vírgulas de argumentos da sessão, usados normalmente para seleccionar um gestor de janelas em particular. Por omissão, é ugual a <option
>SessionTypes=kde,failsafe</option
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>LogoArea</parameter
></term
> <listitem
><para
>Controla o que aparece na parte inferior esquerda da janela de autenticação. Tanto poderá ser <option
>KdmLogo</option
> (em que, nesse caso, a imagem indicada em <option
>LogoPixMap</option
> é apresentada) ou <option
>KdmClock</option
> (em quye aparece um relógio neste caso).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>LogoPixmap</parameter
></term
> <listitem
><para
>Especifica a imagem a mostrar na parte inferior esquerda da janela de autenticação quando o LogoArea=KdmLogo.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>ShutdownButton</parameter
></term
> <listitem
><para
>O ShutdownButton controla quando o botão de Desligar é mostrado e poderá corresponder a um dos valores <option
>All</option
>, <option
>None</option
>, <option
>RootOnly</option
> e <option
>ConsoleOnly</option
>. O significado de <option
>All</option
> e de <option
>None</option
> é bastante claro. Se escolher o <option
>ConsoleOnly</option
> não poderá mais fazer uma terminação remota. Se escolher o <option
>RootOnly</option
> ser-lhe-á pedida a senha do 'root' antes de prosseguir a finalização.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Desligar e Reiniciar</parameter
></term
> <listitem
><para
>Os comandos para desligar o sistema ou para o reiniciar, respectivamente. (Por omissão: <command
>/sbin/halt</command
> e <command
>/sbin/reboot</command
>, respectivamente).</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>ConsoleMode</parameter
></term
> <listitem
><para
>O texto do comando usado na opção Modo de Consola do botão "<guibutton
>Terminar</guibutton
>". (Por omissão: <command
>/sbin/init <option
>3</option
></command
>). Esta opção não está disponível no BSD.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>UserView</parameter
></term
> <listitem
><para
>Se este valor for igual a "<option
>1</option
>", ter-se-á uma visualização gráfica dos utilizadores na janela do &kdm;.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Users</parameter
></term
> <listitem
><para
>Uma lista separada por vírgulas dos utilizadores que estarão visíveis na janela gráfica dos utilizadores. Se o <parameter
>UserView</parameter
> for igual a "<replaceable
>1</replaceable
>" e o campo <parameter
>Users</parameter
> não existir, o &kdm; irá procurar os utilizadores no ficheiro de senhas <filename
>/etc/passwd</filename
>. Os utilizadores visíveis serão aqueles que têm um nome real, para além do seu nome de utilizador, uma directoria e uma linha de comandos por omissão - todos os outros serão ignorados. O &kdm; irá procurar em <filename
>$KDEDIR/share/apps/kdm/pics/users/</filename
> por um ícone para cada utilizador. Se existir um ícone chamado <filename
>ze.png</filename
>, o &kdm; irá usá-lo para mostrar o utilizador 'ze'. Caso contrário, o &kdm; irá usar o <filename
>default.png</filename
>. </para
> <para
>O &kdm; é capaz de lidar com ficheiros de vários tamanhos, contudo o resultado fica confuso. A solução para isso será usar uma aplicação como o <application
>Pixie</application
> do KDE ou o GNU Image Manipulation Program, (<application
>gimp</application
>) ou até o <application
>XV</application
> do John Bradley para converter todas as suas imagens para o mesmo tamanho. Uma dimensão de 64x64 deve dar uma resolução suficiente e corresponde ao tamanho dos ícones oferecidos por omissão. Estes programas também poderão ser usados para converter as imagens dos vários formatos para o PNG.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>NoUsers</parameter
></term
> <listitem
><para
>Uma lista separada por vírgulas de utilizadores que não estarão visíveis. Use-a para filtrar os "pseudo-utilizadores" como o <literal
>sync</literal
> e o <literal
>shutdown</literal
> da janela dos utilizadores.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>SortUsers</parameter
></term
> <listitem
><para
>Se for igual a "<option
>0</option
>", a lista dos utilizadores é visualizada na ordem em que foi lida. A opção predefinida é mostrar os utilizadores por ordem.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>GUIStyle</parameter
></term
> <listitem
><para
>Pode ser <option
>Motif</option
> ou <option
>Windows</option
>.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="KDMDESKTOP">
<title
>KDMDESKTOP</title>

<para
>Esta secção é obsoleta. Nas versões anteriores do &kdm; podia ser usada para controlar o ecrã de fundo antes da autenticação. A configuração gráfica do &kdm; poderá ainda gerar esta secção, mas é ignorada pelo do &kdm;.</para>

</sect1>

<sect1 id="Locale">
<title
>Locale</title
> 

<para
>Esta secção é tratada por uma biblioteca padrão do KDE. Os únicos campos que poderão ter algum efeito são:</para>

<screen
>Country
Language
Charset
</screen>

<para
>Uma curta descrição das chaves:</para>

<variablelist
> <varlistentry
> <term
><parameter
>Country</parameter
></term
> <listitem
><para
>Indica o país. Veja em <filename
>$KDEDIR/share/locale/l10n</filename
> a lista completa dos códigos de países suportados pelo seu sistema. O código do país é usado para localizar o ficheiro <filename
>$KDEDIR/share/locale/l10n/codigo_pais/entry.desktop</filename
> que é usado para mostrar a informação específica da localização como o formato das horas e das datas, assim como o símbolo monetário local.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Language</parameter
></term
> <listitem
><para
>Indica a língua a usar para o &kdm; (por omissão: <option
>C</option
>, o que representa o Inglês dos EUA). O valor poderá ser sobreposto pela variável de ambiente <envar
>KDE_LANG</envar
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>Charset</parameter
></term
> <listitem
> <para
>indica o conjunto de caracteres a usar (por omissão: <option
>iso-8859-1</option
>).</para
></listitem
> </varlistentry
> </variablelist>

<note
><para
>Se mudar a opção mas todo o texto permanecer em inglês, isto significa provavelmente que o utilizador não tem as traduções instaladas no seu sistema.</para
></note>

</sect1>

<sect1 id="Lilo">
<title
><application
>Lilo</application
></title
> 
<para
>O <application
>LILO</application
> (Linux Loader) é um gestor de arranque é vulgarmente utilizado nos sistemas GNU/Linux. O LILO vem com uma documentação extensa (veja em <ulink url="man:lilo"
>man lilo</ulink
> para começar). Esta secção configura os mecanismos para reiniciar o sistema usando o <application
>LILO</application
>. As opções são:</para>

<screen>
Lilo
LiloCommand
LiloMap
</screen>

<para
>Uma curta descrição das chaves: </para>

<variablelist
> <varlistentry
> <term
><parameter
>Lilo</parameter
></term
> <listitem
><para
>Controla se o <application
>LILO</application
> é usado para reiniciar o sistema (por omissão: <option
>FALSE</option
>). Quando esta opção está configurada como <option
>TRUE</option
>, a janela de finalização passa a conter uma lista de configuração extra ao lado do botão "reiniciar". A lista permite-lhe escolher a imagem do 'kernel' que deverá ser usada ao reiniciar o sistema. A lista de imagens é criada ao analisar o ficheiro 'map' do LILO.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>LiloCommand</parameter
></term
> <listitem
> <para
>A localização do executável do <application
>LILO</application
> (por omissão: <filename
>/sbin/lilo</filename
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
><parameter
>LiloMap</parameter
></term
> <listitem
><para
>A localização do ficheiro 'map' do <application
>LILO</application
>. O ficheiro 'map' é gerido pelo <application
>LILO</application
> e contém uma lista dos 'kernels' (versões do sistema operativo) a arrancar (por omissão: <filename
>/boot/map</filename
>).</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

</chapter>

<!-- ************************************************************ -->   
<chapter id="Configuring-your-system-for-kdm">
<title
>Configurar o sistema para utilizar o &kdm;</title>

<para
>Este capítulo assume que o seu sistema já está configurado para iniciar o X Window System e que só necessita de o reconfigurar para permitir a autenticação gráfica.</para>

<sect1 id="setting-up-kdm">
<title
>Configurar o &kdm;</title>

<para
>O factor fundamental que controla se o seu computador arranca para uma mensagem do terminal (modo consola) ou para uma ambiente gráfico é o 'runlevel' por omissão. O 'runlevel' é definido pelo programa <application
> <ulink url="man:init"
>/sbin/init</ulink
></application
> segundo o controlo do ficheiro de configuração <filename
>/etc/inittab</filename
>. Os 'runlevels' por omissão que são usados pelos diferentes sistemas Unix (e pelas diferentes distribuições do Linux) variam mas, se olhar para o ficheiro <filename
>/etc/inittab</filename
>, o início do mesmo deverá ser algo do género:</para>

<screen
># 'Runlevel' por omissão. Os 'runlevels' usados pelo RHS são:
# 0 - desligar (NÃO configure o 'initdefault' para isto)
# 1 - Modo mono-utilizador
# 2 - Multi-utilizador sem NFS
# 3 - Multi-utilizador completo
# 4 - não usado
# 5 - X11
# 6 - reiniciar (NÃO configure o 'initdefault' para isto)

id:3:initdefault:  
</screen>

<para
>Todas as linhas excepto a último deste excerto são comentários (aqui traduzidos para facilitar a compreensão). Os comentários indicam que o 'runlevel' 5 é usado para o X11 e que o 'runlevel' 3 é usado para o modo multi-utilizador sem o X11 (modo de consola). A última linha indica que o 'runlevel' por omissão do sistema é o 3 (modo de consola). Se o seu sistema usar actualmente a autenticação gráfica (por exemplo através do <application
>xdm</application
>), o seu 'runlevel' por omissão irá corresponder ao especificado para o X11.</para>

<para
>O 'runlevel' com a autenticação gráfica (<application
>xdm</application
>) para algumas das distribuições comuns do Linux é:</para>

<itemizedlist
> <listitem
><para
>5 no Red Hat 3.x e posteriores, e no Mandrake</para
></listitem
> <listitem
><para
>4 no Slackware</para
></listitem
> <listitem
><para
>3 no S.u.S.E. 4.x e 5.x</para
></listitem
> </itemizedlist>

<para
>O primeiro passo na configuração do seu sistema é a garantia de que pode iniciar o &kdm; a partir da linha de comandos. Logo que isto esteja a funcionar, pode alterar a configuração do seu sistema de modo a que o &kdm; se inicie automaticamente de cada vez que reinicia o seu sistema.</para>

<para
>Para testar o &kdm;, deverá passar primeiro o seu sistema para um 'runlevel' que não arranque o <application
>xdm</application
>. Para o fazer, indique um comando como o seguinte:</para>

<screen
><command
>/sbin/init <option
>3</option
></command>
</screen>

<para
>Em vez do número "<option
>3</option
>" deverá especificar o 'runlevel' apropriado para o modo de consola no seu sistema.</para>

<para
>De seguida, deverá localizar a directoria de configuração do seu <application
>xdm</application
>; normalmente é a <filename
>/etc/X11/xdm/</filename
> ou a <filename
>/usr/X11R6/lib/X11/xdm/</filename
>. A directoria de configuração contém o ficheiro <filename
>Xsetup_0</filename
>. Se compilar o &kdm; a partir do código-fonte e o <filename
>configure</filename
> não conseguir encontrar esta directoria, ele irá instalar uma nova versão do <filename
>Xsetup_0</filename
> a partir de um ficheiro de modelo na directoria do código do &kdm;. O utilizador poderá incluir a linha:</para
> 

<screen
>kdmdesktop</screen>

<!-- ** nac: TODO 14Jul2000 not sure whether kdmdesktop still works.
     ** The binary still exists; it is built in kdebase/kdesktop but it
     ** doesn't use the kdmrc file; from the source code it seems to read
     ** the kdmdesktoprc file, which does not exist -->

<para
>Um programa para mostrar alguns fundos interessantes (imagens e cores de fundo). (Não é certo se isto ainda funciona; talvez não seja necessário). Se o seu <envar
>KDEDIR</envar
> não for igual a <filename
>/opt/kde</filename
> terá de alterar a localização do <filename
>kdmdesktop</filename
>.</para>

<para
>Se o seu sistema utiliza Pluggable Authentication Modules (<abbrev
>PAM</abbrev
>), o que é normal nas distribuições recentes da Red Hat e da Mandrake, deverá verificar se a sua configuração do <abbrev
>PAM</abbrev
> lhe permite autenticar-se através do serviço <literal
>xdm</literal
>. Se usou anteriormente o <application
>xdm</application
> com sucesso, não deverá ter de efectuar nenhumas alterações à sua configuração do <abbrev
>PAM</abbrev
> para usar o &kdm;, a qual se encontra em <filename
>/etc/pam.conf</filename
> ou <filename
>/etc/pam.d/xdm</filename
>. Nais informações sobre a configuração do <abbrev
>PAM</abbrev
> estão fora do âmbito deste manual, mas o <abbrev
>PAM</abbrev
> vem com alguma documentação compreensível (tente ver em <filename
>/usr/doc/pam*/html</filename
>).</para>

<para
>Agora é a altura de testar o &kdm;, indicando o seguinte comando:</para>

<screen
><command
>kdm <option
>-nodaemon</option
></command>
</screen>

<para
>Se obtiver uma janela de autenticação e se conseguir autenticar-se, as coisas estão a correr bem. O factor principal que poderá falhar aqui será o facto do &kdm; não encontrar as bibliotecas dinâmicas do Qt ou do KDE. Se tiver uma distribuição binária das bibliotecas do KDE, certifique-se que o &kdm; está instalado no mesmo sítio que as bibliotecas assumem que este esteja de facto (normalmente em <filename
>/opt/kde/bin</filename
>) e tente alterar algumas das variáveis de ambiente para apontar para as bibliotecas do KDE e do Qt. Por exemplo:</para>

<screen
><command
>export 
<option
>KDEDIR=<replaceable
>/opt/kde</replaceable
></option
></command>
<command
>export 
<option
>QTDIR=<replaceable
>/usr/lib/qt2</replaceable
></option
></command>
<command
>export 
<option
>PATH=<replaceable
>$KDEDIR/bin:$QTDIR/bin:$PATH</replaceable
></option
></command>
<command
>export 
<option
>LD_LIBRARY_PATH=<replaceable
>$KDEDIR/lib:$QTDIR/lib</replaceable
></option
></command>
</screen>

<para
>Se mesmo assim não tiver sucesso, tente iniciar o <application
>xdm</application
> em alternativa, para confirmar se não não está a passar por um problema de configuração mais sério do X.</para>

<para
>Quando for capaz de iniciar o &kdm; com sucesso, poderá começar a substituir o <application
>xdm</application
> pelo &kdm;. Mais uma vez, isto é dependente da distribuição.</para>

<itemizedlist
> <listitem
><para
>No caso da Redhat, edite o <filename
>/etc/inittab</filename
>, veja a sequência 'xdm' e substitua-a pelo &kdm; (incluindo todas as directorias).</para
></listitem
> <listitem
><para
>Para o Mandrake, o 'runlevel' do X11 no ficheiro <filename
>/etc/inittab</filename
> invoca o 'shell script' <filename
>/etc/X11/prefdm</filename
>, que é configurado para poder escolher vários gestores gráficos de autenticação, incluindo o &kdm;. Certifique-se que todas as localizações estão correctas na sua instalação.</para
> </listitem
> <listitem
><para
>No caso da <abbrev
>S.u.S.E</abbrev
>, edite o <filename
>/sbin/init.d/xdm</filename
> para adicionar uma linha inicial:</para
> <screen
>. /etc/rc.config
DISPLAYMANAGER=kdm
export DISPLAYMANAGER
</screen
> </listitem
> <listitem
><para
>Grande parte das outras distribuições são uma variação destas.</para
></listitem
> </itemizedlist>

<para
>Se não quiser alterar o <filename
>inittab</filename
>, a alternativa será mudar o nome do <filename
>xdm</filename
> para <filename
>xdm.bak</filename
> e tornar o <filename
>xdm</filename
> uma ligação simbólica para o &kdm;.</para>

<para
>Nesta altura, o utilizador poderá testar de novo o &kdm;, passando o seu sistema para o 'runlevel' que deverá executar o &kdm;. Para o fazer, invoque um comando do tipo:</para>

<screen
><command
>/sbin/init <option
>5</option
></command>
</screen>

<para
>Em vez do número "<option
>5</option
>" deverá indicar o 'runlevel' apropriado para correr o X11 no seu sistema.</para>

<para
>O passo final é editar o campo <parameter
>initdefault</parameter
> no ficheiro <filename
>/etc/inittab</filename
> para especificar o 'runlevel' apropriado para o X11.</para>

<warning
><para
>Antes de efectuar esta alteração, certifique-se que tem uma forma de reiniciar o seu sistema se ocorrer algum problema. Esta poderá ser uma disquete de "emergência" oferecida pela distribuição do seu sistema operativo ou uma disquete de "emergência" feita à medida, como a <literal
>tomsrtbt</literal
>. Ignore este conselho por sua conta e risco.</para
></warning
> 

<para
>Quando reiniciar o seu sistema, deverá chegar à autenticação gráfica do &kdm;.</para>

<para
>Se este passo não tiver sucesso, o problema possível será que a o ambiente usado durante a altura do arranque difere do ambiente que usou para testar na linha de comandos. Verifique os ficheiros como o <filename
>/etc/X11/xdm/Xsetup_0</filename
> (e todos os programas que ele invoca) para se certificar que a sua PATH não é alterada sem o seu conhecimento. Se está a tentar que duas versões do KDE coexistam, tenha um especial cuidado com as configurações que fizer das suas variáveis de ambiente <envar
>PATH</envar
> e <envar
>LD_LIBRARY_PATH</envar
>, de modo a que sejam consistentes e que os programas de arranque não as modifiquem de alguma forma.</para>

</sect1>

<sect1 id="different-window-managers-with-kdm">
<title
>Suportar vários gestores de janelas</title>

<para
>A janela principal do &kdm; inclui uma lista "<guilabel
>tipo de sessão</guilabel
>", a qual lhe permite escolher um gestor de janelas para a sua sessão. Este capítulo descreve as alterações que deverá fazer aos seus ficheiros de configuração para suportar esta funcionalidade.</para>

<para
>As opções que aparecem na lista "<guilabel
>tipo de sessão</guilabel
>" são <ulink url="KDM"
>configuradas</ulink
> pelos campos da secção <literal
>KDM</literal
> do ficheiro <filename
>kdmrc</filename
>.</para
> 

<para
>Quando se autentica no &kdm;, o programa <filename
>Xsession</filename
> é executado. O tipo de sessão que seleccionar é passado como um argumento da linha de comandos. (O <filename
>Xsession</filename
> poderá ser encontrado em <filename
>/etc/X11/xdm/</filename
> no caso da Redhat e da Mandrake, e em <filename
>/usr/X11R6/lib/X11/xdm/</filename
> no S.u.S.E.). Com o intuito de depuração, poderá achar útil adicionar esta linha ao ficheiro <filename
>Xsession</filename
>:</para>
      
<screen
>echo "$0 || $1 || $2" 
> $HOME/.Xsession_args </screen>

<para
>A forma como prossegue agora depende de como o seu sistema inicia normalmente os gestores de janelas. Aqui estão duas abordagens diferentes, com exemplos das alterações que precisa de fazer:</para>

<itemizedlist
> <listitem
><para
>O gestor de janelas é iniciado através de comandos dentro do <filename
>Xsession</filename
>. Neste caso, poderá adicionar uma instrução do 'case' para iniciar o gestor de janelas apropriado. O Linux Mandrake utiliza esta aproximação; aqui temos um excerto do <filename
>Xsession</filename
>:</para
> <screen
># agora, pode-se ver se o xdm/gdm/kdm pediu um ambiente específico
case $# in
1)
    case $1 in
        kde)
        source /opt/kde2/bin/kde1
        exec startkde
        ;;
        kde2)
        source /opt/kde2/bin/kde2
        exec startkde
        ;;
    	failsafe)
	exec xterm -geometry 80x24-0-0
	;;
	default)
	;;
	*)
	exec /bin/sh -c "$(/usr/sbin/chksession -x=$1)"
	;;
     esac
esac
</screen
> </listitem
> <listitem
><para
>O gestor de janelas é iniciado por outro programa que é invocado pelo <filename
>Xsession</filename
>. Neste caso, deverá garantir que o parâmetro passado ao <filename
>Xsession</filename
> é também passado para o outro programa. Por exemplo, se o gestor de janelas for iniciado com algo do género:</para
> <screen
><command
>exec <option
>$startup</option
></command
></screen
> <para
>deverá alterá-lo para:</para
> <screen
><command
>exec <option
>$startup</option
> <option
>$@</option
></command
></screen
> <para
>Depois de efectuar esta alteração, deverá analisar o seu caminho através do 'startup' para encontrar o ponto em que o gestor de janelas é iniciado. Uma das possibilidades usa o <filename
>xinitrc</filename
> para iniciar o gestor de janelas; isto permite usar o ficheiro global do sistema <filename
>/etc/X11/xinit/xinitrc</filename
> ou um ficheiro específico por utilizador <filename
>$HOME/.xinitrc</filename
>. Se editar o <filename
>$HOME/.xinitrc</filename
>, poderá querer gravar uma cópia no <filename
>/etc/skel</filename
>, para que possa ser gerada automaticamente para todas as contas de utilizadores que criar a partir daí. Este é um <filename
>xinitrc</filename
> de exemplo para um sistema que usa esta abordagem:</para
> <screen
>#!/bin/bash
#
# .xsession/.xinitrc
#
# escolher um gestor de janelas
#

defaultwm=kde
#alterar o gestor de janelas para $1 se for fornecido
windowmgr=${1:-$defaultwm}

#iniciar os gestores de janelas respectivos
case ${windowmgr} in
  kde|kwm|kdestart)
	WINDOWMANAGER=startkde
	;;
  fvwm|fvwm2)
	WINDOWMANAGER=fvwm2
	;;

  fvwm95)
	WINDOWMANAGER=fvwm95
	;;

  *)    WINDOWMANAGER=windowmgr   # predefinido para os gestores desconhecidos

esac

#
# carregar os recursos
#

if [ -f /usr/X11R6/lib/X11/Xmodmap ]; then
    xmodmap /usr/X11R6/lib/X11/Xmodmap
fi

if [ -f ~/.Xmodmap ]; then
    xmodmap ~/.Xmodmap
fi

if [ -f ~/.Xdefaults ]; then
    xrdb -merge ~/.Xdefaults
fi

if [ -f ~/.Xresources ]; then
    xrdb -merge ~/.Xresources
fi
# 
# iniciar finalmente o gestor de janelas
#
exec $WINDOWMANAGER
</screen
> </listitem
> </itemizedlist>


</sect1>
</chapter>

<!-- *********************************************************************** -->
<chapter id="Building-and-Installing-kdm">
<title
>Compilar e Instalar o kdm</title>

<para
>O &kdm; faz parte do projecto do KDE. As várias componentes do KDE estão divididas em secções, denominadas de pacotes. O &kdm; faz parte do pacote chamado 'kdebase'. Poderá obter o código-fonte do KDE a partir de vários CDs de distribuições de Linux e de BSD ou em <ulink url="http://www.kde.org"
>www.kde.org</ulink
> ou nos seus 'sites' alternativos ('mirrors'). Se tiver uma estrutura de código desactualizada, poderá usar um dos servidores 'cvsup' do KDE para o actualizar, mantendo à mesma uma largura de banda pequena. </para>

<para
>Antes de compilar o 'kdebase', precisa ter compilada e instalada (por esta ordem), a versão 3 da biblioteca do Qt e os pacotes do KDE 'kde-qt-addon', 'kdesupport' e 'kdelibs'.</para>

<para
>Para compilar qualquer um dos anteriormente descrito, deverá já ter o X Window System instalado, em conjunto com um compilador de C++ e as ferramentas de configuração da GNU <application
>configure</application
>, <application
>automake</application
> e <application
>autoconf</application
>.</para>

<para
>Se os últimos parágrafos lhe soaram a uma língua estrangeira, ou o uti lizador entrou por uma área inapropriada deste manual ou está prestes a entrar numa grande experiência de aprendizagem.</para>

<para
>Se conseguiu satisfazer todos os pré-requisitos, então não deverá ter nenhum problema ao compilar e instalar o 'kdebase'. O &kdm; está instalado na sua directoria "<filename
>$KDEDIR/bin</filename
>".</para>

<note
><para
>O <command
>make <option
>install</option
></command
> irá sobrepor o seu <filename
>kdmrc</filename
> anterior.</para
></note>

</chapter>


<!-- *********************************************************************** -->
<chapter id="Other-Information">
<title
>Outras fontes de informação</title>

<para
>Dado que o &kdm; descende do <application
>xdm</application
>, a <ulink url="man:xdm"
>página de man do xdm</ulink
> poderá dar mais algumas informações adicionais. Para os problemas relacionados com o X tente ver as páginas do 'man' <ulink url="man:X"
>X</ulink
> e do <ulink url="man:startx"
>startx</ulink
>. Se tiver dúvidas acerca do &kdm; que não sejam respondidas por este manual, tire partido do facto que o &kdm; é distribuído segundo os termos da <abbrev
>GNU</abbrev
>gnu
> Public License: veja o código-fonte. </para>

</chapter>

<!-- *********************************************************************** -->
<chapter id="credits"
><title
>Créditos e Licença</title>

<para
>O &kdm; deriva ou inclui código do <application
>xdm</application
>.</para>

<para
>O &kdm; 0.1 foi feito pelo Matthias Ettrich. Todas as versões posteriores foram feitas pelo Steffen Hansen.</para>

<para
>O <application
>Xdm</application
> tem o 'copyright' (c) 1990 do X Consortium.</para>

<para
>Todas as partes do código do &kdm; tem o 'copyright' dos autores e estão licenciadas segundo os termos da <ulink url="common/gpl-license.html"
>GPL da GNU</ulink
>. Todos os que estiverem interessados, podem alterar o &kdm; e redistribuir o resultado desde que os nomes dos autores sejam mencionados.</para>

<para
>O &kdm; necessita da biblioteca Qt, a qual tem o 'copyright' da Troll Tech AS.</para>

<para
>Contributos para a documentação: <itemizedlist
> <listitem
><para
>Documentação escrita por Steffen Hansen <email
>stefh@dit.ou.dk</email
></para
></listitem
> <listitem
><para
>Documentação extendida por Gregor Zumstein<email
>zumstein@ssd.ethz.ch</email
>. Última actualização em 09/07/1998</para
></listitem
> <listitem
><para
>Documentação revista para o KDE2 por Neal Crook<email
>nac@forth.org</email
>. Última actualização em 06/07/2000</para
></listitem
> </itemizedlist
></para>

<para
>Documentação copyright Steffen Hansen, Gregor Zumstein e Neal Crook.</para>

<para
>Tradução de José Nuno Coelho Pires <email
>jncp@netcabo.pt</email
></para>

&underFDL;
&underGPL;

</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

