Manpages

名 前

lb_config - Create config directory

概 要

lb config [live-build オ プ シ ョ ン ]

lb config
[--apt apt|aptitude]
[--apt-ftp-proxy URL]
[--apt-http-proxy URL]
[--apt-indices true|false]
[--apt-options オ プ シ ョ ン |"オ プ シ ョ ン "]
[--apt-pipeline 深 度 ]
[--apt-recommends true|false]
[--apt-secure true|false]
[--apt-source-archives true|false]
[--aptitude-options オ プ シ ョ ン |"オ プ シ ョ ン "]
[-a|--architectures ア ー キ テ ク チ ャ ]
[--archive-areas ア ー カ イ ブ 領 域 |"ア ー カ イ ブ 領 域 "]
[--backports true|false]
[--binary-filesystem fat16|fat32|ext2|ext3|ext4|ntfs]
[-b|--binary-images iso|iso-hybrid|netboot|tar|hdd]
[--bootappend-install パ ラ メ ー タ |"パ ラ メ ー タ "]
[--bootappend-live パ ラ メ ー タ |"パ ラ メ ー タ "]
[--bootappend-live-failsafe PARAMETER|"PARAMETERS"]
[--bootloaders grub-legacy|grub-pc|syslinux|grub-efi]
[--bootstrap-qemu-arch ARCH]
[--bootstrap-qemu-exclude PACKAGES]
[--bootstrap-qemu-static PATH]
[--breakpoints]

[--cache true|false]
[--cache-indices true|false]
[--cache-packages true|false]
[--cache-stages 段 階 |"段 階 "]
[--checksums md5|sha1|sha224|sha256|sha384|sha512|none]
[--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none]
[--clean]
[--color]

[-c|--conffile フ ァ イ ル ]
[--config GIT_URL::GIT_BRANCH]
[--debconf-frontend dialog|editor|noninteractive|readline]
[--debconf-priority low|medium|high|critical]
[--debian-installer true|cdrom|netinst|netboot|businesscard|live|false]
[--debian-installer-distribution daily|コ ー ド 名 ]
[--debian-installer-gui true|false]
[--debian-installer-preseedfile フ ァ イ ル |URL]
[--debootstrap-options OPTIONS]
[--debootstrap-script SCRIPT]
[--debug]
[-d|--distribution コ ー ド 名 ]
[--distribution-chroot CODENAME]
[--distribution-binary CODENAME]
[--dump]
[--fdisk fdisk|fdisk.dist]
[--firmware-binary true|false]
[--firmware-chroot true|false]
[--force]
[--grub-splash フ ァ イ ル ]
[--gzip-options オ プ シ ョ ン |"オ プ シ ョ ン "]
[--hdd-label LABEL]
[--hdd-partition-start START]
[--hdd-size SIZE]
[--ignore-system-defaults]
[--image-name NAME]
[--initramfs none|live-boot]
[--initramfs-compression bzip2|gzip|lzma]
[--initsystem sysvinit|systemd|none]
[--interactive shell]
[--iso-application 名 前 ]
[--iso-preparer NAME]
[--iso-publisher 名 前 ]
[--iso-volume 名 前 ]
[--isohybrid-options オ プ シ ョ ン |"オ プ シ ョ ン "]
[--jffs2-eraseblock サ イ ズ ]
[--keyring-packages パ ッ ケ ー ジ |"パ ッ ケ ー ジ "]
[-k|--linux-flavours フ レ ー バ ー |"フ レ ー バ ー "]
[--linux-packages "パ ッ ケ ー ジ "]
[--loadlin true|false]
[--losetup losetup|losetup.orig]
[--memtest memtest86+|memtest86|none]
[--mirror-binary URL]
[--mirror-binary-security URL]
[--mirror-bootstrap URL]
[--mirror-chroot URL]
[--mirror-chroot-security URL]
[--mirror-debian-installer URL]
[--mode debian|progress-linux]
[--net-cow-filesystem nfs|cfs]
[--net-cow-mountoptions オ プ シ ョ ン ]
[--net-cow-path パ ス ]
[--net-cow-server IPア ド レ ス |ホ ス ト 名 ]
[--net-root-filesystem nfs|cfs]
[--net-root-mountoptions オ プ シ ョ ン ]
[--net-root-path パ ス ]
[--net-root-server IPア ド レ ス |ホ ス ト 名 ]
[--net-tarball true|false]
[--onie true|false]
[--onie-kernel-cmdline "OPTION1 OPTION2"]
[--parent-archive-areas ARCHIVE_AREA|"ARCHIVE_AREAS"]
[--parent-debian-installer-distribution コ ー ド 名 ]
[--parent-distribution コ ー ド 名 ]
[--parent-distribution-chroot CODENAME]
[--parent-distribution-binary CODENAME]
[--parent-mirror-binary URL]
[--parent-mirror-binary-security URL]
[-m|--parent-mirror-bootstrap URL]
[--parent-mirror-chroot URL]
[--parent-mirror-chroot-security URL]
[--parent-mirror-debian-installer URL]
[--quiet]
[--security true|false]
[--source true|false]
[-s|--source-images iso|netboot|tar|hdd]
[--swap-file-path PATH]

[--tasksel apt|aptitude|tasksel]
[--uefi-secure-boot auto|enable|disable]
[--updates true|false]
[--verbose]
[--win32-loader true|false]
[--zsync true|false]

説 明

lb config は Live シ ス テ ム ツ ー ル 集 live-build(7) の 高 レ ベ ル コ マ ン ド (porcelain) で す 。

lb config populates the configuration directory for live-build. This directory is named ’config’ and is created in the current directory where lb config was executed.

Note: lb config tries to be smart and sets defaults for some options depending on the setting of other options. This means that when generating a new configuration, you should call lb config only once with all options specified. Calling it several times with only a subset of the options each can result in non working configurations. This is also caused by the fact that lb config called with one option only changes that option, and leaves everything else as is unless it is not defined. However, lb config does warn about know impossible or likely impossible combinations that would lead to non working live systems. If unsure, remove config/{binary,bootstrap,chroot,common,source} and call lb config again.

