LIVE-CONFIG(7)

NOME
live-config - Componentes de Configuração do Sistema

DESCRIÇÃO
live-config contém os componentes que configuram um sistema 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 os mecanismos forem usados para uma determinada opção, os parâmetros de inicialização têm precedência sobre os arquivos de configuração. Ao usar persistência, os componentes live-config são executados apenas uma vez.

Se live-build(7) for usado para construir o sistema live, os parâmetros live-config usados por padrão podem ser definidos através da opção --bootappend-live, consulte a página de manual lb_config(1).

  Parâmetros de Inicialização (componentes)
live-config é ativado apenas se 'boot=live' for usado como parâmetro de inicialização. Além disso, live-config precisa ser informado quais componentes devem ser executados através do parâmetro 'live-config.components' ou quais componentes não devem ser executados através do parâmetro 'live-config.nocomponents'. Se ambos 'live-config.components' e 'live-config.nocomponents' forem usados, ou, se qualquer um for especificado várias vezes, o último sempre terá precedência sobre o(s) anterior(es).

live-config.components | components
    Todos os componentes são executados. Isso é o que as imagens live usam por padrão.

live-config.components=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n | components=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n
    Apenas os componentes especificados são executados. Observe que a ordem importa, por exemplo, 'live-config.components=sudo,user-setup' não funcionaria, pois o usuário precisa ser adicionado antes que possa ser configurado para sudo. Consulte os nomes de arquivo dos componentes em /usr/lib/live/config para seus números de ordenação.

live-config.nocomponents | nocomponents
    Nenhum componente é executado. Isso é o mesmo que não usar nenhum de 'live-config.components' ou 'live-config.nocomponents'.

live-config.nocomponents=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n | nocomponents=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n
    Todos os componentes são executados, exceto os especificados.

  Parâmetros de Inicialização (opções)
Alguns componentes individuais podem alterar seu comportamento com um parâmetro de inicialização.

