&kdmrc;

5 6 de Março de 2003 man5 versão Direitos de cópia para o KDE

&kdmrc;

O Arquivo de Configuração do &kdm;

## Comentários Gerais sobre o &kdmrc;

O formato básico do arquivo é estilo-INI. Opções ou chaves possuem um nome e um valor, separados por um `=`, colocadas em seções. Chaves somente são válidas nas seções para a qual elas foram definidas, e não se aplicarão (e nenhum erro fatal será reportado) se elas forem colocadas incorretamente. Algumas chaves não se aplicam a determinados terminais, sendo neste caso ignoradas.

O formato para todas as chaves é ```chave``=`valor``. O nome da chave é sensível à caixa. Seções são indicadas por `[`Nome da Seção`]`. Linhas iniciando com `#` são comentários.

Você pode configurar cada terminal X individualmente.

Cada terminal possui um nome de terminal, que consiste de um nome de máquina (que é vazio para terminais locais especificados no arquivo Xservers), dois pontos e um número de terminal. Adicionalmente, um terminal pertence à uma classe de terminais (que pode ser ignorada na maioria dos casos; o centro de controle nem sempre suporta este recurso).

Seções com configurações específicas por termina possuem a sintaxe formal [X-" máquina [":" número [ "_" classe ]] "-" sub-seção "]

Você pode usar o coringa `*` para a máquina, número e classe. Você pode omitir componentes da sintaxe; eles então serão assumidos como *. A parte máquina deve ser uma especificação de domínio como .maquina.dominio.br.

A partir de qual seção uma configuração é obtida é determinado pelas seguintes regras:

Uma correspondência exata tem precedência sobre uma correspondência parcial (para a parte máquina), que tem precedência sobre um coringa.

A precedência diminui da esquerda para direita nas correspondências exatas.

## Exemplo: nome do terminal "minhamaquina:0", classe "dpy"

- [X-minhamaquina:0_dpy] precede

- [X-minhamaquina:0_*] (o mesmo que [X-minhamaquina:0]) que precede

- [X-minhamaquina:*_dpy] que precede

- [X-minhamaquina:*_*] (o mesmo que [X-minhamaquina]) que precede

- [X-*:0_dpy] que precede

- [X-*:0_*] (o mesmo que [X-*:0]) que precede

- [X-*:*_*] (o mesmo que [X-*])

Estas seções NÃO correspondem com este terminal:

[X-suamáquina], [X-minhamáquina:0_dec], [X-*:1], [X-:*]

Se uma configuração não for encontrada em nenhuma seção correspondente, o padrão é usado.

O &kdmrc; é totalmente comentado, e esta documentação é baseada nestes comentários. Cada comentário se aplica a seção ou chave que o segue.

Todos os comentários serão perdidos se você mudar este arquivo com o módulo do kcontrol. Os padrões referem-se a valores embutidos no &kdm;. Valores configurados no &kdmrc; sobrepõem-se aos padrões, e você não precisa configurar todas as chaves se seus padrões já atendem às suas necessidades.

## General

A seção `[General]` contém a maioria das opções globais, e se aplicará à todas as instâncias do &kdm; e em todos os terminais.

`Xservers`

- Se o valor inicia com uma barra (`/`), esta chave especifica o arquivo onde os Servidores X a serem usados pelo &kdm; estão listados. O arquivo está no formato usual do Xservers do &xdm;. Se o valor não iniciar com uma barra, esta chave é interpretada com se fosse uma linha simples do arquivo Xservers, &ie; ela especifica exatamente um servidor X.

  O valor padrão é `:0 local /usr/X11R6/bin/X`

  Durante a instalação, o &kdm; tentará preencher um caminho para um arquivo `Xservers` existente se ele puder encontrá-lo.

`PidFile`

- Onde o &kdm; deve armazenar seu PID. O padrão é deixar esta chave vazia, o que significa que ele não armazena. Você pode desejar configurar, ao invés do padrão, um caminho completo, por exemplo `/var/run/xdm.pid` de modo que você possa verificar com um script se o &kdm; está em execução ou não.

`LockPidFile`