オ プ シ ョ ン

lb config は 固 有 の オ プ シ ョ ン に 加 え 、 live-build 全 般 の オ プ シ ョ ン を 全 て 理 解 し ま す 。 live-build 全 般 の オ プ シ ョ ン の 全 容 に つ い て は live-build(7) を 見 て く だ さ い 。
--apt apt|aptitude イ メ ー ジ の ビ ル ド 時 に パ ッ ケ ー ジ を イ ン ス ト ー ル す る の に apt-get と aptitude の ど ち ら を 利 用 す る か 決 定 し ま す 。 デ フ ォ ル ト は apt で す 。
--apt-ftp-proxy URL

apt に よ り 利 用 す る ftp プ ロ キ シ を セ ッ ト し ま す 。 デ フ ォ ル ト で は 利 用 し ま せ ん 。 こ の 変 数 は chroot 内 で 利 用 す る apt で の み 有 効 で 、 そ れ 以 外 で は 利 用 さ れ な い こ と に 注 意 し て く だ さ い

--apt-http-proxy URL

apt に よ り 利 用 す る http プ ロ キ シ を セ ッ ト し ま す 。 デ フ ォ ル ト で は 利 用 し ま せ ん 。 こ の 変 数 は chroot 内 で 利 用 す る apt で の み 有 効 で 、 そ れ 以 外 で は 利 用 さ れ な い こ と に 注 意 し て く だ さ い

--apt-indices true|false

defines if the resulting images should have apt indices or not and defaults to true.

--apt-options オ プ シ ョ ン |"オ プ シ ョ ン " イ メ ー ジ の ビ ル ド 時 に chroot 内 で apt を 利 用 す る 際 に 毎 回 付 加 さ れ る デ フ ォ ル ト の オ プ シ ョ ン を 決 定 し ま す 。 デ フ ォ ル ト で は --yes が セ ッ ト さ れ て い て 、 パ ッ ケ ー ジ の 対 話 的 で は な い イ ン ス ト ー ル 処 理 が で き る よ う に な っ て い ま す 。
--apt-pipeline 深 度

apt/aptitude の パ イ プ ラ イ ン の 深 さ を 決 定 し ま す 。 リ モ ー ト の サ ー バ が RFCに 準 拠 し て い な い あ る い は バ グ が 多 い (Squid 2.0.2 等 ) の 場 合 、 こ の オ プ シ ョ ン で 「 0」 か ら 「 5」 ま で の 値 を 指 定 し 、 APTが 送 る べ き 処 理 中 リ ク エ ス ト の 数 を 指 示 で き ま す 。 リ モ ー ト ホ ス ト が TCP接 続 を 適 切 に 残 さ な い 場 合 は 「 0」 を 指 定 *し な い と い け ま せ ん * - そ う し な い 場 合 は デ ー タ の 破 損 が 発 生 し ま す 。 こ れ を 必 要 と す る ホ ス ト は RFC 2068 に 違 反 し て い ま す 。 デ フ ォ ル ト で live-build は こ の オ プ シ ョ ン を セ ッ ト し て い ま せ ん 。

--apt-recommends true|false

aptが 推 奨 パ ッ ケ ー ジ を 自 動 的 に イ ン ス ト ー ル す べ き か 否 か を 決 定 し ま す 。 デ フ ォ ル ト は true で す 。

--apt-secure true|false

aptが リ ポ ジ ト リ の 署 名 を 確 認 す べ き か 否 か を 決 定 し ま す 。 デ フ ォ ル ト は true で す 。

--apt-source-archives true|false 作 成 さ れ る Live イ メ ー ジ に deb-src の 行 を 収 録 す べ き か 否 か を 決 定 し ま す 。 デ フ ォ ル ト は true で す 。
--aptitude-options オ プ シ ョ ン |"オ プ シ ョ ン " イ メ ー ジ の ビ ル ド 時 に chroot 内 で aptitude を 利 用 す る 際 に 毎 回 付 加 さ れ る デ フ ォ ル ト の オ プ シ ョ ン を 決 定 し ま す 。 デ フ ォ ル ト で は --assume-yes が セ ッ ト さ れ て い て 、 パ ッ ケ ー ジ の 対 話 的 で は な い イ ン ス ト ー ル 処 理 が で き る よ う に な っ て い ま す 。
-a|--architectures ア ー キ テ ク チ ャ ビ ル ド さ れ る イ メ ー ジ の ア ー キ テ ク チ ャ を 指 定 し ま す 。 デ フ ォ ル ト で は ホ ス ト の ア ー キ テ ク チ ャ が セ ッ ト さ れ ま す 。 ホ ス ト シ ス テ ム で 対 象 ア ー キ テ ク チ ャ の バ イ ナ リ を ネ イ テ ィ ブ に 実 行 で き な い 場 合 に は 別 の ア ー キ テ ク チ ャ の ク ロ ス ビ ル ド は で き な い こ と に 注 意 し て く だ さ い 。 例 え ば 64ビ ッ ト 対 応 の i386 系 列 プ ロ セ ッ サ 及 び 適 切 な カ ー ネ ル を 使 っ て い る 場 合 に は i386 で amd64 イ メ ー ジ を 、 あ る い は そ の 逆 に 、 ビ ル ド で き ま す 。 し か し i386 シ ス テ ム で powerpc 用 イ メ ー ジ を ビ ル ド す る の は 不 可 能 で す 。
--archive-areas ア ー カ イ ブ 領 域 |"ア ー カ イ ブ 領 域 " 設 定 し た Debian パ ッ ケ ー ジ ミ ラ ー に 利 用 す る Debian パ ッ ケ ー ジ ア ー カ イ ブ の パ ッ ケ ー ジ ア ー カ イ ブ 領 域 を 指 定 し ま す 。 デ フ ォ ル ト で は main と な っ て い ま す 。 こ の 仕 組 み に よ り contrib や non-free を 有 効 化 す る 際 は 、 該 当 す る 法 律 の 下 で 再 配 布 が 可 能 か ど う か 、 各 パ ッ ケ ー ジ の ラ イ セ ン ス を 忘 れ ず に 確 認 し て く だ さ い 。
--backports true|false イ メ ー ジ に backports パ ッ ケ ー ジ ア ー カ イ ブ を 収 録 す べ き か 否 か を 決 定 し ま す 。
--binary-filesystem fat16|fat32|ext2|ext3|ext4|ntfs

