live-build(7) la suite d'outils live systems

SYNOPSIS

lb COMMAND [-h|--help] [-u|--usage] [-v|--version] [--breakpoints] [--conffile] [--debug] [--force] [--quiet] [--verbose]

DESCRIPTION

live-build est un ensemble de scripts pour construire des images de système live. L'idée derrière live-build est une suite d'outils qui utilise un répertoire de configuration pour automatiser complètement et personnaliser tous les aspects de la construction d'une image Live.

La COMMANDE est un nom d'une commande live-build (voir ci-dessous).

Davantage de documentation à propos de la façon d'utiliser live-build est disponible dans les pages de manuel individuelles de chaque assistant ainsi que dans le manual à <http://live-systems.org/manual/>.

OPTIONS

Options live-build partagées

Les options en ligne de commande suivantes sont supportées par l'ensemble des programmes live-build.
-h, --help
affiche l'aide et quitte
-u, --usage
affiche l'utilisation et quitte
-v, --version
affiche les informations de version et quitte

Options live-build communes

Les options de lignes de commandes suivantes sont supportées par la plupart des programmes live-build. Voir la page de manuel de chaque programme pour une explication complète de ce que chaque option fait.
--breakpoints
lance avec des points d'arrêt (breakpoints).
--conffile
utilise un fichier de configuration personnalisé.
--debug
affiche des informations de déboguage.
--force
force l'exécution d'un assistant, même si le fichier de stage existe.
--quiet
soit discret.
--verbose
soit verbeux.

COMMANDES LIVE-BUILD

Nous divisons live-build entre des commandes de haut-niveau ("porcelaine") et de bas-niveau ("plomberie").

Voici une liste complète de toutes les commandes live-build disponibles. Consultez leurs pages de manuel pour obtenir de la documentation additionnelle.

COMMANDES HAUT-NIVEAU (PORCELAINE)

Nous séparons les commandes porcelaine en commandes principales et en utilitaires utilisateur auxiliaires.

Commandes porcelaine principales

lb_config(1)
crée une configuration pour live-build
lb_bootstrap(1)
crée le premier stage en amorçant un système debian basique
lb_chroot(1)
crée un deuxième stage en personnalisant le chroot
lb_binary(1)
crée le troisième stage en générant une image binaire
lb_source(1)
crée le quatrième stage optionel en générant une image source
lb_clean(1)
nettoie les répertoires de construction du système

Commandes auxiliaires

lb(1)
emballage live-build générique
lb_build(1)
alias pour tous les stages
lb_local(1)
assistant pour l'utilisation d'un live-build local
lb_testroot(1)
s'assure que le système est construit en tant qu'administrateur (root)

COMMANDES BAS-NIVEAU (PLOMBERIE)

Le travail réel de live-build est implémenté dans les commandes bas-niveau, appelées plomberie. Elles ne sont pas supposées être utilisées par les utilisateurs finaux, ils devraient rester avec les porcelaines puisqu'elles s'assurent que toutes les différentes commandes de plomberie sont exécutées dans le bon ordre. Toutefois, si vous prévoyez de ré-utiliser les commandes live-build dans vos propres scripts, alors les plomberies pourraient vous intéresser.

Notez que l'interface (ensemble des options et des semantiques) de ces commandes bas-niveau sont pensées pour être beaucoup plus stables que les commandes de niveau Porcelaine. D'un autre côté, l'interface des commandes Porcelaine sont sujettes à changement afin d'améliorer l'expérience de l'utilisateur final.

Commandes d'amorçage

lb_bootstrap_cache(1)
stage d'amorçage cache
lb_bootstrap_debootstrap(1)
amorçcer un système Debian avec debootstrap(8)

Commandes chroot

lb_chroot_apt(1)
gère /etc/apt/apt.conf
lb_chroot_cache(1)
stage de chroot cache
lb_chroot_debianchroot(1)
gère /etc/debian_chroot
lb_chroot_devpts(1)
monte /dev/pts
lb_chroot_dpkg(1)
gère /sbin/dpkg
lb_chroot_hacks(1)
exécute les hacks dans le chroot
lb_chroot_hostname(1)
gère /bin/hostname
lb_chroot_hosts(1)
gère /etc/hosts
lb_chroot_install-packages(1)
installe les paquets en attente dans le chroot
lb_chroot_interactive(1)
rend la construction intéractive
lb_chroot_linux-image(1)
gère /etc/kernel-img.conf
lb_chroot_hooks(1)
exécute les hooks locaux dans le chroot
lb_chroot_local-includes(1)
copie les fichiers locaux dans le chroot
lb_chroot_packages(1)
met en attente l'installation des paquets dans le chroot
lb_chroot_local-patches(1)
appliques les rustines locales dans le chroot
lb_chroot_local-preseed(1)
utilise un fichier de pré-configuration local debconf
lb_chroot_packagelists(1)
met en attente l'installation des listes de paquets dans le chroot
lb_chroot_proc(1)
monte /proc
lb_chroot_resolv(1)
gère /etc/resolv.conf
lb_chroot_selinuxfs(1)
monte /selinux
lb_chroot_archives(1)
gère /etc/apt/sources.list
lb_chroot_sysfs(1)
gère /sys
lb_chroot_sysv-rc(1)
gère /usr/sbin/policy-rc.d
lb_chroot_task-lists(1)
installe les listes de tâches dans le chroot