- Se o &kdm; deve travar o arquivo PID para evitar que existam múltiplas instâncias do &kdm; se executando ao mesmo tempo. Deixo isto como true, a menos que seja corajoso. Isto não terá nenhum efeito a menos que você configure o `PidFile` primeiro.

`AuthDir`

- Onde armazenar os arquivos de autorização. O padrão é `/var/run/xauth`.

`AutoRescan`

- Se o &kdm; deve automaticamente reler os arquivos de configuração, se ele descobrir que eles mudaram. O padrão é true, e você provavelmente não precisará mudá-lo.

`ExportList`

- Variáveis de ambiente adicionais para passar para o &kdm; além de `kdm_config`, `kdm_greet`, `Xsetup`, `Xstartup`, `Xsession` e `Xreset`.

  Uma boa candidata é `LD_LIBRARY_PATH`. O formato é:

      ExportList=SOME_VAR,ANOTHER_IMPORTANT_VAR

`RandomFile`

- De onde o &kdm; deve buscar entropia. O padrão é `/dev/men`. Você não precisa mudar isto.

`FifoDir`

- Onde os comandos FiFos devem ser criados. Deixe isto vazio para desabilitar FiFos. O padrão é `/var/run/xdmctl`

`FifoGroup`

- À qual grupo os comandos FiFos devem pertencer. O padrão é `-1`, efetivamente `root`.

`ConfigVersion`

- Esta opção existe somente para fins de atualizações automáticas. Não mude-a, ou você pode interferir com atualizações futuras e isto pode resultar numa falha na execução do &kdm;.

## Xdmcp

Esta seção configura o login remoto via &XDMCP;.

## Chaves para a Seção [Xdmcp] do &kdmrc;

`Enable`

- Se o &kdm; deve ouvir as solicitações &XDMCP;. O padrão é `true`

`Port`

- A porta UDP que o &kdm; deve ouvir as solicitações &XDMCP;. O padrão é `177` e isto não deve ser mudado.

`KeyFile`

- Arquivo com as chaves privadas para terminais X. Necessário para autenticação &xdm;. O padrão é deixar esta chave vazia.

`Xaccess`

- Arquivo de controle de acesso &XDMCP;, no formato usual do `Xaccess` do &xdm;.

  O padrão é o arquivo nomeado Xaccess na mesma pasta do &kdmrc;. Você pode colocar o caminho para seu arquivo `Xaccess` do &xdm; aqui.

`ChoiceTimeout`

- Número de segundos a esperar pela resposta do terminal após o usuário ter selecionado uma máquina a partir do selecionador. O valor padrão é `15`

`RemoveDomainname`

- Retirar o nome de domínio dos nomes de terminais remotos, se ele for igual ao do domínio local. O padrão é `true`.

`SourceAddress`

- Usar endereço IP numérico da conexão de entrada do nome da máquina. Use isto em máquinas com múltiplos nomes. O padrão é `false`.

`Willing`

- O programa que é invocado para gerar dinamicamente respostas às solicitações de consulta de Difusão &XDMCP;.

  Por padrão, nenhum programa é invocado, e Pronto para gerenciar é enviado em resposta.

  Você pode colocar um caminho completo aqui para um `Xwilling` existente se você já possui um configurado.

## Shutdown

## Chaves para a Seção [Shutdown] do &kdmrc;

`HaltCmd`

- O comando à executar para parar o sistema. O padrão é `/sbin/shutdown` `-h` `now`

`RebootCmd`

- O comando a executar para reiniciar o sistema. O padrão é `/sbin/shutdown` `-r` `now`

`AllowFifo`

- Se alguém pode desligar o sistema através do comando global FiFo

  O padrão é `False`.

`AllowFifoNow`

- Se alguém pode abortar sessões ainda existentes ao desligar o sistema através do comando global FiFo.

  O padrão é `true`.

  Isto não terá efeito a menos que você tenha previamente configurado a chave `AllowFifo`.

## X-*-Core

Configuração básica para todos os terminais. Tempos são especificados em segundos a menos que notado de outra maneira.

