Provided by: live-config-doc_3.0.23-1+deb8u1_all
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. Para configurar os parâmetros do live-config utilizados por padrão numa imagem live, veja a opção --bootappend-live no manual do lb_config(1). 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 configurado 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.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn | debconf-preseed=medium|filesystem|URL1|URL2| ... |URLn Possibilita buscar e aplicar um ou mais preseeds debconf para serem inseridos na base de dados debconf.Note que as URLs devem ser alcançáveis via wget (http,ftp ou file://). Se o arquivo estiver na mídia live, ele pode ser obtido através de file:///lib/live/mount/medium/FILE ou file:///FILE se estiver no sistema raiz do próprio sistema live. Todos os arquivos de preseeds em /lib/live/config-preseed/ no sistema de arquivos raiz do sistema live podem ser automaticamente ativados com a palavra-chave 'filesystem'. Todos os arquivos de preseeds em /live/config-preseed/ da mídia live podem ser automaticamente ativados com a palavra-chave 'medium'. Se diversos mecanismos são combinados, os arquivos de preseed referentes ao sistema de arquivos (filesystem) são aplicados primeiramente, seguidos pelos preseeds de mídia (medium) e por último os arquivos de preseed referentes à rede (network). 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 autologin. O padrão 'user'. live-config.user-default-groups=GROUPO1,GROUPO2 ... GROUPOn | user-default-groups=GROUPO1,GROUPO2 ... GROUPOn Possibilita configurar os grupos padrões de usuários criados para login automático. O padrão é 'audio cdrom dip floppy video plugdev netdev powerdev scanner bluetooth'. live-config.user-fullname="NOME_COMPLETO_DO_USUÁRIO" | user-fullname="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.keyboard-model=MODELO_DO_TECLADO | keyboard-model=MODELO_DO_TECLADO Permite configurar o modelo do teclado. Não há valor padrão definido. live-config.keyboard-layouts=LEIAUTE1_DO_TECLADO,LEIAUTE2_DO_TECLADO ... LEIAUTEn_DO_TECLADO | keyboard-layouts=LEIAUTE1_DO_TECLADO,LEIAUTE2_DO_TECLADO ... LEIAUTEn_DO_TECLADO Permite configurar leiautes de teclado. Se mais de um leiaute 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-variants=VARIANTE1_DO_TECLADO,VARIANTE2_DO_TECLADO ... VARIANTEn_DO_TECLADO | keyboard-variants=VARIANTE1_DO_TECLADO,VARIANTE2_DO_TECLADO ... VARIANTEn_DO_TECLADO Permite configurar as variantes de teclado. Se mais de uma for especificada, um mesmo número de valores para leiautes deve ser definido, uma vez que estes serão combinados um a um na ordem especificada. Valores em branco são permitidos. As ferramentas do ambiente de trabalho possibilitarão a troca entre cada par leiaute/variante no X11. Não há valor padrão definido. live-config.keyboard-options=OPÇÕES_DE_TECLADO | keyboard-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 via update-rc.d. 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.x-session-manager=GERENCIADOR_DE_SESSÕES_DO_X | x-session-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 em vez de detectá-lo automaticamente. Se um ID PCI é definido em /usr/share/live/config/xserver-xorg/DRIVER.ids do sistema live, DRIVER será aplicado para estes dispositivos. Se ambos um parâmatro de inicialização e um override forem encontrados, o parâmatro de inicialização prevalecerá. live-config.xorg-resolution=RESOLUÇÃO_DO_XORG | xorg-resolution=RESOLUÇÃO_DO_XORG Permite definir a resolução do xorg em vez de detectá-la automaticamente, por exemplo, 1024x768. 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 necessita ser executado, python deve estar instalado no sistema. Alguns hooks para 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:///lib/live/mount/medium/FILE ou file:///FILE se estiver no sistema raiz do próprio sistema live. Todos os hooks no diretório /lib/live/config-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/config-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 precisariam da combinação de diversos parâmetros. Isto possibilita uma granularidade 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/*) ou na mídia live (live/config.conf, live/config/*). 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 susbstituído pelo nome real, resultando num nome de arquivo como 'debian-eeepc.conf'). O conteúdo atual dos arquivos de configuração consiste em uma ou mais das seguintes variáveis. LIVE_CONFIGS=SCRIPT1,SCRIPT2, ... SCRIPTn Esta variável é equivalente ao parâmetro 'live-config=SCRIPT1,SCRIPT2, ... SCRIPTn'. LIVE_NOCONFIGS=SCRIPT1,SCRIPT2, ... SCRIPTn Esta variável é equivalente ao parâmetro 'live-noconfig=SCRIPT1,SCRIPT2, ... SCRIPTn'. LIVE_DEBCONF_PRESEED=filesystem|medium|URL1|URL2| ... |URLn Esta variável é equivalente ao parâmetro 'live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn'. LIVE_HOSTNAME=HOSTNAME Esta variável é equivalente ao parâmetro 'live-config.hostname=HOSTNAME'. LIVE_USERNAME=USERNAME Esta variável é equivalente ao parâmetro 'live-config.username=USERNAME'. LIVE_USER_DEFAULT_GROUPS=GROUPO1,GROUPO2 ... GROUPOn Esta variável é equivalente ao parâmetro 'live-config.user-default-groups="GROUPO1,GROUPO2 ... GROUPOn"'. LIVE_USER_FULLNAME="NOME_COMPLETO_DO_USUÁRIO" Esta variável é equivalente ao parâmetro 'live-config.user-fullname="NOME_COMPLETO_DO_USUÁRIO"'. LIVE_LOCALES=LOCALE1,LOCALE2 ... LOCALEn Esta variável é equivalente ao parâmetro 'live-config.locales=LOCALE1,LOCALE2 ... LOCALEn'. LIVE_TIMEZONE=TIMEZONE Esta variável é equivalente ao parâmetro 'live-config.timezone=TIMEZONE'. LIVE_KEYBOARD_MODEL=MODELO_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.keyboard-model=MODELO_DE_TECLADO'. LIVE_KEYBOARD_LAYOUTS=LEIAUTE1_DE_TECLADO,LEIAUTE2_DE_TECLADO ... LEIAUTEn_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.keyboard-variants=LEIAUTE1_DE_TECLADO,LEIAUTE2_DE_TECLADO ... LEIAUTEn_DE_TECLADO'. LIVE_KEYBOARD_VARIANTS=VARIANTE1_DE_TECLADO,VARIANTE2_DE_TECLADO ... VARIANTEn_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.keyboard-variants=VARIANTE1_DE_TECLADO,VARIANTE2_DE_TECLADO ... VARIANTEn_DE_TECLADO'. LIVE_KEYBOARD_OPTIONS=OPÇÕES_DE_TECLADO Esta variável é equivalente ao parâmetro 'live-config.keyboard-options=OPÇÕES_DE_TECLADO'. LIVE_SYSV_RC=SERVIÇO1,SERVIÇO2 ... SERVIÇOn Esta variável é equivalente ao parâmetro 'live-config.sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇOn'. LIVE_UTC=yes|no Esta variável é equivalente ao parâmetro 'live-config.utc=yes|no' LIVE_X_SESSION_MANAGER=GERENCIADOR_DE_SESSÕES_DO_X Esta variável é equivalente ao parâmetro 'live-config.x-session-manager=GERENCIADOR_DE_SESSÕES_DO_X'. LIVE_XORG_DRIVER=DRIVER_DO_XORG Esta variável é equivalente ao parâmetro 'live-config.xorg-driver=DRIVER_DO_XORG'. LIVE_XORG_RESOLUTION=RESOLUÇÃO_DO_XORG Esta variável é equivalente ao parâmetro 'live-config.xorg-resolution=RESOLUÇÃO_DO_XORG'. LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn Esta variável é equivalente ao parâmetro 'live-config.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 encontrado 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 ou utilisar o dpkg-divert. No entanto, o mesmo resultado pode ser alcançado desabilitando os respectivos scripts por meio do mecanismo live-noconfig, como indicado acima. Para evitar que sempre haja necessidade de especificar scripts desabilitados via parâmetros de inicialização, um arquivo de configuração deve ser usado. Veja detalhes acima. Os arquivos de configuração para o próprio sistema live devem ser preferencialmente 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. debconf possibilita aplicar arquivos de preseed arbitrários dentro da mídia live or num servidor http/ftp. 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. locales-all configura locales-all. tzdata configura /etc/timezone. gdm configura autologin no gdm. gdm3 configura autologin no gdm3 (squeeze e mais recentes). kdm configura autologin no kdm. lightdm configura autologin no lightdm. lxdm configura autologin no lxdm. nodm configura autologin no nodm. slim configura autologin no slim. xinit configura autologin no xinit. keyboard-configuration configura o teclado. sysvinit configura sysvinit. sysv-rc configura sysv-rc desabilitando serviços listados. login desabilita lastlog. apport 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 pelo screensaver. kaboom desabilita o assitente de migração do KDE. kde-services desabilita alguns serviços do KDE não desejados (squeeze e mais recentes). debian-installer-launcher adiciona o instalador (debian-installer-launcher) na área de trabalho 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 snake-oil. update-notifier desabilita update-notifier. anacron desabilita anacron. util-linux desabilita o hwclock do util-linux login desabilita lastlog. xserver-xorg configura o xserver-xorg. ureadahead (apenas ubuntu) desabilita ureadahead. openssh-server recria chaves do servidor openssh xfce4-panel configures xfce4-panel to default settings. hooks permite executar comandos arbitrários a partir de um script localizado na mídia live ou um servidor http/ftp.
ARQUIVOS
/etc/live/config.conf /etc/live/config/* live/config.conf live/config/* /lib/live/config.sh /lib/live/config/ /var/lib/live/config/ /var/log/live/config.log /live/config-hooks/* live/config-hooks/* /live/config-preseed/* live/config-preseed/*
VER TAMBÉM
live-boot(7) live-build(7) live-tools(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 reportados através da submissão de um relatório 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 discussão Debian Live em <debian-live@lists.debian.org>.
AUTOR
live-config foi escrito por Daniel Baumann <daniel@debian.org>.