Paramètres d'amorçage (composants)¶

live-config est uniquement activé si 'boot=live' est utilisé en tant que paramètre d'amorçage. De plus, live-config a besoin d'être informé des composants qui seront lancés via le paramètre «live-config.components» ou de ceux qui ne doivent pas être lancés en utilisant le paramètre «live-config.nocomponents». Si «live-config.components» et «live-config.nocomponents» sont utilisés ou, si l'un d'eux est spécifié plusieurs fois, c'est toujours le dernier qui prévaut sur ceux qui précèdent.

live-config.components | components

Tous les composants sont lancés. C'est la configuration par défaut des images live.

live-config.components=COMPONENT1,COMPONENT2, ... COMPONENTn | components=COMPONENT1,COMPONENT2, ... COMPONENTn

Seuls les scripts spécifiés sont lancés. Notez que leur ordre importe, ainsi 'live-config=sudo,user-setup' ne peut pas fonctionner tant que l'utilisateur configuré pour utiliser sudo n'a pas été créé. Regardez l'ordre numérique des noms de fichiers des composants dans /usr/lib/live/config.

live-config.nocomponents | nocomponents

Aucun composant n'est lancé. Cela revient au même que de n'utiliser ni «live-config.components», ni «live-config.nocomponents».

live-config.nocomponents=COMPONENT1,COMPONENT2, ... COMPONENTn | nocomponents=COMPONENT1,COMPONENT2, ... COMPONENTn

Tous les composants sont lancés, à l'exception de ceux spécifiés.

Paramètres d'amorçage (options)¶

Certains des composants peuvent changer leur comportement en fonction d'un paramètre d'amorçage.

live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn | debconf-preseed=medium|filesystem|URL1|URL2| ... |URLn