Algumas estimativas aproximadas de quantos segundos o &kdm; gasta para realizar determinadas ações:

Abrir um conexão ao &X-Server; (OpenTime)

- `OpenRepeat` * (`OpenTimeout` + `OpenDelay`)

Iniciar um &X-Server; local (ServerTime)

- `ServerAttempts` * `ServerTimeout`

Iniciar um terminal local

- `StartAttempts` * (ServerTime + OpenTime)

Iniciar um terminal remoto

- `StartAttempts` * OpenTime

## Chaves para a Seção [X-*-Core] do &kdmrc;

`OpenDelay`

- Quanto tempo esperar após vários erros antes de tentar novamente iniciar o terminal. O padrão é `15`.

`OpenTimeout`

- Quanto tempo antes de expirar o XOpenDisplay. O padrão é `120`.

`OpenRepeat`

- Qual a freqüência de teste do XOpenDisplay. O padrão é 5.

`StartAttempts`

- Tentativas para iniciar um terminal. Se isto falhar, o terminal é desabilitado. O padrão é `4`.

`StartInterval`

- O contador `StartAttempt` é reiniciado após esta quantidade de segundos. O padrão é `30`.

`PingInterval`

- Pinga o terminal remoto a cada quantos minutos. O padrão é `5`

`PingTimeout`

- Espera este tempo por uma resposta ao ping. O padrão é `5`.

`TerminateServer`

- Reinicia ao invés de restaurar o &X-Server; local após sair da sessão. Use isto se você achar que o servidor está desperdiçando memória ou então não esteja liberando recursos. O padrão é `False`.

`ResetSignal`

- O sinal necessário para restaurar o &X-Server; local. O padrão é `1` que é o `SIGHUP`.

`TermSignal`

- O sinal necessário para terminar o &X-Server; local. O padrão é `15` que é o `SIGTERM`.

`ResetForAuth`

- Configure se for necessário reiniciar o &X-Server; para fazê-lo ler o arquivo `Xauth` inicial.

  O padrão é false

`Authorize`

- Cria autorizações X para terminais locais. O padrão é true.

`AuthName`

- Que mecanismo de autorização X deve ser usado.

  O padrão é `XDM-AUTHORIZATION-1,MIT-MAGIC-COOKIE-1` e você deve ser muito cauteloso ao mudá-lo a menos que você saiba exatamente o que você está fazendo.

`AuthFile`

- O nome do arquivo `Xauth` do &X-Server;. O padrão é deixar a chave vazia, o que significa que um nome aleatório no `AuthDir` será usado.

`Resources`

- Especifica um arquivo com recursos X para o saudador, selecionador e fundo. O frontend do &kde; não toma conhecimento disto, de mod que você não precisa disto a menos que você use um selecionador alternativo ou outro gerador de fundo que não seja o `kdmdesktop`

`Xrdb`

- O programa `xrdb` a usar para ler os recursos acima especificados. O padrão é `/usr/X11R6/bin/xrdb`.

`Setup`

- Um programa para executar antes do saudador ser mostrado. Você pode iniciar o `kdmdesktop` aqui. Também o `xconsole` pode ser iniciado por este script. O padrão é deixar esta chave vazia.

`Startup`

- Um programa para executar antes de uma sessão com um usuário iniciar. Você pode invocar o `sessreg` aqui, e opcionalmente mudar o dono do console &etc;.

`Reset`

- Um programa para executar após uma sessão de usuário terminar. Você pode invocar o sessreg aqui e opcionalmente mudar o dono do console, &etc;.

`Session`

- O programa que deve ser executado como o usuário que se logo. Ele deve supostamente interpretar o argumento session (veja `SessionTypes`) e iniciar a sessão apropriada de acordo com ele.

  O padrão é ``/usr/X11R6/bin/xterm` `-ls` `-T``, mas se o &kdm; puder localizar um arquivo Xsession já configurado durante a instalação, o caminho para este será usado no lugar do anterior.

`FailsafeClient`

- O programa para executar se a `Sessão` falhar.

  O padrão é ``/usr/X11R6/bin/xterm``.

`UserPath`

