LIVE-CONFIG(7) Projeto Debian Live LIVE-CONFIG(7)

NOME

live-config - Scripts para Configuração do Sistema

DESCRIÇÃO

live-config contém os scripts que configuram um sistema Debian Live durante o processo de inicialização (userspace tardio).

CONFIGURAÇÃO

live-config pode ser configurado através de parâmetros de inicialização ou arquivos de configuração. Se ambos mecanismos forem usados para uma determinada opção, os parâmetros de inicialização assumem precedência sobre os arquivos de configuração. Quando usado com persistência, os scripts live-config são executados apenas uma vez.

Parâmetros de Inicialização (scripts)

live-config é ativado apenas quando 'boot=live' é usado como parâmetro de inicialização. Adicionalmente, live-config precisa ser informado sobre quais scripts executar, através do parâmetro 'live-config', ou quais scripts não executar, através do parâmetro 'live-noconfig'. Se ambos 'live-config' e 'live-noconfig' forem usados, ou um deles for especificado múltiplas vezes, o último sempre assume precedência sobre o(s) anterior(es). live-config | config Todos os scripts são executados. Isto é o que as imagens do Debian Live usam por padrão. live-config=SCRIPT1,SCRIPT2, ... SCRIPTn | config=SCRIPT1,SCRIPT2, ... SCRIPTn Apenas os scripts especificados são executados. Note que a ordem dos scripts é relevante, por exemplo, 'live-config=sudo,user-setup' não funcionaria pois o usuário precisa ser criado antes de ser con‐ figurado para sudo. A ordem dos scripts pelos nomes dos arquivos está definida em /lib/live/config. live-noconfig | noconfig Nenhum script é executado. É o mesmo que não usar 'live-config' nem 'live-noconfig'. live-noconfig=SCRIPT1,SCRIPT2, ... SCRIPTn | noconfig=SCRIPT1,SCRIPT2, ... SCRIPTn Todos os scripts são executados, exceto os especificados.

Parâmetros de inicialização (opções)