defines the filesystem to be used in the image type. This only has an effect if the selected binary image type lets you choose a filesystem. For example, when selection iso the resulting CD/DVD has always the filesystem ISO9660. When building hdd images for usb sticks, this is active. Note that it defaults to fat16 on all architectures except sparc where it defaults to ext4. Also note that if you choose fat16 and your resulting binary image gets bigger than 2GB, the binary filesystem automatically gets switched to fat32.

-b|--binary-images iso|iso-hybrid|netboot|tar|hdd ビ ル ド す る イ メ ー ジ の 種 類 を 決 定 し ま す 。 デ フ ォ ル ト で 、 syslinux を 利 用 す る イ メ ー ジ で は ハ ー ド デ ィ ス ク 向 け イ メ ー ジ と 同 じ よ う に も 利 用 で き る CD/DVD イ メ ー ジ を ビ ル ド す る た め iso-hybrid が 、 syslinux 以 外 の イ メ ー ジ で は iso が セ ッ ト さ れ ま す 。
--bootappend-install パ ラ メ ー タ |"パ ラ メ ー タ "

debian-installer を 収 録 し た 場 合 、 debian-installer 特 有 の ブ ー ト パ ラ メ ー タ を セ ッ ト し ま す 。

--bootappend-live パ ラ メ ー タ |"パ ラ メ ー タ "

debian-live 特 有 の ブ ー ト パ ラ メ ー タ を セ ッ ト し ま す 。 ブ ー ト パ ラ メ ー タ の 全 容 は live-boot(7) 及 び live-config(7) マ ニ ュ ア ル ペ ー ジ に あ り ま す 。

--bootappend-live-failsafe PARAMETER|"PARAMETERS"

sets boot parameters specific to debian-live failsafe boot entries. A complete list of boot parameters can be found in the live-boot(7) and live-config(7) manual pages.

--bootloaders grub-legacy|grub-pc|syslinux|grub-efi

defines which bootloader is being used in the generated image. This has only an effect if the selected binary image type lets you choose the bootloader. For example, if you build a iso, always syslinux (or more precise, isolinux) is being used. Also note that some combinations of binary images types and bootloaders may be possible but live-build does not support them yet. lb config will fail to create such a not yet supported configuration and give a explanation about it. For hdd images on amd64 and i386, the default is syslinux.

--bootstrap-qemu-arch ARCH

sets the architectures to use foreign bootstrap. Defaults to empty.

--bootstrap-qemu-exclude PACKAGES

sets the packages to exclude during foreign bootstrap. Defaults to empty.

--bootstrap-qemu-static PATH

sets the static qemu binary for foreign bootstrap. Defaults to empty.

--breakpoints

inserts pauses during the generation of the image.

--build-with-chroot true|false

live-build が バ イ ナ リ イ メ ー ジ の ビ ル ド に chroot 内 の ツ ー ル を 使 う の か 、 chroot で は な く ホ ス ト の シ ス テ ム ツ ー ル を 取 り 込 ん で 使 う の か を 決 定 し ま す 。 こ れ は 非 常 に 危 険 な オ プ シ ョ ン で あ り 、 ホ ス ト シ ス テ ム の ツ ー ル を 利 用 す る こ と で 汚 染 さ れ 、 必 要 と す る ツ ー ル (主 に syslinux や grub 等 の ブ ー ト ロ ー ダ や 、 dosfstools や xorriso、 squashfs-tools そ の 他 の 補 助 ツ ー ル ) の バ ー ジ ョ ン が ホ ス ト シ ス テ ム の も の と 対 象 デ ィ ス ト リ ビ ュ ー シ ョ ン と で ビ ル ド 時 に 存 在 す る も の と で 正 確 に 一 致 し な い と ブ ー ト 不 可 能 な イ メ ー ジ が 出 来 上 が っ て し ま う 可 能 性 も あ り ま す 。 何 を し て い る の か 正 確 に わ か っ て い て 完 全 に 結 果 を 理 解 し て い る 場 合 を 除 き 、 こ の オ プ シ ョ ン を 決 し て 無 効 化 す る こ と の な い よ う に し て く だ さ い 。

--cache true|false 全 体 と し て キ ャ ッ シ ュ を 使 う か 否 か 大 域 的 に 決 定 し ま す 。 異 な る キ ャ ッ シ ュ を 、 キ ャ ッ シ ュ そ れ ぞ れ の オ プ シ ョ ン で 制 御 で き ま す 。
--cache-indices true|false

defines if downloaded package indices and lists should be cached which is false by default. Enabling it lets you rebuild an image completely offline, however, you would not get updates anymore then.