- O `PATH` para o programa `Session`. O padrão é `/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin`

`SystemPath`

- O caminho para Setup, Startup e Reset, &etc;.

  O padrão é `/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin`.

`SystemShell`

- O shell padrão do sistema. O padrão é `/bin/sh`

`UserAuthDir`

- Onde colocar o arquivo de autorização do &X-Server; do usuário se o `~/.Xauthority` não puder ser criado. O padrão é ``/tmp``.

`AutoReLogin`

- Se `true`, o &kdm; automaticamente reiniciará uma sessão após um &X-Server; travar, ou se ele é morto pelo &Ctrl;&Alt;Delete. O padrão é `false`.

  Habilitar isto abre uma brecha na segurança: um travamento de terminal seguro pode ser explorado, a menos que você use o travamento de tela interno do &kde;.

`AllowRootLogin`

- Permite logins do `root`. O padrão é `true`.

`AllowNullPasswd`

- Permite login quando o usuário possui uma senha vazia. Padrão é `true`.

`AllowShutdown`

- Quem tem permissão de desligar o sistema. Isto se aplica tanto ao saudador como ao comando FiFo. O padrão é `All`.

  Possíveis valores são:

  `None`

- Nenhum botão Desligar... é mostrado para ninguém.

`Root`

- A senha do root deverá ser inserida para desligamento.

`All`

- Todos podem desligar a máquina.

`AllowSdForceNow`

- Quem tem permissão de abortar todas as sessões ainda existentes ao desligar a máquina. Os valores possíveis são os mesmos do `AllowShutdown`, e o padrão é `All`

`DefaultSdMode`

- A escolha padrão para condição/tempo de desligamento.

  Possíveis valores são:

  `Schedule`

- Desligamento após todas as sessões terminarem (possívelmente ao mesmo tempo). Este é o padrão.

`TryNow`

- Desligar, se nenhuma sessão estiver aberta, caso contrário não fazer nada.

`ForceNow`

- Desligar incondicionalmente.

`InteractiveSd`

- Se isto for `false`, o usuário deve selecionar a condição/tempo de desligamento diretamente no diálogo de desligamento. Se isto for `true`, ele não será questionado quanto a estas opções mas será questionado caso existe alguma sessão aberta atualmente. O padrão é `true`.

  A interação não está atualmente implementada. Se isto for configurado para true, um desligamento normal forçado ocorrerá, ignorando o valor da opção `AllowSdForceNow`!

`SessSaveFile`

- Onde,em relação a pasta pessoal do usuário, armazenar a última sessão selecionada. O padrão é `.wmrc`.

## X-*-Greeter

Configurações do Saudador para todos os terminais.

## Chaves para a seção [X-*-Greeter] do &kdmrc;

`SessionTypes`

- Tipos de sessão que o usuários podem selecionar. É aconselhável ter o `default` e `failsafe` listados aqui (isto é o padrão)

`GUIStyle`

- Estilo de widget do saudador. Disponíveis são `Default`, `Windows`, `Platinum`, `Motif`, `MotifPlus`, `CDE`, `SGI` e qualquer outro estilo que você tenha instalado, como o `Keramik` ou `HighColor`.

  O padrão é `Default`.

`ColorScheme`

- Esquema de cores para o saudador. O padrão é `Default`. Qualquer esquema de cores que você tenha instalado, como o `Pumpkin` pode ser usado aqui.

`LogoArea`

- O que deve ser mostrado ao lado das linhas de entrada.

  Os valores disponíveis são:

  `Logo`

- A imagem especificada por `LogoPixmap`. Este é o padrão

`Clock`

- Um relógio analógico

`None`

- Nothing

`LogoPixmap`

- A imagem a ser mostrada quando `LogoArea`=`Logo`. O padrão é `kdelogo.png`.

`GreeterPosFixed`

`GreeterPosX`

`GreeterPosY`

- Normalmente o saudador é centralizado na tela. Use estas opções se você deseja que ele aparece em algum lugar diferente na tela. O padrão é o `GreeterPosFixed` ser configurado para `false`, fazendo com que as duas outras opção não tenham efeito.

