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

AUTEUR

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