--cache-packages true|false ダ ウ ン ロ ー ド し た パ ッ ケ ー ジ フ ァ イ ル を キ ャ ッ シ ュ す る か 否 か を 決 定 し ま す 。 デ フ ォ ル ト で true と な っ て い ま す 。 無 効 化 す る と ビ ル ド デ ィ レ ク ト リ の 容 量 を 節 約 で き ま す が 、 再 ビ ル ド し た 場 合 に は 不 要 な 転 送 が 発 生 す る こ と を 覚 え て お い て く だ さ い 。 一 般 に こ れ は 常 に true に し て お く べ き で す が 、 特 定 の ま れ な ビ ル ド 環 境 で ロ ー カ ル デ ィ ス ク を 使 う よ り も ロ ー カ ル の ネ ッ ト ワ ー ク ミ ラ ー か ら パ ッ ケ ー ジ を 再 取 得 し た 方 が 速 い こ と が あ り ま す 。
--cache-stages STAGE|"STAGES" キ ャ ッ シ ュ す る 段 階 を 指 定 し ま す 。 デ フ ォ ル ト で パ ッ ケ ー ジ 収 集 段 階 を キ ャ ッ シ ュ し ま す 。 通 常 の 段 階 を 示 す 名 前 に 対 す る 例 外 と し て 、 filesystem.{dir,ext*,squashfs} に 生 成 し た ル ー ト フ ァ イ ル シ ス テ ム だ け を キ ャ ッ シ ュ す る rootfs を 指 定 で き ま す 。 開 発 時 に バ イ ナ リ 段 階 を 再 ビ ル ド す る 際 、 ル ー ト フ ァ イ ル シ ス テ ム を 毎 回 再 生 成 す る の は 避 け た い 場 合 に こ れ は 有 用 で す 。
--checksums md5|sha1|sha224|sha256|sha384|sha512|none

defines if the binary image should contain a file called XXXsums.txt, where XXX is one of the mentioned checksum types. This file lists all files on the image together with their checksums. This in turn can be used by live-boot(7)’s built-in integrity-check to verify the medium if specified at boot prompt. In general, this should not be none and is an important feature of live system released to the public. However, during development of very big images it can save some time by not calculating the checksums.

--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none ル ー ト フ ァ イ ル シ ス テ ム の イ メ ー ジ と し て 利 用 す る フ ァ イ ル シ ス テ ム の 種 類 を 決 定 し ま す 。 none を 指 定 し た 場 合 は フ ァ イ ル シ ス テ ム イ メ ー ジ は 作 成 さ れ ず 、 ル ー ト フ ァ イ ル シ ス テ ム の 内 容 は 非 圧 縮 フ ァ イ ル と し て バ イ ナ リ イ メ ー ジ フ ァ イ ル シ ス テ ム に コ ピ ー さ れ ま す 。 選 択 し た バ イ ナ リ フ ァ イ ル シ ス テ ム に よ っ て は 、 こ う い っ た そ の ま ま の ル ー ト フ ァ イ ル シ ス テ ム の ビ ル ド が で き な い も の も あ り ま す 。 例 え ば fat16/fat32 で は linux か ら の 直 接 の 実 行 を サ ポ ー ト し て い な い た め 機 能 し ま せ ん 。
--clean 未 使 用 の た め 内 容 が 空 の サ ブ デ ィ レ ク ト リ を 自 動 的 に 削 除 し 、 設 定 デ ィ レ ク ト リ を 最 小 に し ま す 。
--color

turns on color in the messages.

--compression bzip2|gzip|lzip|xz|none

defines the compression program to be used to compress tarballs. Defaults to none.

-c|--conffile フ ァ イ ル

uses a user specified alternative configuration file in addition to the normally used one in the config directory.

--config GIT_URL::GIT_BRANCH

bootstraps the config tree from a git repository, optionally appended by a Git Id (branch, commit, tag, etc.).

--debconf-frontend dialog|editor|noninteractive|readline

chroot 内 で の debconf フ ロ ン ト エ ン ド の 値 を 決 定 し ま す 。 デ フ ォ ル ト の noninteractive 以 外 を セ ッ ト し た 場 合 、 ビ ル ド 中 に 質 問 す る よ う に な る こ と に 注 意 し て く だ さ い 。

--debconf-priority low|medium|high|critical

chroot 内 で の debconf の 優 先 度 の 値 を 決 定 し ま す 。 デ フ ォ ル ト で は critical で 、 ほ と ん ど の 質 問 は 表 示 さ れ な く な っ て い ま す 。 こ れ は debconf フ ロ ン ト エ ン ド に noninteractive 以 外 を 指 定 し て い る 場 合 に の み 有 効 で あ る こ と に 注 意 し て く だ さ い

--debian-installer true|cdrom|netinst|netboot|businesscard|live|false 出 来 上 が っ た バ イ ナ リ イ メ ー ジ に debian-installer を 収 録 す る 場 合 に そ の 種 類 を 指 定 し ま す 。 デ フ ォ ル ト で は イ ン ス ト ー ラ は 収 録 さ れ ま せ ん 。 live 以 外 は ど れ で も 、 通 常 の debian-cd と し て 作 成 さ れ て い る イ ン ス ト ー ル 用 メ デ ィ ア と 同 等 の 設 定 を 使 い ま す 。 live を 選 択 し た 場 合 は live-installer の udeb が 収 録 さ れ る た め 、 debian-installer が 普 通 と は 異 な る 挙 動 を 取 り ま す - メ デ ィ ア や ネ ッ ト ワ ー ク の パ ッ ケ ー ジ を 使 っ て Debian シ ス テ ム を イ ン ス ト ー ル す る の で は な く 、 デ ィ ス ク に Live シ ス テ ム を イ ン ス ト ー ル し ま す 。
--debian-installer-distribution daily|コ ー ド 名

debian-installer の フ ァ イ ル を 取 得 す る デ ィ ス ト リ ビ ュ ー シ ョ ン を 決 定 し ま す 。 こ れ は 通 常 Live シ ス テ ム と 同 一 の デ ィ ス ト リ ビ ュ ー シ ョ ン に な り ま す が 、 新 し い 、 あ る い は 日 次 ビ ル ド の イ ン ス ト ー ラ を 使 い た い と き も あ り ま す 。

--debian-installer-gui true|false

debian-installer グ ラ フ ィ カ ル GTKイ ン タ ー フ ェ イ ス を true に す る か 否 か を 決 定 し ま す 。 デ フ ォ ル ト で は 、 Debian モ ー ド や Ubuntu の ほ と ん ど の バ ー ジ ョ ン で true、 そ れ 以 外 で は false と な っ て い ま す 。