`GreetString`

- O título no saudador.

  Os seguintes caracteres serão substituídos pelos seus valores:

  `%d`

- Terminal atual.

`%h`

- Nome da máquina, possivelmente com o nome de domínio.

`%n`

- Nome do nó, mais provavelmente o nome da máquina sem o nome de domínio.

`%s`

- O sistema operacional

`%r`

- A versão do sistema operacional

`%m`

- O tipo da máquina (hardware)

`%%`

- Um `%` simples

O string padrão é `Welcome to %s at %n`.

`GreetFont`

- A fonte para o título. O padrão é `charter,24,bold`

`StdFont`

- A fonte normal usada no saudador. O padrão é `helvetica,12`.

`FailFont`

- A fonte usada para a mensagem de Login Failed. O padrão é `helvetica,12,bold`.

AntiAliasing

- Se as fontes mostradas no saudador devem ter o efeito de suavização. O padrão é `false`

NumLock

- O que fazer com o modificador Num Lock na hora que o saudador estiver se executando.

  `On`

- Liga o Num Lock

`Off`

- Desliga o Num Lock

`Keep`

- Não muda o estado (este é o padrão).

`Language`

- Idioma a ser usado no saudador. O padrão é `en_US`.

`ShowUsers`

- Especifica que nomes de usuário (e figuras) devem ser mostrados no saudador.

  Valores disponíveis são:

  `NotHidden`

- Todos os usuários exceto os listados em `HiddenUsers`. Este é o padrão.

`Selected`

- Somente os usuários listados em `SelectedUsers`

`None`

- Nenhuma lista de usuários será mostrada. Os usuários devem digitar um nome correto de login.

`SelectedUsers`

- Somente tem efeito se `ShowUsers` for configurado para `Selected`. Crie aqui uma lista de nomes de usuários a serem mostrados separadas por vírgula.

`HiddenUsers`

- Somente tem efeito se `ShowUsers` for configurado para `NotHidden`. Crie aqui uma lista de nomes de usuários a serem ocultados separadas por vírgula.

`MinShowID`

- Isto é um caso especial para o `HiddenUsers`. Em adição aos nomes de usuários especificados lá, usuários com um UID menor que este número (outros que não o `root`) também serão ocultos. O padrão é `0`.

`MaxShowID`

- Complementa o `MinShowID`. Usuários com uma UID maior que este número serão ocultos também. O padrão é `65535`.

`SortUsers`

- Se `false`, os usuários serão listados na ordem em que eles aparecem no `/etc/passwd`. Se `true`, eles serão ordenados alfabeticamente. O padrão é `true`.

`FaceSource`

- Especifica onde as figuras dos usuários devem ser buscadas. Valores disponíveis são:

  `AdminOnly`

- De `$`KDEDIR`/share/apps/kdm/pics/users/$`USER`.png`. Este é o padrão.

`UserOnly`

- A partir do `$`HOME`/.face` do usuário.

`PreferAdmin`

- Prefere o `$`USER`.png`, em relação ao `$`HOME`/.face`.

`PreferUser`

- O contrário do anterior.

`PreselectUser`

- Especifica se, se for o caso, um usuário deve ser pré-selecionado para login.

  Habilitar este recurso pode ser considerado uma brecha na segurança, uma vez que isto apresenta um nome de login conhecido e válido para um potencial atacante, de modo que ele somente precisa fornecer a senha.

  Valores disponíveis são:

  `None`

- Não pré-seleciona nenhum usuário. Isto é o padrão.

`Previous`

- O usuário que logou-se com sucesso por último.

`Default`

- O usuário especificado na chave `DefaultUser`.

`DefaultUser`

- O usuário pré-selecionado se `PreselectUser` for configurado para `Default`.

`FocusPasswd`

- Se isto for true, o campo de entrada de senha é automaticamente focado se um usuário for pré-selecionado. O padrão é `False`.

`EchoMode`

- O campo de entrada de senha oculta o texto digitado. Aqui você pode especificar como fazer isto:

  `NoEcho`

- Nada é mostrado. O cursor não se move.

`OneStar`

