LIVE-CONFIG(7) Live Systems Project LIVE-CONFIG(7)

NOME

live-config - System Configuration Components

DESCRIÇÃO

live-config contains the components that configure a live system during the boot process (late userspace).

CONFIGURAÇÃO

live-config can be configured through boot parameters or configuration files. If both mechanisms are used for a certain option, the boot parameters take precedence over the configuration files. When using persistency, live-config components are only run once. If live-build(7) is used to build the live system, the live-config parameters used by default can be set through the --bootappend-live option, see lb_config(1) manual page.

Boot Parameters (components)

live-config is only activated if 'boot=live' is used as a boot parame‐ ter. Additionally, live-config needs to be told which components to run through the 'live-config.components' parameter or which components to not run through the 'live-config.nocomponents' parameter. If both 'live-config.components' and 'live-config.nocomponents' are used, or, if either one is specified multiple times, always the later one takes precedence over the previous one(s). live-config.components | components All components are run. This is what live images use by default. live-config.components=COMPONENT1,COMPONENT2, ... COMPONENTn | compo‐ nents=COMPONENT1,COMPONENT2, ... COMPONENTn 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-config.nocomponents | nocomponents No component is run. This is the same as not using any of 'live-config.components' or 'live-config.nocomponents'. live-config.nocomponents=COMPONENT1,COMPONENT2, ... COMPONENTn | nocom‐ ponents=COMPONENT1,COMPONENT2, ... COMPONENTn All components are run, except the specified ones.

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

Some individual components can change their behaviour upon a boot parameter. 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 sis‐ tema 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 ref‐ erentes ao sistema de arquivos (filesystem) são aplicados primeira‐ mente, 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 autolo‐ gin. 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-full‐ name="NOME_COMPLETO_DO_USUÁRIO" Allows to set the fullname of the users that gets created for autologin. On Debian the default is '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=MOD‐ ELO_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-lay‐ outs=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,VARI‐ ANTE2_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 | 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 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-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 em vez de detectá-lo automatica‐ mente. Se um ID PCI é definido em /usr/share/live/con‐ fig/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=RES‐ OLUÇÃO_DO_XORG Permite definir a resolução do xorg em vez de detectá-la automati‐ camente, por exemplo, 1024x768. live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn | hooks=medium|filesystem|URL1|URL2| ... |URLn Allows to fetch and execute one or more arbitrary files. Note that the URLs must be fetchable by wget (http, ftp or file://), the files are executed in /tmp of the running live system, and that the files needs their dependencies, if any, already installed, e.g. if a python script should be executed the system needs python installed. Some hooks for some common use-cases are available at /usr/share/doc/live-config/examples/hooks/ and <http://live-sys‐ tems.org/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 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. Note: If configuration files are used, either (preferably) all boot parameters should be put into the LIVE_CONFIG_CMDLINE variable, or individual variables can be set. If individual variables are used, the user is required to ensure that all the necessary variables are set to create a valid configuration. 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. Although the configuration files placed in the configuration directo‐ ries do not require a particular name or suffix, 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 atual dos arquivos de configuração consiste em uma ou mais das seguintes variáveis. LIVE_CONFIG_CMDLINE=PARAMETER1 PARAMETER2 ... PARAMETERn This variable corresponds to the bootloader command line. LIVE_CONFIG_COMPONENTS=COMPONENT1,COMPONENT2, ... COMPONENTn This variable corresponds to the 'live-config.components=COMPO‐ NENT1,COMPONENT2, ... COMPONENTn' parameter. LIVE_CONFIG_NOCOMPONENTS=COMPONENT1,COMPONENT2, ... COMPONENTn This variable corresponds to the 'live-config.nocomponents=COMPO‐ NENT1,COMPONENT2, ... COMPONENTn' parameter. LIVE_DEBCONF_PRESEED=filesystem|medium|URL1|URL2| ... |URLn This variable corresponds to the 'live-config.debconf-pre‐ seed=filesystem|medium|URL1|URL2| ... |URLn' parameter. LIVE_HOSTNAME=HOSTNAME This variable corresponds to the 'live-config.hostname=HOSTNAME' parameter. LIVE_USERNAME=USERNAME This variable corresponds to the 'live-config.username=USERNAME' parameter. LIVE_USER_DEFAULT_GROUPS=GROUPO1,GROUPO2 ... GROUPOn This variable corresponds to the 'live-con‐ fig.user-default-groups="GROUP1,GROUP2 ... GROUPn"' parameter. LIVE_USER_FULLNAME="NOME_COMPLETO_DO_USUÁRIO" This variable corresponds to the 'live-config.user-fullname="USER FULLNAME"' parameter. LIVE_LOCALES=LOCALE1,LOCALE2 ... LOCALEn This variable corresponds to the 'live-con‐ fig.locales=LOCALE1,LOCALE2 ... LOCALEn' parameter. LIVE_TIMEZONE=TIMEZONE This variable corresponds to the 'live-config.timezone=TIMEZONE' parameter. LIVE_KEYBOARD_MODEL=MODELO_DE_TECLADO This variable corresponds to the 'live-config.keyboard-model=KEY‐ BOARD_MODEL' parameter. LIVE_KEYBOARD_LAYOUTS=LEIAUTE1_DE_TECLADO,LEIAUTE2_DE_TECLADO ... LEIAUTEn_DE_TECLADO This variable corresponds to the 'live-config.keyboard-layouts=KEY‐ BOARD_LAYOUT1,KEYBOARD_LAYOUT2 ... KEYBOARD_LAYOUTn' parameter. LIVE_KEYBOARD_VARIANTS=VARIANTE1_DE_TECLADO,VARIANTE2_DE_TECLADO ... VARIANTEn_DE_TECLADO This variable corresponds to the 'live-config.keyboard-vari‐ ants=KEYBOARD_VARIANT1,KEYBOARD_VARIANT2 ... KEYBOARD_VARIANTn' parameter. LIVE_KEYBOARD_OPTIONS=OPÇÕES_DE_TECLADO This variable corresponds to the 'live-config.keyboard-options=KEY‐ BOARD_OPTIONS' parameter. LIVE_SYSV_RC=SERVIÇO1,SERVIÇO2 ... SERVIÇOn This variable corresponds to the 'live-config.sysv-rc=SERVICE1,SER‐ VICE2 ... SERVICEn' parameter. LIVE_UTC=yes|no This variable corresponds to the 'live-config.utc=yes|no' parame‐ ter. LIVE_X_SESSION_MANAGER=GERENCIADOR_DE_SESSÕES_DO_X This variable corresponds to the 'live-config.x-session-man‐ ager=X_SESSION_MANAGER' parameter. LIVE_XORG_DRIVER=DRIVER_DO_XORG This variable corresponds to the 'live-con‐ fig.xorg-driver=XORG_DRIVER' parameter. LIVE_XORG_RESOLUTION=RESOLUÇÃO_DO_XORG This variable corresponds to the 'live-config.xorg-resolu‐ tion=XORG_RESOLUTION' parameter. LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn This variable corresponds to the 'live-config.hooks=filesys‐ tem|medium|URL1|URL2| ... |URLn' parameter. LIVE_CONFIG_DEBUG=true|false This variable corresponds to the 'live-config.debug' parameter.