--debian-installer-preseedfile フ ァ イ ル |URL オ プ シ ョ ン で 利 用 、 収 録 す る debian-installer 用 の preseed フ ァ イ ル の フ ァ イ ル 名 ま た は URLを セ ッ ト し ま す 。 config/binary_debian-installer/preseed.cfg が 存 在 す る 場 合 は そ れ が デ フ ォ ル ト で 利 用 さ れ ま す 。
--debootstrap-options OPTIONS

passes the given options to debootstrap when setting up the base system.

--debootstrap-script SCRIPT

tells debootstrap to use an alternate bootstrap script (last parameter to debootstrap).

--debug

turns on debugging informational messages.

-d|--distribution コ ー ド 名 出 来 上 が る Live シ ス テ ム の デ ィ ス ト リ ビ ュ ー シ ョ ン を 決 定 し ま す 。
--distribution-binary CODENAME

defines the distribution enabled in the resulting live system (defaults to the value set in --distribution)

--distribution-chroot CODENAME

defines the distribution used to build the live system (defaults to the value set in --distribution)

--dump

prepares a report of the currently present live system configuration and the version of live-build used. This is useful to provide if you submit bug reports, we do get all information required for us to locate and replicate an error.

--fdisk fdisk|fdisk.dist 利 用 す る ホ ス ト シ ス テ ム の fdisk バ イ ナ リ の フ ァ イ ル 名 を 指 定 し ま す 。 こ れ は 自 動 的 に 検 出 さ れ る た め 通 常 は 独 自 に 指 定 す る 必 要 は あ り ま せ ん 。
--firmware-binary true|false

includes firmware packages in debian-installer. Defaults to true.

--firmware-chroot true|false

includes firmware packages in debian-installer. Defaults to true.

--force 既 に 実 行 し た 段 階 を 強 制 的 に 再 び 実 行 し ま す 。 何 を し て い る の か わ か っ て い る 場 合 に の み 実 行 し て く だ さ い 。 通 常 、 lb build を 再 び 実 行 す る 前 に lb clean を 実 行 し て 掃 除 す る と 安 全 性 は 上 が り ま す 。
--grub-splash フ ァ イ ル オ プ シ ョ ン で 収 録 す る 、 grub ブ ー ト ロ ー ダ の ス プ ラ ッ シ ュ 画 面 に 利 用 す る 画 像 の フ ァ イ ル 名 を 指 定 し ま す 。
--gzip-options オ プ シ ョ ン |"オ プ シ ョ ン " イ メ ー ジ の ビ ル ド 時 に gzip を 利 用 す る 際 に (ほ ぼ ) 毎 回 付 加 さ れ る デ フ ォ ル ト の オ プ シ ョ ン を 決 定 し ま す 。 デ フ ォ ル ト で は --best が セ ッ ト さ れ て い て 、 圧 縮 率 の 最 も 高 い (た だ し 最 も 遅 い ) 圧 縮 を 行 い ま す 。 ホ ス ト シ ス テ ム で 対 応 し て い れ ば --rsyncable も 動 的 に 付 加 さ れ ま す 。
--hdd-label LABEL

defines the label for the hdd target. Defaults to DEBIAN_LIVE.

--hdd-partition-start START

sets the start of the partition for the hdd target for BIOSes that expect a specific boot partition start (e.g. "63s"). If empty, use optimal layout. Defaults to empty.

--hdd-size SIZE

defines the size for the hdd target. The unit is MiB. Defaults to auto, which generates the smallest possible image.

--ignore-system-defaults