- Um `*` é mostrado para cada letra digitada. Isto é o padrão.

`ThreeStars`

- Um `***` é mostrado para cada letra digitada.

`UseBackground`

- Se true, o &kdm; configurará a imagem de fundo através do `krootimage`. Caso contrário o script `Setup` deverá ser usado para configurar a imagem de fundo. O padrão é `true`.

`BackgroundCfg`

- O arquivo de configuração usado para o `krootimage` se `UseBackground` for configurado para `true`. O padrão é ``$`KDEDIR`/share/config/kdm/backgroundrc``

`GrabServer`

- Mantém o &X-Server; retido durante todo o tempo que o saudador for visível. Isto pode ser mais seguro, mas desabilitará qualquer imagem de fundo e que outros clientes X iniciem a partir do script `Setup`. O padrão é `false`.

`GrabTimeout`

- Quantos segundos esperar para que a retenção ocorra.

`AuthComplain`

- Alerta se a autorização X local não puder ser criada. O padrão é `true`. Esta opção ainda não está implementada, logo mudá-la não terá nenhum efeito.

## X-:*-Core

Configuração principal para terminais locais.

## Chaves para a seção [X-:*-Core] do &kdmrc;

`ServerAttempts`

- O quão freqüentemente tenta executar o &X-Server;. Executando inclusões executadas por ele, e esperando pelo seu ativamento. O padrão é `1`.

`ServerTimeout`

`AllowShutdown`

`AllowRootLogin`

`AllowNullPasswd`

- O mesmo da seção [X-*-Core].

`NoPassEnable`

- Habilita logins sem senha no terminal. Use isto com extremo cuidado! O padrão é `false`.

`NoPassUsers`

- Os usuários que não precisam fornecer a senha para logar-se. Nunca liste o `root`.

## X-:*-Greeter

Configuração do Saudador para terminais locais.

## Chaves para a Seção [X-:*-Greeter] do &kdmrc;

`AuthComplain`

- As mesmas da seção [X-*-Greeter].

`GreeterScreen`

- A tela que o saudador deve mostrar em configurações múltiplas. A numeração inicia com `0` e corresponde à ordem da lista na seção ServerLayout ativa do `XF86Config`. `-1` significa usar a tela superior-esquerdo, `-2` significa usar a tela superior-direito. O padrão é `0`.

`LoginMode`

- Especifica se o saudador de terminais locais deve iniciar num modo escolhedor de máquina (remoto) ou login (local) e se ele tem permissão de alternar para outro modo.

  Valores disponíveis são:

  `LocalOnly`

- Somente o login local é possível. Este é o padrão.

`RemoteOnly`

- Somente escolha de máquinas remotas é possível.

`DefaultLocal`

- Inicia no modo local, mas permite alternar para o modo remoto.

`DefaultRemote`

- Inicia no modo remoto, mas permite alternar para o modo local.

`ChooserHosts`

- Uma lista de máquinas separadas por vírgula a ser automaticamente adicionada ao menu de login remoto. O nome especial `*` significa difusão na rede. O padrão é `*`.

## X-:0-Core

Configuração principal para apenas o primeiro terminal local.

## Chaves para a Seção [X-:0-Core] do &kdmrc;

`AutoLoginEnable`

- Habilita automaticamente o login neste terminal. Use com extremo cuidado!

`AutoLoginUser`

- O usuário para login automático. Nunca especifique o `root`.

`AutoLoginPass`

- A senha para o usuário logar-se automaticamente. Isto não é necessário a menos que o usuário seja logado num domínio NIS ou Kerberos. Se você usar esta opção, você deve fazer um ``chmod` `600` `kdmrc`` por motivos óbvios.

`AutoLoginSession`

- A sessão para o usuário logar-se automaticamente. Isto se torna menos útil após o primeiro login, uma vez que a última sessão logada terá precedência.

## X-:0-Greeter

Configuração do Saudador para o primeiro terminal local

## Chaves para a Seção [X-:0-Greeter] do &kdmrc;

`PreselectUser`

`DefaultUser`

- Estas opções são as mesmas da seção [X-*-Greeter].