Commandes binaires

lb_binary_chroot(1)
copie le chroot dans le chroot
lb_binary_debian-installer(1)
installe debian-installer dans le binaire
lb_binary_disk(1)
installe les informations de disque dans le binaire
lb_binary_grub(1)
installe grub dans le binaire
lb_binary_grub2(1)
installe grub2 dans le binaire
lb_binary_includes(1)
copie les fichiers dans le binaire
lb_binary_iso(1)
construit l'image binaire iso
lb_binary_linux-image(1)
installe linux-image dans le binaire
lb_binary_local-hooks(1)
exécute les hooks locaux dans le binaire
lb_binary_local-includes(1)
copie les fichiers dans le binaire
lb_binary_local-packagelists(1)
installe les listes de paquets locaux dans le binaire
lb_binary_manifest(1)
crée le manifeste
lb_binary_checksums(1)
crée les sommes de vérification binaires (md5, sha1, et/ou sha256)
lb_binary_memtest(1)
installe memtest dans le binaire
lb_binary_net(1)
construit l'image binaire netboot
lb_binary_rootfs(1)
construit l'image rootfs
lb_binary_syslinux(1)
installe syslinux dans le binaire
lb_binary_tar(1)
construit une image binaire pour disque dur
lb_binary_hdd(1)
construit une image binaire hdd
lb_binary_win32-loader(1)
installe win32-loader dans le binaire

Commandes source

lb_source_debian(1)
télécharge les sources
lb_source_debian-live(1)
copie la configuration debian-live dans la source
lb_source_disk(1)
installe les informations de disque dans la source
lb_source_iso(1)
construit l'image source iso
lb_source_checksums(1)
crée les sommes de vérification binaires (md5, sha1, et/ou sha256)
lb_source_net(1)
construit l'image net source
lb_source_tar(1)
construit le tarball source
lb_source_hdd(1)
construit l'image hdd source

FICHIERS DE CONFIGURATION

Plusieurs commandes live-build utilisent des fichiers dans le répertoire config/ pour contrôler ce qu'elles font. En plus du config/common commun, qui est utilisé par toutes les commandes live-build, plusieurs fichiers additionels peuvent être utilisés pour configurer le comportement de commandes live-build spécifiques. Ces fichiers sont typiquement nommés config/stage ou config/stage_assistant (où "stage" est évidemment remplacé par le nom du stage auquel il appartient, "assistant" par le nom de l'assistant).

Par exemple, lb_bootstrap_debootstrap utilise des fichiers nommés config/bootstrap et config/bootstrap_debootstrap pour lire les options qu'il utilisera. Voir les pages des commandes individuelles de manuel pour des détails à propos des noms et des formats de fichiers qu'ils utilisent. Généralement, ces fichiers contiennent des variables avec des valeurs assignées, une variable par ligne. Plusieurs programmes dans live-build utilisent des paires de valeur ou des assignations de variables légèrement plus compliquées.

Notez que live-build respectera les variables d'environment présentes dans le contexte du shell lancé. Si les variables peuvent être lues depuis les fichiers de configuration, alors elles prennent le pas sur les variables d'environement, et si les options en ligne de commande sont utilisées, elles sont prioritaires sur les fichiers de configuration. Si pour une variable donnée, aucune valeur ne peut être trouvée et donc, est non-paramétrèe, live-build la paramètrera automatiquement à la valeur par défaut.

Dans de rares cas, vous pourriez vouloir avoir différentes versions de ces fichiers pour différentes architectures ou distributions. Si des fichiers nommés config/stage.arch ou config/stage_assistant.arch, et config/stage.dist ou config/stage_assistant.dist existent, où "arch" est équivalent à la sortie de "dpkg --print-architecture" et "dist" équivalent au nom de code de la distribution cible, alors ils seront utilisés en priorité aux autres fichier plus généraux.

Tous les fichiers de configuration sont des scripts shell qui sont sourcés par un programme live-build. Ceci signifie qu'ils doivent suivre la syntaxe de shell normale. Vous pouvez également mettre des commentaires dans ces fichiers; les lignes commençant par des "#" sont ignorées.

FICHIERS

/etc/live/build.conf
/etc/live/build/*

PAGE D'ACCUEIL

Davantage d'informations à propos de live-build et du projet Live Systems peuvent être trouvées sur la page d'accueil à <http://live-systems.org/> et dans le manuel à <http://live-systems.org/manual/>.

BOGUES

Les bogues peuvent être signalés en soumettant un rapport de bogue pour le paquet live-build dans le BTS à <http://bugs.debian.org/> ou par l'écriture d'un courriel à la liste de diffusion Live Systems à <[email protected]>.

AUTEUR

live-images a été écrit par Daniel Baumann <[email protected]>.