Alguns scripts podem alterar seu comportamento através de um parâmetro de inicialização. live-config.hostname=HOSTNAME | hostname=HOSTNAME Permite configurar o hostname do sistema. O padrão é 'debian'. live-config.username=NOME_DO_USUARIO | username=NOME_DO_USUARIO Permite configurar o nome do usuário que será criado para autolo‐ gin. O padrão 'user'. live-config.user-fullname="NOME_COMPLETO_DO_USUÁRIO" | user-full‐ name="NOME_COMPLETO_DO_USUÁRIO" Permite configurar o nome completo do usuário que será criado para autologin. O padrão é 'Debian Live user'. live-config.locales=LOCALE1,LOCALE2 ... LOCALEn | locales=LOCALE1,LOCALE2 ... LOCALEn Permite configurar o locale do sistema, por exemplo, 'de_CH.UTF-8'. O padrão é 'en_US.UTF-8'. Se o locale selecionado não estiver disponível no sistema, ele é automaticamente gerado. live-config.timezone=TIMEZONE | timezone=TIMEZONE Permite configurar o timezone do sistema, por exemplo, 'Europe/Zurich'. O padrão é 'UTC'. live-config.utc=yes|no | utc=yes|no Permite definir se o sistema deve assumir que o relógio do hardware está configurado para UTC ou não. O padrão é 'yes'. live-config.keyboard-model=MODELO_DO_TECLADO | keyboard-model=MOD‐ ELO_DO_TECLADO Permite configurar o modelo do teclado. Não há valor padrão definido. live-config.keyboard-layouts=LAYOUT1_DO_TECLADO,LAYOUT2_DO_TECLADO ... LAYOUTn_DO_TECLADO | keyboard-layouts=LAYOUT1_DO_TECLADO,LAY‐ OUT2_DO_TECLADO ... LAYOUTn_DO_TECLADO Permite configurar layouts de teclado. Se mais de um layout for especificado, as ferramentas do ambiente desktop possibilitarão a troca entre eles no X11. Não há valor padrão definido. live-config.keyboard-variant=VARIANTE_DE_TECLADO | keyboard-vari‐ ant=VARIANTE_DE_TECLADO Permite configurar a variente de teclado. Não há valor padrão definido. live-config.keyboard-options=OPÇÕES_DE_TECLADO | key‐ board-options=OPÇÕES_DE_TECLADO Permite configurar as opções de teclado. Não há valor padrão definido. live-config.sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇOn | sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇOn Permite desabilitar serviços sysv através do update-rc.d. live-config.x-session-manager=GERENCIADOR_DE_SESSÕES_DO_X | x-ses‐ sion-manager=GERENCIADOR_DE_SESSÕES_DO_X Permite definir o gerenciador de sessões do X através do update-alternatives. live-config.xorg-driver=DRIVER_DO_XORG | xorg-driver=DRIVER_DO_XORG Permite definir o driver do xorg ao invés de auto-detectá-lo. live-config.xorg-resolution=RESOLUÇÃO_DO_XORG | xorg-resolution=RES‐ OLUÇÃO_DO_XORG Permite definir a resolução do xorg ao invés de auto-detectá-la. live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn | hooks=medium|filesystem|URL1|URL2| ... |URLn Permite obter e executar um ou mais arquivos arbitrários. Note que as URLs precisam ser acessíveis por wget (http, ftp ou file://), que os arquivos são executados no diretório /tmp do sistema de arquivos em execução, e que os arquivos precisam que suas dependências, se houverem, estejam instaladas. Por exemplo, se um script python deve ser executado, python deve estar instalado no sistema. Alguns hooks para alguns casos de uso comuns estão disponíveis em /usr/share/doc/live-config/examples/hooks/ e <http://live.debian.net/other/hooks>. Se o arquivo estiver na mídia live, ele pode ser obtido através de file:///live/image/FILE ou file:///FILE se estiver no sistema raiz do próprio sistema live. Todos os hooks no diretório /lib/live/hooks do sistema de arquivos raiz do sistema live podem ser automaticamente habilitados com a palavra-chave 'filesystem'. Todos os hooks no diretório /live/hooks/ da mídia live podem ser automaticamente habilitados com a palavra-chave 'medium'. Se múltiplos mecanismos são combinados, os hooks do sistema de arquivos são executados primeiro, depois os hooks da mídia, e por fim os hooks da rede.

Parâmetros de Inicialização (atalhos)

live-config provê atalhos para alguns casos de uso comuns que precis‐ ariam da combinação de diversos parâmetros. Isto possibilita uma granu‐ laridade total sobre as opções, preservando ainda sua simplicidade. live-config.noroot | noroot Desabilita o sudo e o policykit, o usuário não pode obter privilégios de root no sistema. live-config.noautologin | noautologin Desabilita o login automático do console, assim como o autologin gráfico. live-config.nottyautologin | nottyautologin Desabilita o login automático do console, não afetando o autologin gráfico. live-config.nox11autologin | nox11autologin Desabilita o login automático com qualquer gerenciador de display, não afetando o autologin tty.

Parâmetros de Inicialização (opções especiais)

Existem alguns parâmetros de inicialização especiais para alguns casos de uso especiais. live-config.debug | debug Habilita sáida de debug no live-config.

Arquivos de Configuração

live-config pode ser configurado (mas não ativado) através de arquivos de configuração. Tudo o que pode ser configurado com um parâmetro de inicialização pode também ser configurado através de um ou mais arquivos, com exceção dos atalhos. Quando arquivos de configuração são usados, o parâmetro 'boot=live' ainda é necessário para a ativação do live-config. Arquivos de configuração podem estar localizados no próprio sistema de arquivos raiz (/etc/live/config.conf, /etc/live/config.d/) ou na mídia live (live/config.conf, live/config.d/). Se ambas as localizações são usadas para determinada opção, as da mídia live assumem precedência sobre as do sistema de arquivo raiz. Apesar de os arquivos de configuração localizados nos diretórios conf.d não necessitarem de um nome ou sufixo particular, por uma questão de consistência é recomendado usar 'distribuidor.conf' ou 'projeto.conf' como esquema de nomes (onde 'distribuidor' ou 'projeto' deve ser susb‐ stituído pelo nome real, resultando num nome de arquivo como 'debian-eeepc.conf'). LIVE_CONFIGS=SCRIPT1,SCRIPT2, ... SCRIPTn Esta variável é equivalente ao parâmetro 'live-con‐ fig=SCRIPT1,SCRIPT2, ... SCRIPTn'. LIVE_NOCONFIGS=SCRIPT1,SCRIPT2, ... SCRIPTn Esta variável é equivalente ao parâmetro 'live-nocon‐ fig=SCRIPT1,SCRIPT2, ... SCRIPTn'. LIVE_HOSTNAME=HOSTNAME Esta variável é equivalente ao parâmetro 'live-config.host‐ name=HOSTNAME'. LIVE_USERNAME=USERNAME Esta variável é equivalente ao parâmetro 'live-config.user‐ name=USERNAME'. LIVE_USER_FULLNAME="NOME_COMPLETO_DO_USUÁRIO" Esta variável é equivalente ao parâmetro 'live-config.user-full‐ name="NOME_COMPLETO_DO_USUÁRIO"'. LIVE_LOCALES=LOCALE1,LOCALE2 ... LOCALEn Esta variável é equivalente ao parâmetro 'live-con‐ fig.locales=LOCALE1,LOCALE2 ... LOCALEn'. LIVE_TIMEZONE=TIMEZONE Esta variável é equivalente ao parâmetro 'live-config.time‐ zone=TIMEZONE'. LIVE_UTC=yes|no Esta variável é equivalente ao parâmetro 'live-config.utc=yes|no' LIVE_KEYBOARD_MODEL=MODELO_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.key‐ board-model=MODELO_DE_TECLADO'. LIVE_KEYBOARD_LAYOUTS=LAYOUT1_DE_TECLADO,LAYOUT2_DE_TECLADO ... LAY‐ OUTn_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.keyboard-lay‐ outs=LAYOUT1_DE_TECLADO,LAYOUT2_DE_TECLADO ... LAYOUTn_DE_TECLADO'. LIVE_KEYBOARD_VARIANT=VARIANTE_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.key‐ board-variant=VARIANTE_DE_TECLADO'. LIVE_KEYBOARD_OPTIONS=OPÇÕES_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.key‐ board-options=OPÇÕES_DE_TECLADO'. LIVE_SYSV_RC=SERVIÇO1,SERVIÇO2 ... SERVIÇOn Esta variável é equivalente ao parâmetro 'live-con‐ fig.sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇOn'. LIVE_XORG_DRIVER=DRIVER_DO_XORG Esta variável é equivalente ao parâmetro 'live-con‐ fig.xorg-driver=DRIVER_DO_XORG'. LIVE_XORG_RESOLUTION=RESOLUÇÃO_DO_XORG Esta variável é equivalente ao parâmetro 'live-config.xorg-resolu‐ tion=RESOLUÇÃO_DO_XORG'. LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn Esta variável é equivalente ao parâmetro 'live-con‐ fig.hooks=filesystem|medium|URL1|URL2| ... |URLn'.

CUSTOMIZAÇÃO

live-config pode ser facilmente customizado para projetos derivados ou uso local.

Adicionando novos scripts de configuração

Projetos derivados podem simplesmente colocar seus scripts em /lib/live/config, nada mais, e eles serão chamados automaticamente durante a inicialização. Os scripts devem ser preferencialmente colocados num pacote debian próprio. Um pacote modelo contendo um script de exemplo pode ser encon‐ trado em /usr/share/doc/live-config/.

Removendo scripts de configuração existentes

De fato ainda não é possível remover scripts de forma segura sem que seja necessário distribuir um pacote live-config modificado localmente. Porém, o mesmo pode ser alcançado desabilitando os scripts respectivos através do mecanismo live-noconfig, como indicado acima. Para evitar que sempre seja necessário especificar scripts desabilitados através de parâmetros de inicialização, um arquivo de configuração deve ser usado. Ver detalhes acima. Os arquivos de configuração para o próprio sistema live devem ser pref‐ erencialmente colocados num pacote debian próprio. Um pacote modelo contendo uma configuração de exemplo pode ser encontrado em /usr/share/doc/live-config/examples.

SCRIPTS

live-config atualmente provê os seguintes scripts em /lib/live/config. hostname configura o /etc/hostname e /etc/hosts. user-setup adiciona uma conta de usuário live. sudo concede privilégios sudo ao usuário live. locales configura locales. tzdata configura /etc/timezone. gdm configura autologin no gdm. gdm3 configura autologin no gdm3 (squeeze e mais recentes). kdm configura autologin no kdm. lxdm configura autologin no lxdm. nodm configura autologin no nodm. slim configura autologin no slim. xinit configura autologin no xinit. console-common, console-setup (lenny), keyboard-configuration (squeeze e mais recentes) configura o teclado. sysvinit configura sysvinit. sysv-rc configura sysv-rc desabilitando serviços listados. login desabilita lastlog. apport (apenas ubuntu) desabilita apport. gnome-panel-data desabilita botão de trava para a tela. gnome-power-manager desabilita hibernação. gnome-screensaver desabilita o bloqueio de tela do screensaver. initramfs-tools faz com que o update-initramfs também atualize a mídia live quando persistência for usada. kaboom desabilita o assitente de migração do KDE. kde-services desabilita alguns serviços do KDE não desejados (squeeze e mais recentes). kpersonalizer desabilita o assistente de configura do KDE (lenny). debian-installer-launcher adiciona o instalador (debian-installer-launcher) na área de tra‐ balho dos usuários. module-init-tools carrega alguns módulos automaticamente em algumas arquiteturas. policykit concede privilégios de usuário através de policykit. sslcert gera novos certificados ssl. update-notifier desabilita update-notifier. anacron desabilita anacron. util-linux desabilita o relógio de hardware do util-linux. login desabilita lastlog. xserver-xorg configura o xserver-xorg. ureadahead (apenas ubuntu) desabilita ureadahead. openssh-server recriar chaves do servidor openssh hooks permite executar comandos arbitrários a partir de um script local‐ izado na mídia live ou um servidor http/ftp.

ARQUIVOS

/etc/live/config.conf /etc/live/config.d/ live/config.conf live/config.d/ /lib/live/config.sh /lib/live/config/ /var/lib/live/config/

VER TAMBÉM

live-boot(7) live-build(7)

HOMEPAGE

Mais informações sobre live-config e o projeto Debian Live podem ser encontradas na página <http://live.debian.net/> e no manual disponível em <http://live.debian.net/manual/>.

BUGS

Bugs podem ser relatados através da submissão de um reporte de bug para o pacote live-config através do Debian Bug Tracking System em <http://bugs.debian.org/> ou enviando um email para a lista de dis‐ cussão Debian Live em <debian-live@lists.debian.org>.

AUTOR

live-config foi escrito por Daniel Baumann <daniel@debian.org> para projeto Debian.

2.0.15 01-25-2011 LIVE-CONFIG(7)