&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].