Allows one to fetch and apply one or more debconf preseed files to be applied to the debconf database. Note that the URLs must be fetchable by wget (http, ftp or file://).
Si le fichier est placé dans le dispositif live, il peut être utilisé avec file:///lib/live/mount/medium/FILE, ou bien avec file:///FILE s'il est placé à la racine du système de fichiers du système live.
Tous les fichiers de pré-configuration dans /usr/lib/live/config-preseed/ dans le système de fichiers racine du système live peuvent être automatiquement activés avec le mot clé 'filesystem'.
Tous les fichiers de pré-configuration dans /live/config-preseed/ du dispositif live peuvent être automatiquement activés avec le mot clé 'medium'
Si plusieurs mécanismes sont combinés, alors les fichiers de pré-configuration du système de fichiers sont appliqués en premier, puis les fichiers de pré-configuration du dispositif, et enfin les fichiers de pré-configuration du réseau.

live-config.hostname=NOM_D_HÔTE | hostname=NOM_D_HÔTE

Allows one to set the hostname of the system. The default is 'debian'.

live-config.username=NOM_D_UTILISATEUR | username=NOM_D_UTILISATEUR

Allows one to set the username that gets created for autologin. The default is 'user'.

live-config.user-default-groups=GROUP1,GROUP2 ... GROUPn | user-default-groups=GROUP1,GROUP2 ... GROUPn

Allows one to set the default groups of the users that gets created for autologin is member of. The default is 'audio cdrom dip floppy video plugdev netdev powerdev scanner bluetooth'.

live-config.user-fullname="NOM_COMPLET_D_UTILISATEUR" | user-fullname="NOM_COMPLET_D_UTILISATEUR"

Allows one to set the fullname of the users that gets created for autologin. On Debian the default is 'Debian Live user'.

live-config.locales=LOCALISATION1,LOCALISATION2 ... LOCALISATIONn | locales=LOCALISATION1,LOCALISATION2 ... LOCALISATIONn

Allows one to set the locale of the system, e.g. 'de_CH.UTF-8'. The default is 'en_US.UTF-8'. In case the selected locale is not already available on the system, it is automatically generated on the fly.

live-config.timezone=TIMEZONE | timezone=TIMEZONE

Allows one to set the timezone of the system, e.g. 'Europe/Zurich'. The default is 'UTC'.

live-config.keyboard-model=MODELE_DE_CLAVIER | keyboard-model=MODELE_DE_CLAVIER

Allows one to change the keyboard model. There is no default value set.

live-config.keyboard-layouts=KEYBOARD_LAYOUT1,KEYBOARD_LAYOUT2 ... KEYBOARD_LAYOUTn | keyboard-layouts=KEYBOARD_LAYOUT1,KEYBOARD_LAYOUT2 ... KEYBOARD_LAYOUTn

Allows one to change the keyboard layouts. If more than one is specified, the tools of the desktop environment will allow one to switch it under X11. There is no default value set.

live-config.keyboard-variants=KEYBOARD_VARIANT1,KEYBOARD_VARIANT2 ... KEYBOARD_VARIANTn | keyboard-variants=KEYBOARD_VARIANT1,KEYBOARD_VARIANT2 ... KEYBOARD_VARIANTn

Allows one to change the keyboard variants. If more than one is specified, the same number of values as keyboard-layouts values should be specified as they will be matched one-to-one in the order specified. Blank values are allowed. The tools of the desktop environment will allow one to switch between each layout and variant pair under X11. There is no default value set.

live-config.keyboard-options=OPTIONS_DU_CLAVIER | keyboard-options=OPTIONS_DU_CLAVIER

Allows one to change the keyboard options. There is no default value set.

live-config.sysv-rc=SERVICE1,SERVICE2 ... SERVICEn | sysv-rc=SERVICE1,SERVICE2 ... SERVICEn

Allows one to disable sysv services through update-rc.d.

live-config.utc=yes|no | utc=yes|no

Allows one to change if the system is assuming that the hardware clock is set to UTC or not. The default is 'yes'.

live-config.x-session-manager=GESTIONNAIRE_DE_SESSION_X | x-session-manager=GESTIONNAIRE_DE_SESSION_X

Allows one to set the x-session-manager through update-alternatives.

live-config.xorg-driver=PILOTE_XORG | xorg-driver=PILOTE_XORG

Allows one to set xorg driver instead of autodetecting it. If a PCI ID is specified in /usr/share/live/config/xserver-xorg/DRIVER.ids within the live system, the DRIVER is enforced for these devices. If both a boot parameter and an override are found, the boot parameter takes precedence.

live-config.xorg-resolution=RESOLUTION_XORG | xorg-resolution=RESOLUTION_XORG

Allows one to set xorg resolution instead of autodetecting it, e.g. 1024x768.

live-config.wlan-driver=PILOTE_WLAN | wlan-driver=PILOTE_WLAN

Allows one to set WLAN driver instead of autodetecting it. If a PCI ID is specified in /usr/share/live/config/broadcom-sta/DRIVER.ids within the live system, the DRIVER is enforced for these devices. If both a boot parameter and an override are found, the boot parameter takes precedence.

live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn | hooks=URL1|URL2| ... |URLn

Allows one 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/.
Si le fichier est placé dans le dispositif live, il peut être utilisé avec file:///lib/live/mount/medium/FILE, ou bien avec file:///FILE s'il est placé à la racine du système de fichiers du système live.
Tous les hooks, placés dans /usr/lib/live/config-hooks/ à la racine du système de fichiers, peuvent être automatiquement activés avec le mot clé 'filesystem'.
Tous les hooks dans /live/config-hooks/ du dispositif live peuvent être automatiquement activés avec le mot clé 'medium'.
Si plusieurs mécanismes sont combinés, alors les hooks du système de fichiers sont exécutés en premiers, puis les hooks du dispositif, et enfin les hooks du réseau.

Paramètres d'amorçage (raccourcis)¶

Dans certains cas communs où il est nécessaire de combiner plusieurs paramètres individuels, live-config fournit des raccourcis. Ceci permet à la fois d'avoir une granularité complète à travers les options, et également de rester simples.

live-config.noroot | noroot

Désactive sudo et policykit, dans ce cas l'utilisateur ne peut pas obtenir des privilèges d'administrateur (root) sur le système.

live-config.nottyautologin | noautologin

Désactive l'auto-login sur la console et l'auto-login graphique.

live-config.nottyautologin | nottyautologin

Désactive l'auto-login sur la console, mais ne concerne pas l'auto-login graphique.

live-config.nox11autologin | nox11autologin

Désactive l'auto-login avec tout gestionnaire graphique, sans affecter l'auto-login en console (tty).

Paramètres d'amorçage (options particulières)¶

For special use cases there are some special boot parameters.

live-config.debug | debug

Active les messages de debug dans live-config.

Fichiers de configuration¶

live-config peut être configuré (mais pas activé) par certains fichiers de configuration. Tout, sauf les touches de raccourcis qui peuvent être configurées avec un paramètre d'amorçage, peut alternativement être configuré via un ou plusieurs fichiers. Si des fichiers de configuration sont utilisés, le paramètre 'boot=live' est toujours requis pour activer live-config.

Remarque : Si des fichiers de configuration sont utilisés, soit (de préférence) tous les paramètres d'amorçage devraient être mis dans la variable LIVE_CONFIG_CMDLINE, ou bien des variables individuelles peuvent être réglées. Si des variables individuelles sont utilisées, l'utilisateur doit s'assurer que toutes les variables nécessaires sont réglées pour créer une configuration valide.

Les fichiers de configuration peuvent être placés soit dans la racine du système de fichiers (/etc/live/config.conf, /etc/live/config.conf.d/*.conf), soit sur le média live (live/config.conf, live/config.conf.d/*.conf). Si ces deux emplacements sont utilisés pour une même option, ceux placés dans le média live sont prioritaires sur ceux dans la racine du système.

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').

Le contenu réel des fichiers de configuration se compose d'une ou plusieurs des variables suivantes.

LIVE_CONFIG_CMDLINE=PARAMÈTRE1 PARAMÈTRE2 ... PARAMETREn

Cette variable correspond à la ligne de commande du chargeur d'amorçage.

LIVE_CONFIG_COMPONENTS=COMPOSANT1,COMPOSANT2, ... COMPOSANTn

Cette variable correspond au paramètre 'live-config.components=COMPOSANT1,COMPOSANT2, ... COMPOSANTn'

LIVE_CONFIG_NOCOMPONENTS=COMPOSANT1,COMPOSANT2, ... COMPOSANTn

Cette variable correspond au paramètre 'live-config.nocomponents=COMPOSANT1,COMPOSANT2, ... COMPOSANTn'

LIVE_DEBCONF_PRESEED=filesystem|medium|URL1|URL2| ... |URLn

Cette variable correspond au paramètre 'live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn'.

LIVE_HOSTNAME=NOM_D_HÔTE

Cette variable correspond au paramètre 'live-config.hostname=NOM_D_HÔTE'.

LIVE_USERNAME=NOM_D_UTILISATEUR

Cette variable correspond au paramètre 'live-config.username=NOM_D_UTILISATEUR'.

LIVE_USER_DEFAULT_GROUPS=GROUPE1,GROUPE2 ... GROUPEn

Cette variable correspond au paramètre 'live-config.user-default-groups="GROUPE1,GROUPE2 ... GROUPEn"'

LIVE_USER_FULLNAME="NOM_COMPLET_D_UTILISATEUR"

Cette variable correspond au paramètre 'live-config.user-fullname="NOM_COMPLET_D_UTILISATEUR"'.

LIVE_LOCALES=LOCALISATION1,LOCALISATION2 ... LOCALISATIONn

Cette variable correspond au paramètre 'live-config.locales=LOCALISATION1,LOCALISATION2 ... LOCALISATIONn'.

LIVE_TIMEZONE=TIMEZONE

Cette variable correspond au paramètre 'live-config.timezone=TIMEZONE'.

LIVE_KEYBOARD_MODEL=MODELE_DE_CLAVIER

Cette variable correspond au paramètre 'live-config.keyboard-model=MODELE_DE_CLAVIER'.

LIVE_KEYBOARD_LAYOUTS=CONFIG_CLAVIER1,CONFIG_CLAVIER2 ... CONFIG_CLAVIERn

Cette variable correspond au paramètre 'live-config.keyboard-layouts=CONFIGURATION1_DU_CLAVIER,CONFIGURATION2_DU_CLAVIER ... CONFIGURATIONn_DU_CLAVIER'.

LIVE_KEYBOARD_VARIANTS=VARIANTE_CLAVIER1,VARIANTE_CLAVIER2 ... VARIANTE_CLAVIERn

Cette variable correspond au paramètre 'live-config.keyboard-variants=VARIANTE_CLAVIER1,VARIANTE_CLAVIER2 ... VARIANTE_CLAVIERn'.

LIVE_KEYBOARD_OPTIONS=OPTIONS_DU_CLAVIER

Cette variable correspond au paramètre 'live-config.keyboard-options=OPTIONS_DU_CLAVIER'.

LIVE_SYSV_RC=SERVICE1,SERVICE2 ... SERVICEn

Cette variable correspond au paramètre 'live-config.sysv-rc=SERVICE1,SERVICE2 ... SERVICEn'.

LIVE_UTC=yes|no

Cette variable correspond au paramètre 'live-config.utc=yes|no'.

LIVE_X_SESSION_MANAGER=GESTIONNAIRE_DE_SESSION_X

Cette variable correspond au paramètre 'live-config.x-session-manager=GESTIONNAIRE_DE_SESSION_X'.

LIVE_XORG_DRIVER=PILOTE_XORG

Cette variable correspond au paramètre 'live-config.xorg-driver=PILOTE_XORG.

LIVE_XORG_RESOLUTION=RESOLUTION_XORG

Cette variable correspond au paramètre 'live-config.xorg-resolution=RESOLUTION_XORG'.

LIVE_WLAN_DRIVER=PILOTE_WLAN

Cette variable correspond au paramètre 'live-config.wlan-driver=PILOTE_WLAN.

LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn

Cette variable correspond au paramètre 'live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn'.

LIVE_CONFIG_DEBUG=true|false

Cette variable correspond au paramètre 'live-config.debug'.

Ajout de nouveaux composants de configuration¶

Les projets dérivés peuvent utiliser leurs propres composants dans /lib/live/config et n'ont besoin de rien d'autre, les composants seront appelés lors du démarrage.

Il est préférable que les composants soient mis dans leur propre paquet Debian. Un paquet contenant un composant d'exemple est proposé dans /usr/share/doc/live-config/examples.

Enlever des composants de configuration existants¶

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 mechanism, see above. To avoid to always need specifying disabled components through the boot parameter, a configuration file should be used, see above.

Les fichiers de configuration pour le système live lui-même devront de préférence être inclus dans leur propre paquet debian. Un paquet de démonstration contenant un exemple de configuration est proposé dans /usr/share/doc/live-config/examples.