lb config は デ フ ォ ル ト で 、 新 し い Live シ ス テ ム 設 定 デ ィ レ ク ト リ 生 成 時 に シ ス テ ム の デ フ ォ ル ト 値 を /etc/live/build.conf と /etc/live/build/* か ら 読 み 取 り ま す 。 こ れ は ミ ラ ー の 場 所 等 の 全 体 的 な 設 定 を 毎 回 指 定 し た く な い 場 合 に 有 用 で す 。

--image-name NAME

sets the base name of the image. Defaults to live-image.

--initramfs none|live-boot

sets the name of the package that contains the live system specific initramfs modification and defaults to live-boot. Using ’none’ is useful if the resulting system image should not be a live image (experimental).

--initramfs-compression bzip2|gzip|lzma]

initramfs の 圧 縮 に 利 用 す る 圧 縮 プ ロ グ ラ ム を 決 定 し ま す 。 デ フ ォ ル ト は gzip で す 。

--initsystem sysvinit|systemd|none]

defines the init system. Defaults to systemd.

--interactive shell

chroot 段 階 の 終 了 と バ イ ナ リ 段 階 の 開 始 の 間 に chroot 内 で 対 話 シ ェ ル へ の ロ グ イ ン を 行 い 、 手 作 業 に よ る 介 入 で き る 機 会 を 儲 け る か 否 か を 決 定 し ま す 。 シ ェ ル を ロ グ ア ウ ト ま た は 終 了 に よ り 閉 じ た 後 は 、 ビ ル ド は 通 常 と 同 様 に 続 き ま す 。 テ ス ト 以 外 で の こ の 機 能 の 利 用 は 全 く 勧 め ら れ な い こ と に 注 意 し て く だ さ い 。 Live シ ス テ ム の 全 ビ ル ド で 行 う べ き 変 更 は フ ッ ク に よ り 適 切 に 行 う よ う に し て く だ さ い 。 こ の 機 能 は ビ ル ド 過 程 を 完 全 に 自 動 化 し て 双 方 向 性 を 排 除 で き る と い う 長 所 を 破 壊 し ま す 。 こ れ は も ち ろ ん デ フ ォ ル ト で false と な っ て い ま す 。

--iso-application 名 前 出 来 上 が る CD/DVD イ メ ー ジ の ヘ ッ ダ の APPLICATION フ ィ ー ル ド を セ ッ ト し ま す 。 デ フ ォ ル ト は Debian モ ー ド で は 「 Debian Live」 、 ubuntu モ ー ド で は 「 Ubuntu Live」 と な っ て い ま す 。
--iso-preparer 名 前

sets the PREPARER field in the header of a resulting CD/DVD image. By default this is set to "live-build VERSION; https://salsa.debian.org/live-team/live-build";, where VERSION is expanded to the version of live-build that was used to build the image.

--iso-publisher 名 前

sets the PUBLISHED field in the header of a resulting CD/DVD image. By default, this is set to ’Live Systems project; https://wiki.debian.org/DebianLive; debian-live [AT] lists.org’. Remember to change this to the appropriate values at latest when you distributing custom and unofficial images.

--iso-volume 名 前 出 来 上 が る CD/DVD イ メ ー ジ の ヘ ッ ダ の VOLUME フ ィ ー ル ド を セ ッ ト し ま す 。 デ フ ォ ル ト は 「 (モ ー ド ) (デ ィ ス ト リ ビ ュ ー シ ョ ン ) (日 時 )」 で 、 モ ー ド は 現 在 利 用 し て い る モ ー ド 、 デ ィ ス ト リ ビ ュ ー シ ョ ン は デ ィ ス ト リ ビ ュ ー シ ョ ン の 名 前 、 日 時 は 作 成 時 の 日 付 と 時 刻 に 展 開 さ れ ま す 。
--isohybrid-options オ プ シ ョ ン |"オ プ シ ョ ン "

isohybrid に 渡 す オ プ シ ョ ン を 指 定 し ま す 。

--jffs2-eraseblock サ イ ズ

JFFS2 (Second Journaling Flash File System) フ ァ イ ル シ ス テ ム の eraseblock の サ イ ズ を 指 定 し ま す 。 デ フ ォ ル ト は 64 KiB と な っ て い ま す 。 対 象 の MTD デ バ イ ス と 一 致 し な い 値 を こ れ に 指 定 し た 場 合 は JFFS2 が 最 適 に 機 能 し な く な る か も し れ ま せ ん 。 サ イ ズ に 4096 未 満 の 値 が 指 定 さ れ た 場 合 は KiB 単 位 の 値 が 指 定 さ れ た も の と 仮 定 し ま す 。

--keyring-packages パ ッ ケ ー ジ |"パ ッ ケ ー ジ " キ ー リ ン グ パ ッ ケ ー ジ や 追 加 の キ ー リ ン グ パ ッ ケ ー ジ を セ ッ ト し ま す 。 デ フ ォ ル ト で は debian-archive-keyring と な っ て い ま す 。
-k|--linux-flavours フ レ ー バ ー |"フ レ ー バ ー "

sets the kernel flavours to be installed. Note that in case you specify more than that the first will be configured the default kernel that gets booted. Optionally you can use an architecture qualifier, e.g. amd64:amd64. Given an i386 system you can enable amd64 foreign architecture thanks to the commands: "dpkg --add-architecture amd64 ; apt-get update". This enables you to use "686 amd64:amd64" as a linux flavour. The amd64 kernel will be installed alongside the i386’s 686 kernel.

--linux-packages "パ ッ ケ ー ジ " カ ー ネ ル の パ ッ ケ ー ジ 命 名 規 則 に 従 っ た 内 部 名 を セ ッ ト し ま す 。 Debian の カ ー ネ ル パ ッ ケ ー ジ を 利 用 し て い る 場 合 は 調 整 す る 必 要 は あ り ま せ ん 。 Debian の 命 名 規 則 に 従 わ な い 独 自 の カ ー ネ ル パ ッ ケ ー ジ を 利 用 す る 場 合 に は こ の オ プ シ ョ ン で パ ッ ケ ー ジ の 前 半 部 (Debian の 場 合 は linux-image-2.6) だ け を 忘 れ ず に 指 定 し 、 前 半 部 -フ レ ー バ ー (Debian の 場 合 は 例 え ば linux-image-686-pae) が 有 効 な パ ッ ケ ー ジ 名 に な る よ う に し て く だ さ い 。 好 ま し い の は 、 メ タ パ ッ ケ ー ジ が あ る 場 合 に は そ の 名 前 を 前 半 部 に 使 う こ と で 、 そ う す る と 設 定 と ABIが 独 立 し ま す 。 ま た 、 unionfs や aufs、 squashfs の バ イ ナ リ モ ジ ュ ー ル パ ッ ケ ー ジ に つ い て も 、 ツ リ ー 外 で ビ ル ド し た 場 合 に は そ の 前 半 部 を 含 め る 必 要 が あ る こ と を 忘 れ な い よ う に し て く だ さ い 。
--loadlin true|false

sets loadlin. Defaults to false, except when the debian-installer is included for x86_64 or i386.

--losetup losetup|losetup.orig 利 用 す る ホ ス ト シ ス テ ム の losetup バ イ ナ リ の フ ァ イ ル 名 を 指 定 し ま す 。 こ れ は 自 動 的 に 検 出 さ れ る た め 通 常 は 独 自 に 指 定 す る 必 要 は あ り ま せ ん 。
--memtest memtest86+|memtest86|none 補 助 的 な ブ ー ト ロ ー ダ 設 定 と し て 、 memtest や memtest86+ を 収 録 す る か 、 あ る い は メ モ リ の テ ス ト 用 プ ロ グ ラ ム を 収 録 し な い の か を 決 定 し ま す 。 こ れ は amd64 及 び i386 で の み 利 用 可 能 で 、 デ フ ォ ル ト は memtest86+ と な っ て い ま す 。
--mirror-binary URL

sets the location of the derivative package mirror that should end up configured in the final image and which is the one a user would see and use. This has not necessarily to be the same that is used to build the image, e.g. if you use a local mirror but want to have an official mirror in the image. This defaults to http://deb.debian.org/debian/.

--mirror-binary-security URL

sets the location of the derivatives security package mirror that should end up configured in the final image. This defaults to http://security.debian.org/.

--mirror-bootstrap URL

sets the location of the debian package mirror that should be used to bootstrap the derivative from. This defaults to http://deb.debian.org/debian/.

--mirror-chroot URL

Live シ ス テ ム を ビ ル ド す る た め に 派 生 物 の パ ッ ケ ー ジ を 取 得 す る の に 利 用 す る パ ッ ケ ー ジ の ミ ラ ー の 場 所 を セ ッ ト し ま す 。 デ フ ォ ル ト で は --mirror-bootstrap で 指 定 さ れ た 値 が 利 用 さ れ ま す 。

--mirror-chroot-security URL

sets the location of the debian security package mirror that will be used to fetch the packages of the derivative in order to build the live system. By default, this points to http://security.debian.org/.

--mirror-debian-installer URL

sets the location of the mirror that will be used to fetch the debian installer images of the derivative. By default, this points to the same mirror used to build the live system, i.e. the value of --mirror-chroot.

--mode debian|progress-linux プ ロ ジ ェ ク ト 特 有 の デ フ ォ ル ト 値 を 読 み 込 む よ う に す る 大 域 モ ー ド を 指 定 し ま す 。 デ フ ォ ル ト で は debian と な っ て い ま す 。
--net-cow-filesystem nfs|cfs

copy-on-write レ イ ヤ ー の フ ァ イ ル シ ス テ ム の 種 類 を 指 定 し ま す 。 デ フ ォ ル ト は nfs で す 。

--net-cow-mountoptions オ プ シ ョ ン ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の copy-on-write レ イ ヤ ー を マ ウ ン ト す る 際 の 追 加 オ プ シ ョ ン を 指 定 し ま す 。 デ フ ォ ル ト は 空 で す 。
--net-cow-path パ ス ク ラ イ ア ン ト の 書 き 込 み 可 能 フ ァ イ ル シ ス テ ム へ の パ ス を 指 定 し ま す 。 パ ス 中 の ど こ か に client_mac_address を 指 定 す る と live-boot は そ の 部 分 を ク ラ イ ア ン ト の MACア ド レ ス を ハ イ フ ン で 区 切 っ た も の に 置 き 換 え ま す 。

/export/hosts/client_mac_address
/export/hosts/00-16-D3-33-92-E8

--net-cow-server IPア ド レ ス |ホ ス ト 名 ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の copy-on-write フ ァ イ ル シ ス テ ム の ブ ー ト ロ ー ダ 設 定 で 設 定 す る IPア ド レ ス や ホ ス ト 名 を セ ッ ト し ま す 。 デ フ ォ ル ト は 空 で す 。
--net-root-filesystem nfs|cfs ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の ブ ー ト ロ ー ダ 設 定 で 設 定 す る フ ァ イ ル シ ス テ ム を 指 定 し ま す 。 デ フ ォ ル ト は nfs と な っ て い ま す 。
--net-root-mountoptions オ プ シ ョ ン ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の ル ー ト フ ァ イ ル シ ス テ ム を マ ウ ン ト す る 際 の オ プ シ ョ ン を 指 定 し ま す 。 デ フ ォ ル ト は 空 で す 。
--net-root-path パ ス ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の ブ ー ト ロ ー ダ 設 定 で 設 定 す る フ ァ イ ル の パ ス を セ ッ ト し ま す 。 デ フ ォ ル ト は Debian モ ー ド で は 「 /srv/debian-live」 、 ubuntu モ ー ド で は 「 /srv/ubuntu-live」 と な っ て い ま す 。
--net-root-server IPア ド レ ス |ホ ス ト 名 ネ ッ ト ワ ー ク 経 由 の ブ ー ト 用 イ メ ー ジ の ル ー ト フ ァ イ ル シ ス テ ム の ブ ー ト ロ ー ダ 設 定 で 設 定 す る IPア ド レ ス や ホ ス ト 名 を セ ッ ト し ま す 。 デ フ ォ ル ト は 192.168.1.1 と な っ て い ま す 。
--net-tarball true|false 圧 縮 し た tar ア ー カ イ ブ を 作 成 す る か 否 か を 決 定 し ま す 。 こ の オ プ シ ョ ン を 無 効 に す る と tar ア ー カ イ ブ は 作 成 さ れ な く な り 、 そ の 場 合 は そ の ま ま の バ イ ナ リ デ ィ レ ク ト リ が 出 力 さ れ る こ と に な り ま す 。 デ フ ォ ル ト は true で す 。
--onie true|false

defines if an ONIE.bin image is generated. ONIE binaries can be loaded by supported systems, and will in turn boot the live image. Note that iso or hybrid-iso are the only formats supported. For more information visit <http://onie.org/>. Default is false.

--onie-kernel-cmdline "OPTION1 OPTION2"

defines additional kernel command line options that the ONIE system will use when booting the image. Default is empty string.

--parent-archive-areas ARCHIVE_AREA|"ARCHIVE_AREAS" 出 来 上 が る Live シ ス テ ム の 派 生 物 の ア ー カ イ ブ 領 域 の デ ィ ス ト リ ビ ュ ー シ ョ ン を 決 定 し ま す 。
--parent-debian-installer-distribution CODENAME 出 来 上 が る Live シ ス テ ム の 派 生 元 の debian-installer の デ ィ ス ト リ ビ ュ ー シ ョ ン を 決 定 し ま す 。
--parent-distribution CODENAME 出 来 上 が る Live シ ス テ ム の 派 生 元 の デ ィ ス ト リ ビ ュ ー シ ョ ン を 決 定 し ま す 。
--parent-distribution-binary CODENAME

defines the derivative’s parent distribution enabled in the resulting live system.

--parent-distribution-chroot CODENAME

defines the derivative’s parent distribution used to build the live system.

--parent-mirror-binary URL

sets the location of the debian package mirror that should end up configured in the final image and which is the one a user would see and use. This has not necessarily to be the same that is used to build the image, e.g. if you use a local mirror but want to have an official mirror in the image. This defaults to the value of --mirror-binary.

--parent-mirror-binary-security URL

sets the location of the debian security package mirror that should end up configured in the final image. This defaults to the value of --mirror-binary-security.

-m|--parent-mirror-bootstrap URL

sets the location of the debian package mirror that should be used to bootstrap from. This defaults to the value of --mirror-tstrap.

--parent-mirror-chroot URL

sets the location of the debian package mirror that will be used to fetch the packages in order to build the live system. This defaults to the value of --parent-mirror-bootstrap.

--parent-mirror-chroot-security URL

sets the location of the debian security package mirror that will be used to fetch the packages in order to build the live system. This defaults to the value of --mirror-chroot-security.

--parent-mirror-debian-installer URL

sets the location of the mirror that will be used to fetch the debian installer images. This defaults to the value of --parent-mirror-chroot.

--quiet

lb build か ら の メ ッ セ ー ジ の 出 力 を 少 な く し ま す 。

--security true|false セ キ ュ リ テ ィ ミ ラ ー オ プ シ ョ ン で 指 定 さ れ た セ キ ュ リ テ ィ リ ポ ジ ト リ を 利 用 す る か 否 か を 決 定 し ま す 。
--source true|false バ イ ナ リ イ メ ー ジ に 対 応 す る ソ ー ス イ メ ー ジ を ビ ル ド す る か 否 か を 決 定 し ま す 。 ソ ー ス パ ッ ケ ー ジ は ほ と ん ど の 人 に と っ て 不 要 で 、 ダ ウ ン ロ ー ド す る 必 要 が あ る も の は か な り 少 数 な の で 、 デ フ ォ ル ト で は false と な っ て い ま す 。 し か し 、 作 成 し た Live イ メ ー ジ の 配 布 を 始 め る 際 に は 平 行 し て 、 ソ ー ス イ メ ー ジ を 利 用 し て ビ ル ド で き る こ と を 確 認 す べ き で す 。
-s|--source-images iso|netboot|tar|hdd ソ ー ス イ メ ー ジ の イ メ ー ジ の 種 類 を 指 定 し ま す 。 デ フ ォ ル ト は tar で す 。
--swap-file-path パ ス バ イ ナ リ イ メ ー ジ 中 に 作 成 す る ス ワ ッ プ フ ァ イ ル の パ ス を 指 定 し ま す 。 デ フ ォ ル ト で は ス ワ ッ プ フ ァ イ ル を 作 成 し ま せ ん 。
--swap-file-size MB ス ワ ッ プ フ ァ イ ル を 作 成 す る 場 合 の サ イ ズ を メ ガ バ イ ト で 指 定 し ま す 。 デ フ ォ ル ト は 512MB で す 。
--system live|normal 出 来 上 が る シ ス テ ム の イ メ ー ジ を Live シ ス テ ム に す る の か Live シ ス テ ム で は な い 普 通 の イ メ ー ジ に す る の か を 指 定 し ま す 。
--tasksel apt|aptitude|tasksel タ ス ク の イ ン ス ト ー ル に 利 用 す る プ ロ グ ラ ム を 選 択 し ま す 。 デ フ ォ ル ト で は tasksel と な っ て い ま す 。
--uefi-secure-boot auto|enable|disable

enables or disables Secure Boot support when using grub-efi, by installing signed shim and grub-efi packages. By default, this is set to auto, which means if the packages are available they will be installed, but if not only a warning will be printed and the normal non-signed grub-efi will be used.

--updates true|false イ メ ー ジ に updates パ ッ ケ ー ジ ア ー カ イ ブ を 収 録 す べ き か 否 か を 決 定 し ま す 。
--verbose

lb build か ら の メ ッ セ ー ジ の 出 力 を 多 く し ま す 。

--win32-loader true|false バ イ ナ リ イ メ ー ジ に win32-loader を 収 録 す べ き か 否 か を 決 定 し ま す 。
--zsync true|false

defines whether a file for distributing the image in zsync(1) format will be generated. Defaults to true.

環 境 変 数

コ マ ン ド ラ イ ン オ プ シ ョ ン は 現 在 、 対 応 す る 環 境 変 数 で も 同 様 に 指 定 で き ま す 。 し か し 、 こ の 実 装 は 将 来 の リ リ ー ス で 変 更 さ れ る 対 象 で あ り 、 基 本 的 に 使 う べ き で は あ り ま せ ん 。 live-build に 直 接 適 用 す る オ プ シ ョ ン に 対 応 す る 環 境 変 数 は LB_FOO の よ う に な り 、 例 え ば --apt-ftp-proxy は LB_APT_FTP_PROXY と な り ま す (--debug 等 の 内 部 オ プ シ ョ ン は 例 外 で す )。 他 の プ ロ グ ラ ム に 渡 さ れ る オ プ シ ョ ン に は APT_OPTIONS や GZIP_OPTIONS と 同 様 に LB_ を 付 加 し ま せ ん 。

フ ァ イ ル

auto/config
/etc/live/build.conf, /etc/live/build/*

lb config 変 数 向 け の オ プ シ ョ ン の 大 域 設 定 フ ァ イ ル で す 。 LB_PARENT_MIRROR_BOOTSTRAP の よ う な シ ス テ ム 全 体 の 少 数 の デ フ ォ ル ト を 指 定 す る の に 有 用 で す 。 こ の 機 能 は --ignore-system-defaults オ プ シ ョ ン を 指 定 す る こ と で 無 効 に で き ま す 。

関 連 項 目

live-build(7)

live-boot(7)

live-config(7) こ の プ ロ グ ラ ム は live-build の 一 部 で す 。

ホ ー ム ペ ー ジ

More information about live-build and the Live Systems project can be found on the homepage at <https://wiki.debian.org/DebianLive>.

バ グ

バ グ は <http://bugs.debian.org/> に あ る バ グ 追 跡 シ ス テ ム に live-build パ ッ ケ ー ジ の バ グ 報 告 と し て 提 出 す る か 、 <debian-live [AT] lists.org> に あ る Live シ ス テ ム の メ ー リ ン グ リ ス ト 宛 て に メ ー ル を 書 く こ と に よ り 報 告 で き ま す 。

作 者

live-build は Daniel Baumann さ ん <mail [AT] daniel-baumann.ch> に よ り 書 か れ ま し た 。