live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn | debconf-preseed=medium|filesystem|URL1|URL2| ... |URLn
    Permite buscar e aplicar um ou mais arquivos debconf preseed a serem aplicados ao banco de dados debconf. Observe que as URLs devem ser acessíveis por wget (http, ftp ou file://).
    Se o arquivo estiver no meio live, ele pode ser buscado com file:///lib/live/mount/medium/FILE, ou com file:///FILE se estiver no sistema de arquivos raiz do próprio sistema live.
    Todos os arquivos preseed em /usr/lib/live/config-preseed/ no sistema de arquivos raiz do sistema live podem ser automaticamente ativados com a palavra-chave 'filesystem'.
    Todos os arquivos preseed em /minios/config-preseed/ do meio live podem ser automaticamente ativados com a palavra-chave 'medium'.
    Se vários mecanismos forem combinados, os arquivos preseed do sistema de arquivos são aplicados primeiro, depois os arquivos preseed do meio e, por último, os arquivos preseed da rede.

live-config.hostname=NOME_DO_HOST | hostname=NOME_DO_HOST
    Permite definir o nome do host do sistema. O padrão é 'debian'.

live-config.username=NOME_DE_USUÁRIO | username=NOME_DE_USUÁRIO
    Permite definir o nome de usuário que é criado para o autologin. O padrão é 'user'.

live-config.user-default-groups=GRUPO1,GRUPO2 ... GRUPO_n | user-default-groups=GRUPO1,GRUPO2 ... GRUPO_n
    Permite definir os grupos padrão dos usuários que são criados para o autologin. 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 definir o nome completo dos usuários criados para o autologin. No Debian, o padrão é 'Debian Live user'.

live-config.root-password=SENHA | root-password=SENHA
    Permite definir a senha de root em texto simples.

live-config.root-password-crypted=SENHA | root-password-crypted=SENHA
    Permite definir a senha de root de forma criptografada.

live-config.user-password=SENHA | user-password=SENHA
    Permite definir a senha do usuário em texto simples.

live-config.user-password-crypted=SENHA | user-password-crypted=SENHA
    Permite definir a senha do usuário de forma criptografada.

live-config.locales=LOCALE1,LOCALE2 ... LOCALE_n | locales=LOCALE1,LOCALE2 ... LOCALE_n
    Permite definir o locale do sistema, por exemplo, 'de_CH.UTF-8'. O padrão é 'en_US.UTF-8'. Caso o locale selecionado não esteja disponível no sistema, ele é gerado automaticamente.

live-config.timezone=FUSO_HORÁRIO | timezone=FUSO_HORÁRIO
    Permite definir o fuso horário do sistema, por exemplo, 'Europe/Zurich'. O padrão é 'UTC'.

live-config.keyboard-model=MODELO_DE_TECLADO | keyboard-model=MODELO_DE_TECLADO
    Permite alterar o modelo do teclado. Nenhum valor padrão é definido.

live-config.keyboard-layouts=LAYOUT_TECLADO1,LAYOUT_TECLADO2 ... LAYOUT_TECLADO_n | keyboard-layouts=LAYOUT_TECLADO1,LAYOUT_TECLADO2 ... LAYOUT_TECLADO_n
    Permite alterar os layouts de teclado. Se mais de um for especificado, as ferramentas do ambiente de desktop permitirão alterná-los sob X11. Nenhum valor padrão é definido.

live-config.keyboard-variants=VARIANTE_TECLADO1,VARIANTE_TECLADO2 ... VARIANTE_TECLADO_n | keyboard-variants=VARIANTE_TECLADO1,VARIANTE_TECLADO2 ... VARIANTE_TECLADO_n
    Permite alterar as variantes do teclado. Se mais de uma for especificada, o mesmo número de valores de keyboard-layouts deve ser especificado, pois serão correspondidos um a um na ordem especificada. Valores em branco são permitidos. As ferramentas do ambiente de desktop permitirão alternar entre cada par de layout e variante sob X11. Nenhum valor padrão é definido.

live-config.keyboard-options=OPÇÕES_DE_TECLADO | keyboard-options=OPÇÕES_DE_TECLADO
    Permite alterar as opções do teclado. Não há valor padrão definido.

live-config.sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇO_n | sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇO_n
    Permite desabilitar serviços sysv através do update-rc.d.

live-config.utc=sim|não | utc=sim|não
    Permite alterar se o sistema assume que o relógio de hardware está definido para UTC ou não. O padrão é 'sim'.

live-config.x-session-manager=GERENCIADOR_DE_SESSÃO_X | x-session-manager=GERENCIADOR_DE_SESSÃO_X
    Permite definir o x-session-manager através de update-alternatives.

live-config.xorg-driver=DRIVER_XORG | xorg-driver=DRIVER_XORG
    Permite definir o driver xorg em vez de autodetectar. Se um ID PCI for especificado em /usr/share/live/config/xserver-xorg/DRIVER.ids dentro do sistema live, o DRIVER é forçado para esses dispositivos. Se um parâmetro de inicialização e uma substituição forem encontrados, o parâmetro de inicialização tem precedência.

live-config.xorg-resolution=RESOLUÇÃO_XORG | xorg-resolution=RESOLUÇÃO_XORG
    Permite definir a resolução xorg em vez de autodetectar, por exemplo, 1024x768.

live-config.wlan-driver=DRIVER_WLAN | wlan-driver=DRIVER_WLAN
    Permite definir o driver WLAN em vez de autodetectar. Se um ID PCI for especificado em /usr/share/live/config/broadcom-sta/DRIVER.ids dentro do sistema live, o DRIVER é forçado para esses dispositivos. Se um parâmetro de inicialização e uma substituição forem encontrados, o parâmetro de inicialização tem precedência.

live-config.module-mode=MODE | module-mode=MODE
    Permite especificar o modo de módulo para configuração ao vivo. Quando definido como "mesclado", o sistema atualizará as contas de usuário, reconstruirá os caches e atualizará as configurações dos pacotes para que as alterações de configuração sejam integradas dinamicamente ao sistema em execução.

live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn | hooks=medium|filesystem|URL1|URL2| ... |URLn
    Permite buscar e executar um ou mais arquivos arbitrários. Observe que as URLs devem ser acessíveis por wget (http, ftp ou file://), os arquivos são executados em /tmp do sistema live em execução, e que os arquivos precisam de suas dependências, se houver, já instaladas, por exemplo, se um script python precisar ser executado, o sistema precisa ter python instalado. Alguns hooks para casos de uso comuns estão disponíveis em /usr/share/doc/live-config/examples/hooks/.
    Se o arquivo estiver no meio live, ele pode ser buscado com file:///lib/live/mount/medium/FILE, ou com file:///FILE se estiver no sistema de arquivos raiz do próprio sistema live.
    Todos os hooks em /usr/lib/live/config-hooks/ no sistema de arquivos raiz do sistema live podem ser automaticamente ativados com a palavra-chave 'filesystem'.
    Todos os hooks em /minios/config-hooks/ do meio live podem ser automaticamente ativados com a palavra-chave 'medium'.
    Se vários mecanismos forem combinados, os hooks do sistema de arquivos são executados primeiro, depois os hooks do meio e, por último, os hooks de rede.

  Parâmetros de Inicialização (atalhos)
Para alguns casos de uso comuns onde seria necessário combinar vários parâmetros individuais, live-config oferece atalhos. Isso permite ter total granularidade sobre todas as opções, bem como manter as coisas simples.

live-config.noroot | noroot
    Desabilita sudo e 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 e o autologin gráfico.

live-config.nottyautologin | nottyautologin
    Desabilita o login automático no console, não afetando o autologin gráfico.

live-config.nox11autologin | nox11autologin
    Desabilita o login automático com qualquer gerenciador de exibição, não afetando o autologin tty.

  Parâmetros de Inicialização (opções especiais)
Para casos de uso especiais, existem alguns parâmetros de inicialização especiais.

live-config.debug | debug
    Ativa a saída de depuração em live-config.

  Arquivos de Configuração
live-config pode ser configurado (mas não ativado) através de arquivos de configuração. Tudo, exceto os atalhos que podem ser configurados com um parâmetro de inicialização, também pode ser configurado através de um ou mais arquivos. Se arquivos de configuração forem usados, o parâmetro 'boot=live' ainda é necessário para ativar live-config.

Nota: Se arquivos de configuração forem usados, (preferencialmente) todos os parâmetros de inicialização devem ser colocados na variável LIVE_CONFIG_CMDLINE, ou variáveis individuais podem ser definidas. Se variáveis individuais forem usadas, o usuário é obrigado a garantir que todas as variáveis necessárias estejam definidas para criar uma configuração válida.

Arquivos de configuração podem ser colocados no próprio sistema de arquivos raiz (/etc/live/config.conf, /etc/live/config.conf.d/*.conf), ou na mídia live (minios/config.conf, minios/config.conf.d/*.conf). Se ambos os locais forem usados para uma determinada opção, os da mídia live têm precedência sobre os do sistema de arquivos raiz.

Although the configuration files placed in the configuration directories do not require a particular name, it is suggested for consistency reasons to either use 'vendor.conf' or 'project.conf' as a naming scheme (whereas 'vendor' or 'project' is replaced with the actual name, resulting in a filename like 'progress-linux.conf').

O conteúdo real dos arquivos de configuração consiste em uma ou mais das seguintes variáveis.

LIVE_CONFIG_CMDLINE=PARÂMETRO1 PARÂMETRO2 ... PARÂMETRO_n
    Esta variável corresponde à linha de comando do carregador de inicialização.

LIVE_CONFIG_COMPONENTS=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n
    Esta variável corresponde ao parâmetro 'live-config.components=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n'.

LIVE_CONFIG_NOCOMPONENTS=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n
    Esta variável corresponde ao parâmetro 'live-config.nocomponents=COMPONENTE1,COMPONENTE2, ... COMPONENTE_n'.

LIVE_DEBCONF_PRESEED=filesystem|medium|URL1|URL2| ... |URLn
    Esta variável corresponde ao parâmetro 'live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn'.

LIVE_HOSTNAME=NOME_DO_HOST
    Esta variável corresponde ao parâmetro 'live-config.hostname=NOME_DO_HOST'.

LIVE_USERNAME=NOME_DE_USUÁRIO
    Esta variável corresponde ao parâmetro 'live-config.username=NOME_DE_USUÁRIO'.

LIVE_USER_DEFAULT_GROUPS=GRUPO1,GRUPO2 ... GRUPO_n
    Esta variável corresponde ao parâmetro 'live-config.user-default-groups="GRUPO1,GRUPO2 ... GRUPO_n"'.

LIVE_USER_FULLNAME="NOME COMPLETO DO USUÁRIO"
    Esta variável corresponde ao parâmetro 'live-config.user-fullname="NOME COMPLETO DO USUÁRIO"'.

LIVE_ROOT_PASSWORD=SENHA
    Esta variável corresponde ao parâmetro 'live-config.root-password=SENHA'. Ela especifica a senha de root em texto simples.

LIVE_ROOT_PASSWORD_CRYPTED=SENHA
    Esta variável corresponde ao parâmetro 'live-config.root-password-crypted=SENHA'. Ela especifica a senha de root em formato criptografado.

LIVE_USER_PASSWORD=SENHA
    Esta variável corresponde ao parâmetro 'live-config.user-password=SENHA'. Ela especifica a senha do usuário em texto simples.

LIVE_USER_PASSWORD_CRYPTED=SENHA
    Esta variável corresponde ao parâmetro 'live-config.user-password-crypted=SENHA'. Ela especifica a senha do usuário em formato criptografado.

LIVE_LOCALES=LOCALE1,LOCALE2 ... LOCALE_n
    Esta variável corresponde ao parâmetro 'live-config.locales=LOCALE1,LOCALE2 ... LOCALE_n'.

LIVE_TIMEZONE=FUSO_HORÁRIO
    Esta variável corresponde ao parâmetro 'live-config.timezone=FUSO_HORÁRIO'.

LIVE_KEYBOARD_MODEL=MODELO_DE_TECLADO
    Esta variável corresponde ao parâmetro 'live-config.keyboard-model=MODELO_DE_TECLADO'.

LIVE_KEYBOARD_LAYOUTS=LAYOUT_TECLADO1,LAYOUT_TECLADO2 ... LAYOUT_TECLADO_n
    Esta variável corresponde ao parâmetro 'live-config.keyboard-layouts=LAYOUT_TECLADO1,LAYOUT_TECLADO2 ... LAYOUT_TECLADO_n'.

LIVE_KEYBOARD_VARIANTS=VARIANTE_TECLADO1,VARIANTE_TECLADO2 ... VARIANTE_TECLADO_n
    Esta variável corresponde ao parâmetro 'live-config.keyboard-variants=VARIANTE_TECLADO1,VARIANTE_TECLADO2 ... VARIANTE_TECLADO_n'.

LIVE_KEYBOARD_OPTIONS=OPÇÕES_DE_TECLADO
    Esta variável corresponde ao parâmetro 'live-config.keyboard-options=OPÇÕES_DE_TECLADO'.

LIVE_SYSV_RC=SERVIÇO1,SERVIÇO2 ... SERVIÇO_n
    Esta variável corresponde ao parâmetro 'live-config.sysv-rc=SERVIÇO1,SERVIÇO2 ... SERVIÇO_n'.

LIVE_UTC=sim|não
    Esta variável corresponde ao parâmetro 'live-config.utc=sim|não'.

LIVE_X_SESSION_MANAGER=GERENCIADOR_DE_SESSÃO_X
    Esta variável corresponde ao parâmetro 'live-config.x-session-manager=GERENCIADOR_DE_SESSÃO_X'.

LIVE_XORG_DRIVER=DRIVER_XORG
    Esta variável corresponde ao parâmetro 'live-config.xorg-driver=DRIVER_XORG'.

LIVE_XORG_RESOLUTION=RESOLUÇÃO_XORG
    Esta variável corresponde ao parâmetro 'live-config.xorg-resolution=RESOLUÇÃO_XORG'.

LIVE_WLAN_DRIVER=DRIVER_WLAN
    Esta variável corresponde ao parâmetro 'live-config.wlan-driver=DRIVER_WLAN'.

LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn
    Esta variável corresponde ao parâmetro 'live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn'.

LIVE_LINK_USER_DIRS=true|false
    Esta variável corresponde ao parâmetro 'live-config.link-user-dirs=true|false'. Ela ativa ou desativa a criação de links simbólicos para diretórios de usuário.

LIVE_BIND_USER_DIRS=true|false
    Esta variável corresponde ao parâmetro 'live-config.bind-user-dirs=true|false'. Ela ativa ou desativa a montagem de vínculo para diretórios de usuário.

LIVE_USER_DIRS_PATH=CAMINHO
    Esta variável corresponde ao parâmetro 'live-config.user-dirs-path=CAMINHO'. Ela especifica o caminho para os diretórios de usuário na mídia.

LIVE_MODULE_MODE
    Esta variável mantém o estado especificado pelo parâmetro 'live-config.module-mode' (ou 'module-mode'). Quando configurada como "merged", o sistema ao vivo aplica atualizações (via minios-update-users, minios-update-cache e minios-update-dpkg) para mesclar configurações personalizadas com o ambiente base.

LIVE_CONFIG_DEBUG=verdadeiro|falso
    Esta variável corresponde ao parâmetro 'live-config.debug'.

CUSTOMIZAÇÃO
live-config pode ser facilmente personalizado para projetos downstream ou uso local.

  Adicionando novos componentes de configuração
Projetos downstream podem colocar seus componentes em /usr/lib/live/config e não precisam fazer mais nada, os componentes serão chamados automaticamente durante a inicialização.

Os componentes são melhor colocados em um pacote debian próprio. Um pacote de exemplo contendo um componente de exemplo pode ser encontrado em /usr/share/doc/live-config/examples.

  Removendo componentes de configuração existentes
Não é realmente possível remover componentes de forma sensata ainda sem exigir o envio de um pacote live-config modificado localmente ou o uso de dpkg-divert. No entanto, o mesmo pode ser alcançado desabilitando os componentes respectivos através do mecanismo live-config.nocomponents, veja acima. Para evitar a necessidade de sempre especificar componentes desabilitados através do parâmetro de inicialização, um arquivo de configuração deve ser usado, veja acima.

Os arquivos de configuração para o próprio sistema live são melhor colocados em um pacote debian próprio. Um pacote de exemplo contendo uma configuração de exemplo pode ser encontrado em /usr/share/doc/live-config/examples.

COMPONENTES
live-config atualmente apresenta os seguintes componentes em /usr/lib/live/config.

nss-systemd
    Remove ou restaura o módulo NSS do systemd em /etc/nsswitch.conf para contornar um problema conhecido do systemd.

debconf
    Permite aplicar arquivos preseed arbitrários colocados na mídia live ou em um servidor http/ftp.

hostname
    Configura /etc/hostname e /etc/hosts.

issue-setup
    Configura o arquivo /etc/issue com um banner de boas-vindas e informações da distribuição.

live-debconfig (passwd)
    Configura as senhas de usuário e root via live-debconfig.

user-setup
    Adiciona uma conta de usuário live.

root-setup
    Define ou atualiza a senha de root e configura o ambiente de usuário root.

sudo
    Concede privilégios sudo ao usuário live.

user-media
    Configura a montagem de mídia e a vinculação ou ligação de diretórios de usuário para dados persistentes.

user-ssh-keys
    synchronizes SSH keys from user-specific authorized_keys.<username> files on the live media to individual user home directories. Supports multiple users simultaneously (e.g., authorized_keys.root, authorized_keys.live, authorized_keys.admin).

locales
    Configura os locais.

tzdata
    Configura /etc/timezone.

xorg-service
    configura o nome de usuário em xorg.service.

gdm3
    Configura o autologin no gdm3.

kdm Configura o autologin no kdm.

lightdm
    Configura o autologin no lightdm.

lxdm
    Configura o autologin no lxdm.

nodm
    Configura o autologin no nodm.

slim
    Configura o autologin no slim.

xinit
    Configura o autologin com xinit.

keyboard-configuration
    Configura o teclado.

sysvinit
    Configura o sysvinit.

sysv-rc
    Configura sysv-rc desabilitando os serviços listados.

login
    Desabilita o lastlog.

anacron
    Desabilita anacron.

util-linux
    Desabilita o hwclock do util-linux.

apport
    Desabilita apport.

gnome-panel-data
    Desabilita o botão de bloqueio para a tela.

gnome-power-manager
    Desabilita a hibernação.

gnome-screensaver
    Desabilita o protetor de tela bloqueando a tela.

kaboom
    Desabilita o assistente de migração do KDE (squeeze e mais recentes).

kde-services
    Desabilita alguns serviços KDE indesejados (squeeze e mais recentes).

policykit
    Concede privilégios de usuário através do policykit.

ssl-cert
    Regenerando certificados ssl snake-oil.

xrdp
    Configura o xrdp para conectividade de área de trabalho remota.

xfce4-panel
    Configura o xfce4-panel para as configurações padrão.

xscreensaver
    Desabilita o protetor de tela bloqueando a tela.

broadcom-sta
    Configura os drivers WLAN broadcom-sta.

xserver-xorg
    Configura o xserver-xorg.

openssh-server
    Recria as chaves de host do openssh-server.

xhyper-v
    configures X11 settings to improve compatibility on Microsoft Hyper-V platforms.

ntfs3
    Gerencia as regras do udev para suporte a NTFS3.

config-module-mode
    Configura o modo de módulo do sistema e atualiza caches, configurações do usuário e dpkg.

hooks
    Permite executar comandos arbitrários de um arquivo colocado na mídia live ou em um servidor http/ftp.

ARQUIVOS

/etc/live/config.conf

/etc/live/config.conf.d/*.conf

live/config.conf

live/config.conf.d/*.conf

/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/*

VEJA TAMBÉM
live-boot(7)

live-build(7)

live-tools(7)

PÁGINA INICIAL
Mais informações sobre o live-config e o projeto Debian Live podem ser encontradas na página inicial em <https://wiki.debian.org/DebianLive> e no manual em <https://live-team.pages.debian.net/live-manual/>.

PROBLEMAS
Bugs podem ser relatados enviando um relatório de bug para o pacote live-config no Sistema de Rastreamento de Bugs em <http://bugs.debian.org/> ou escrevendo um e-mail para a lista de discussão Debian Live em <debian-live@lists.debian.org>.

AUTOR
live-config foi originalmente escrito por Daniel Baumann <mail@daniel-baumann.ch>. Desde 2016, o desenvolvimento foi continuado pela equipe Debian Live. Desde 2025, o desenvolvimento da versão modificada foi continuado pela equipe MiniOS Live.