CUSTOMIZAÇÃO

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

Adding new config components

Downstream projects can put their components into /lib/live/config and do not need to do anything else, the components will be called automat‐ ically during boot. The components are best put into an own debian package. A sample pack‐ age containing an example component can be found in /usr/share/doc/live-config/examples.

Removing existing config components

It is not really possible to remove components itself in a sane way yet without requiring either to ship a locally modified live-config package or using dpkg-divert. However, the same can be achieved by disabling the respective components through the live-config.nocomponents mecha‐ nism, see above. To avoid to always need specifing disabled components through the boot parameter, a configuration file should be used, see above. 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.

COMPONENTS

live-config currently features the following components in /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. gdm3 configura autologin no gdm3. 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 tra‐ balho dos usuários. policykit concede privilégios de usuário através de policykit. ssl-cert 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. xscreensaver desabilita o bloqueio de tela pelo screensaver. hooks allows to run arbitrary commands from a file placed on the live media or an http/ftp server.

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

More information about live-config and the Live Systems project can be found on the homepage at <http://live-systems.org/> and in the manual at <http://live-systems.org/manual/>.

BUGS

Bugs can be reported by submitting a bugreport for the live-config package in the Bug Tracking System at <http://bugs.debian.org/> or by writing a mail to the Live Systems mailing list at <debian-live@lists.debian.org>.

AUTOR

live-config foi escrito por Daniel Baumann <mail@daniel-baumann.ch>.

4.0~alpha33-1 2014-04-27 LIVE-CONFIG(7)