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

Permet de récupérer et d'appliquer un ou plusieurs fichiers de pré-configuration debconf à la base de données debconf. Notez que les URLs doivent pouvoir être utilisables par wget (http, ftp ou 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 /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

Permet de spécifier un nom d'hôte (hostname) du système. Par défaut ce nom est 'debian'.

live-config.username=NOM_D_UTILISATEUR | username=NOM_D_UTILISATEUR

Permet de spécifier le nom d'utilisateur qui est créé pour l'auto-login. Par défaut ce nom est 'user'.

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

Permet de spécifier les groupes par défaut dont sont membre les utilisateurs qui sont créés pour l'auto-login. Par défaut, c'est 'audio cdrom dip floppy video plugdev netdev powerdev scanner bluetooth'.

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

Permet de spécifier le nom complet des utilisateurs créés pour l'auto-login. Pour Debian, il s'agit par défaut de 'Debian Live user'.

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

Permet de spécifier la localisation du système, par exemple 'fr_FR.UTF-8'. Par défaut, il s'agit de 'en_US.UTF-8'. Dans le cas où la locale spécifiée n'est pas déjà disponible sur le système, elle est automatiquement générée à la volée.

live-config.timezone=TIMEZONE | timezone=TIMEZONE

Permet de spécifier la timezone du système, par exemple 'Europe/Paris'. Par défaut, il s'agit de 'UTC'.

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

Permet de changer le modèle de clavier. Il n'y a pas de valeur par défaut spécifiée.

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

Permet de changer la configuration du clavier. Si plus d'une configuration est spécifiée, les utilitaires de l'environnement de bureau permettront de passer de l'une à l'autre sous X11. Il n'y a pas de valeur par défaut spécifiée.

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

Permet de changer la variante du clavier. Si plus d'une variante est spécifiée, le même nombre de valeurs que keyboard-layouts devraient être spécifiées car elles se correspondront une à une dans l'ordre spécifié. On peut utiliser valeurs vides. Les outils de l'environnement de bureau permettront de passer de l'une à l'autre sous X11. Il n'y a pas de valeur par défaut spécifiée.

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

Permet de changer les options du clavier. Il n'y a pas de valeur par défaut spécifiée.

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

Permet de désactiver des services sysv via update-rc.d.

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

Permet de modifier si le système assume que l'horloge matérielle est réglée sur UTC. Par défaut : 'oui'.

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

Permet de spécifier le x-session-manager via update-alternatives.

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

Permet de spécifier le pilote utilisé par xorg plutôt que d'utiliser l'auto-détection. Si un ID PCI est spécifié dans /usr/share/live/config/xserver-xorg/DRIVER.ids dans le système live, le DRIVER est appliqué pour ces périphériques. Si un paramètre d'amorçage et un override sont trouvés à la fois, le paramètre de démarrage est prioritaire.

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

Permet de spécifier la résolution utilisée par xorg, plutôt que d'utiliser l'auto-détection, par example 1024x768.

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

Permet de spécifier le pilote utilisé par WLAN plutôt que d'utiliser l'auto-détection. Si un ID PCI est spécifié dans /usr/share/live/config/broadcom-sta/DRIVER.ids dans le système live, le DRIVER est appliqué pour ces périphériques. Si un paramètre d'amorçage et un override sont trouvés à la fois, le paramètre de démarrage est prioritaire.

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

Permet d'aller chercher et d'exécuter un ou plusieurs fichiers spécifiques. Notez que les URLs doivent pouvoir être téléchargées par wget (http, ftp or file://), que les fichiers sont exécutés dans /tmp du système live en fonctionnement, et que les dépendances des fichiers doivent être préalablement installées; par exemple, si vous devez exécuter un script python, vous devez préalablement installer l'interpréteur python sur le système. Quelques hooks pour certains cas d'utilisation communs sont disponibles dans /usr/share/doc/live-config/examples/hooks/ et sur <http://live.debian.net/other/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 /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)¶

Pour certains cas d'utilisation, il existe des paramètres de démarrage spécifiques.

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.

Bien que les fichiers de configuration placés dans les répertoires de configuration ne nécessitent pas un nom ou suffixe particulier, il est suggéré, pour des raisons de cohérence, d'utiliser «vendeur.conf» ou «projet.conf» en tant que modèle de nommage («vendeur» ou «projet» étant remplacé par le nom réel, résultant en un nom de fichier comme «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=CONFIGURATION1_DU_CLAVIER,CONFIGURATION2_DU_CLAVIER ... CONFIGURATIONn_DU_CLAVIER

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¶

Il n'est actuellement pas vraiment possible d'enlever proprement les composants sans avoir besoin soit d'utiliser un paquet live-config modifié localement, soit à l'aide de dpkg-divert. Cependant, la même chose peut être réalisée en désactivant les scripts respectifs via le mécanisme live-config.nocomponents, comme indiqué ci-dessus. Afin d'éviter de toujours avoir à spécifier les composants désactivés via le paramètre d'amorçage, un fichier de configuration devrait être utilisé, voir ci-dessus.

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.