Provided by: open-infrastructure-system-build_20161101-lts2-2_all 
名前
lb config - 設定ディレクトリを作成します
概要
lb config [live-build オプション]
lb config
[--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]
[-a|--architectures アーキテクチャ]
[-b|--binary-images iso|iso-hybrid|netboot|tar|hdd]
[--binary-filesystem fat16|fat32|ext2|ext3|ext4]
[--bootappend-install パラメータ|"パラメータ"]
[--bootappend-live パラメータ|"パラメータ"]
[--bootloader grub|grub2|syslinux]
[--cache true|false]
[--cache-indices true|false]
[--cache-packages true|false]
[--cache-stages 段階|"段階"]
[--checksums md5|sha1|sha256|none]
[--compression bzip2|gzip|lzip|none]
[--config GIT_URL::GIT_ID]
[--build-with-chroot true|false]
[--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none]
[--clean]
[-c|--conffile ファイル]
[--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-preseedfile ファイル|URL]
[--debian-installer-gui true|false]
[--debug]
[-d|--distribution コード名]
[--parent-distribution コード名]
[--parent-debian-installer-distribution コード名]
[--dump]
[--fdisk fdisk|fdisk.dist]
[--firmware-binary true|false]
[--firmware-chroot true|false]
[--force]
[--grub-splash ファイル]
[--gzip-options オプション|"オプション"]
[--hooks ファイル]
[--ignore-system-defaults]
[--initramfs auto|none|live-boot|casper]
[--initramfs-compression bzip2|gzip|lzma]
[--initsystem sysvinit|runit|systemd|upstart|none]
[--interactive shell]
[--isohybrid-options オプション|"オプション"]
[--iso-application 名前]
[--iso-preparer NAME]
[--iso-publisher 名前]
[--iso-volume 名前]
[--jffs2-eraseblock サイズ]
[--keyring-packages パッケージ|"パッケージ"]
[-k|--linux-flavours フレーバー|"フレーバー"]
[--linux-packages "パッケージ"]
[--losetup losetup|losetup.orig]
[--memtest memtest86+|memtest86|none]
[-m|--parent-mirror-bootstrap URL]
[--parent-mirror-chroot URL]
[--parent-mirror-chroot-security URL]
[--parent-mirror-chroot-updates URL]
[--parent-mirror-chroot-backports URL]
[--parent-mirror-binary URL]
[--parent-mirror-binary-security URL]
[--parent-mirror-binary-updates URL]
[--parent-mirror-binary-backports URL]
[--parent-mirror-debian-installer URL]
[--mirror-bootstrap URL]
[--mirror-chroot URL]
[--mirror-chroot-security URL]
[--mirror-chroot-updates URL]
[--mirror-chroot-backports URL]
[--mirror-binary URL]
[--mirror-binary-security URL]
[--mirror-binary-updates URL]
[--mirror-binary-backports URL]
[--mirror-debian-installer URL]
[--mode debian|progress-linux|ubuntu]
[--system live|normal]
[--net-root-filesystem nfs|cfs]
[--net-root-mountoptions オプション]
[--net-root-path パス]
[--net-root-server IPアドレス|ホスト名]
[--net-cow-filesystem nfs|cfs]
[--net-cow-mountoptions オプション]
[--net-cow-path パス]
[--net-cow-server IPアドレス|ホスト名]
[--net-tarball true|false]
[--quiet]
[--archive-areas アーカイブ領域|"アーカイブ領域"]
[--parent-archive-areas 親アーカイブ領域|"親アーカイブ領域"]
[--security true|false]
[--source true|false]
[-s|--source-images iso|netboot|tar|hdd]
[--tasksel apt|tasksel]
[--templates パス]
[--hdd-size MB]
[--updates true|false]
[--backports true|false]
[--verbose]
[--win32-loader true|false]
説明
lb config は Live システムツール集 live-build(7) の高レベルコマンド (porcelain) です。
lb config は live-build の設定ディレクトリを用意します。デフォルトで、このディレクトリは
「config」という名で、lb config が実行された現在のディレクトリに作成されます。
注意: 現在 lb config は気を利かせようとして、他のオプションの設定に依存する一部のオプショ
ンのデフォルト値をセット (例えば利用する linux パッケージをビルドしようとしているのが
wheezy システムがどうかにより判断) します。これはつまり、新しい設定を生成する際はオプショ
ンを全て指定して lb config を一度だけ実行すべきだということです。一部のオプションだけを指
定して何度も実行した場合には、その度に使えない設定が出来る可能性があります。変更するオプ
ションだけを指定して lb config を実行した場合、指定されていないオプションは、定義されてい
る限りは全てそのまま維持されるためにこれが起きることもあります。ただし、不可能あるいはほぼ
不可能な組み合わせであることがわかっていて使えない Live システムを作成することになりそうな
ときには lb config それについて警告します。よくわからない場合は
config/{binary,bootstrap,chroot,common,source} を削除して再び lb config を実行してくださ
い。
オプション
lb config は固有のオプションに加え、live-build 全般のオプションを全て理解しま
す。live-build 全般のオプションの全容については live-build(7) を見てください。
--apt-ftp-proxy URL
apt により利用する ftp プロキシをセットします。デフォルトでは利用しません。この変数は
chroot 内で利用する apt でのみ有効で、それ以外では利用されないことに注意してください
--apt-http-proxy URL
apt により利用する http プロキシをセットします。デフォルトでは利用しません。この変数は
chroot 内で利用する apt でのみ有効で、それ以外では利用されないことに注意してください
--apt-indices true|false|none
作成されるイメージに apt の索引ファイルを収録するか否かを決定します。デフォルトは true
です。none をセットすると索引ファイルは一切収録されません。
--apt-options オプション|"オプション"
イメージのビルド時に chroot 内で apt を利用する際に毎回付加されるデフォルトのオプショ
ンを決定します。デフォルトでは --yes がセットされていて、パッケージの対話的ではないイ
ンストール処理ができるようになっています。
--apt-pipeline 深度
apt のパイプラインの深さを決定します。リモートのサーバが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 です。
-a|--architectures アーキテクチャ
ビルドされるイメージのアーキテクチャを指定します。デフォルトではホストのアーキテクチャ
がセットされます。ホストシステムで対象アーキテクチャのバイナリをネイティブに実行できな
い場合には別のアーキテクチャのクロスビルドはできないことに注意してください。例え
ば64ビット対応の i386 系列プロセッサ及び適切なカーネルを使っている場合には i386 で
amd64 イメージを、あるいはその逆に、ビルドできます。しかし i386 システムで powerpc 用
イメージをビルドするのは不可能です。
-b|--binary-images iso|iso-hybrid|netboot|tar|hdd
ビルドするイメージの種類を決定します。デフォルトで、syslinux を利用するイメージでは
ハードディスク向けイメージと同じようにも利用できる CD/DVD イメージをビルドするため
iso-hybrid が、syslinux 以外のイメージでは iso がセットされます。
--binary-filesystem fat16|fat32|ext2|ext3|ext4
指定した種類のイメージで利用するファイルシステムを指定します。これは選択した種類のバイ
ナリイメージでファイルシステムを選択できる場合にのみ効果があります。例えば iso 選択時
に作成される CD/DVD のファイルシステムは常に ISO9660 となります。USBメモリ向けのhddイ
メージをビルドする場合にはこれが有効になります。sparc のデフォルトが ext4 である例外を
除く全アーキテクチャでデフォルトが fat16 となっていることに注意してください。ま
た、fat16 選択時に出来上がったバイナリイメージのサイズが2GBを超えた場合はそのバイナリ
のファイルシステムは自動的に fat32 に切り替えられることに注意してください。
--bootappend-install パラメータ|"パラメータ"
debian-installer を収録した場合、debian-installer 特有のブートパラメータをセットしま
す。
--bootappend-live パラメータ|"パラメータ"
debian-live 特有のブートパラメータをセットします。ブートパラメータの全容は
live-boot(7) 及び live-config(7) マニュアルページにあります。
--bootloader grub|grub2|syslinux
生成されたイメージで利用するブートローダを選択します。これは選択した種類のバイナリイ
メージでブートローダを選択できる場合にのみ効果があります。例えば iso をビルドする場合
は常に syslinux (さらに言えば isolinux) が利用されます。また、バイナリイメージの種類と
ブートローダの組み合わせの中には、可能ではあるものの live-build でのサポートが追いつい
ていないものがあり得ることに注意してください。lb config はそういった未サポートの設定の
作成には失敗し、そのことについて説明します。amd64 や i386 用のhddイメージでは syslinux
がデフォルトとなっています。
--cache true|false
全体としてキャッシュを使うか否か大域的に決定します。異なるキャッシュを、キャッシュそれ
ぞれのオプションで制御できます。
--cache-indices true|false
ダウンロードしたパッケージ索引や一覧をキャッシュするか否かを決定します。デフォルトで
false となっています。有効にするとイメージを完全にオフラインで再ビルドできるようになり
ますが、以後の更新は得られなくなります。
--cache-packages true|false
ダウンロードしたパッケージファイルをキャッシュするか否かを決定します。デフォルトで
true となっています。無効化するとビルドディレクトリの容量を節約できますが、再ビルドし
た場合には不要な転送が発生することを覚えておいてください。一般にこれは常に true にして
おくべきですが、特定のまれなビルド環境でローカルディスクを使うよりもローカルのネット
ワークミラーからパッケージを再取得した方が速いことがあります。
--cache-stages true|false|段階|"段階"
キャッシュする段階を指定します。デフォルトでパッケージ収集段階をキャッシュします。通常
の段階を示す名前に対する例外として、filesystem.{dir,ext*,squashfs} に生成したルート
ファイルシステムだけをキャッシュする rootfs を指定できます。開発時にバイナリ段階を再ビ
ルドする際、ルートファイルシステムを毎回再生成するのは避けたい場合にこれは有用です。
--checksums md5|sha1|sha256|none
バイナリイメージに md5sums.txt や sha1sums.txt、sha256sums.txt 等のファイルを収録する
か否かを決定します。この各ファイルではイメージのチェックサムとそのイメージにある全ファ
イルを列挙します。ブートプロンプトで指定した場合は live-boot 組み込みの整合性確認によ
りこれを利用してメディアを検証できます。一般にこれは false にすべきではなく、一般向け
にリリースした Live システムにとって重要な機能でもあります。しかし、巨大なイメージの開
発の際にはチェックサムを計算しないことによりいくらか時間を節約できる可能性があります。
--compression bzip2|gzip|lzip|none
tar アーカイブの圧縮に利用する圧縮プログラムを決定します。デフォルトは gzip です。
--config GIT_URL::GIT_ID
設定ツリーをgitリポジトリから取得できます。オプションとして Git Id (ブランチやコミッ
ト、タグ等) を指定できます。
--build-with-chroot true|false
live-build がバイナリイメージのビルドに chroot 内のツールを使うのか、chroot ではなくホ
ストのシステムツールを取り込んで使うのかを決定します。これは非常に危険なオプションであ
り、ホストシステムのツールを利用することで汚染され、必要とするツール (主に syslinux や
grub 等のブートローダや、dosfstools や xorriso、squashfs-tools その他の補助ツール) の
バージョンがホストシステムのものと対象ディストリビューションとでビルド時に存在するもの
とで正確に一致しないとブート不可能なイメージが出来上がってしまう可能性もあります。何を
しているのか正確にわかっていて完全に結果を理解している場合を除き、このオプションを決し
て無効化することのないようにしてください。
--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none
ルートファイルシステムのイメージとして利用するファイルシステムの種類を決定します。none
を指定した場合はファイルシステムイメージは作成されず、ルートファイルシステムの内容は非
圧縮ファイルとしてバイナリイメージファイルシステムにコピーされます。選択したバイナリ
ファイルシステムによっては、こういったそのままのルートファイルシステムのビルドができな
いものもあります。例えば fat16/fat32 では linux からの直接の実行をサポートしていないた
め機能しません。
--clean
未使用のため内容が空のサブディレクトリを自動的に削除し、設定ディレクトリを最小にしま
す。
-c|--conffile ファイル
設定ディレクトリの通常利用される設定ファイルに加え、ユーザが指定した別の設定ファイルを
使います。
--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-preseedfile ファイル|URL
オプションで利用、収録する debian-installer 用の preseed ファイルのファイル名また
はURLをセットします。config/binary_debian-installer/preseed.cfg が存在する場合はそれが
デフォルトで利用されます。
--debian-installer-gui true|false
debian-installer グラフィカルGTKインターフェイスを true にするか否かを決定します。デ
フォルトでは、Debian モードや Ubuntu のほとんどのバージョンで true、それ以外では false
となっています。
--debug
デバッグ情報のメッセージを表示します。
-d|--distribution コード名
出来上がる Live システムのディストリビューションを決定します。
-d|--parent-distribution コード名
出来上がる Live システムの派生元のディストリビューションを決定します。
-d|--parent-debian-installer-distribution コード名
出来上がる Live システムの派生元の debian-installer のディストリビューションを決定しま
す。
--dump
現在存在している Live システムの設定と利用されている live-build のバージョンの報告を作
成します。これはバグ報告の際に有用で、エラーが起きている部分を見つけ出し、再現するのに
必要となる情報を全て提供します。
--fdisk fdisk|fdisk.dist
利用するホストシステムの fdisk バイナリのファイル名を指定します。これは自動的に検出さ
れるため通常は独自に指定する必要はありません。
--force
既に実行した段階を強制的に再び実行します。何をしているのかわかっている場合にのみ実行し
てください。通常、lb build を再び実行する前に lb clean を実行して掃除すると安全性は上
がります。
--grub-splash ファイル
オプションで収録する、grub ブートローダのスプラッシュ画面に利用する画像のファイル名を
指定します。
--gzip-options オプション|"オプション"
イメージのビルド時に gzip を利用する際に (ほぼ) 毎回付加されるデフォルトのオプションを
決定します。デフォルトでは --best がセットされていて、圧縮率の最も高い (ただし最も遅
い) 圧縮を行います。ホストシステムで対応していれば --rsyncable も動的に付加されます。
--hooks ファイル
/usr/share/live/build/examples/hooks から利用できるフックから有効にするものを指定しま
す。通常、実行されるフックはありません。フックを有効にする前にそれが何をするものなの
か、確実に知って理解するようにしてください。
--ignore-system-defaults
lb config はデフォルトで、新しい Live システム設定ディレクトリ生成時にシステムのデフォ
ルト値を /etc/live/build.conf と /etc/live/build/* から読み取ります。これはミラーの場
所等の全体的な設定を毎回指定したくない場合に有用です。
--initramfs auto|none|live-boot|casper
Live システム特有の initramfs への変更を収録するパッケージの名前をセットします。デフォ
ルトは auto で、イメージの設定時ではなくビルド時に、ubuntu システムをビルドしている場
合は casper、それ以外のシステムでは live-boot に展開されます。出来上がるシステムイメー
ジが Live イメージではない場合には「none」が有用です (実験的設定値)。
--initramfs-compression bzip2|gzip|lzma]
initramfs の圧縮に利用する圧縮プログラムを決定します。デフォルトは gzip です。
--interactive shell
chroot 段階の終了とバイナリ段階の開始の間に chroot 内で対話シェルへのログインを行
い、手作業による介入できる機会を儲けるか否かを決定します。シェルをログアウトまたは終了
により閉じた後は、ビルドは通常と同様に続きます。テスト以外でのこの機能の利用は全く勧め
られないことに注意してください。Live システムの全ビルドで行うべき変更はフックにより適
切に行うようにしてください。この機能はビルド過程を完全に自動化して双方向性を排除できる
という長所を破壊します。これはもちろんデフォルトで false となっています。
--isohybrid-options オプション|"オプション"
isohybrid に渡すオプションを指定します。
--iso-application 名前
出来上がる CD/DVD イメージのヘッダの APPLICATION フィールドをセットします。デフォルト
は Debian モードでは「Debian Live」、ubuntu モードでは「Ubuntu Live」となっています。
--iso-preparer 名前
出来上がる CD/DVD イメージのヘッダの PREPARER フィールドをセットします。デフォルトは
「live-build バージョン; http://packages.qa.debian.org/live-build」で、バージョンはそ
のイメージのビルドに利用した live-build のバージョンに展開されます。
--iso-publisher 名前
出来上がる CD/DVD イメージのヘッダの PUBLISHED フィールドをセットします。デフォルトは
「Live Systems project; http:/live-systems.org/; debian-live@lists.debian.org」となっ
ています。独自の非公式イメージを配布する際はこれを忘れずに最新の適切な値に変更してくだ
さい。
--iso-volume 名前
出来上がる CD/DVD イメージのヘッダの VOLUME フィールドをセットします。デフォルトは
「(モード) (ディストリビューション) (日時)」で、モードは現在利用しているモード、ディス
トリビューションはディストリビューションの名前、日時は作成時の日付と時刻に展開されま
す。
--jffs2-eraseblock サイズ
JFFS2 (Second Journaling Flash File System) ファイルシステムの eraseblock のサイズを指
定します。デフォルトは 64 KiB となっています。対象の MTD デバイスと一致しない値をこれ
に指定した場合は JFFS2 が最適に機能しなくなるかもしれません。サイズに 4096 未満の値が
指定された場合は KiB 単位の値が指定されたものと仮定します。
--keyring-packages パッケージ|"パッケージ"
キーリングパッケージや追加のキーリングパッケージをセットします。デフォルトでは
debian-archive-keyring となっています。
-k|--linux-flavours フレーバー|"フレーバー"
インストールするカーネルの種類 (フレーバー) を指定します。複数指定した場合は最初に指定
したものがデフォルトでブートされるカーネルとして設定されることに注意してください。
--linux-packages "パッケージ"
カーネルのパッケージ命名規則に従った内部名をセットします。Debian のカーネルパッケージ
を利用している場合は調整する必要はありません。Debian の命名規則に従わない独自のカーネ
ルパッケージを利用する場合にはこのオプションでパッケージの前半部 (Debian の場合は
linux-image-2.6) だけを忘れずに指定し、前半部-フレーバー (Debian の場合は例えば
linux-image-686-pae) が有効なパッケージ名になるようにしてください。好ましいのは、メタ
パッケージがある場合にはその名前を前半部に使うことで、そうすると設定とABIが独立しま
す。また、unionfs や aufs、squashfs のバイナリモジュールパッケージについても、ツリー外
でビルドした場合にはその前半部を含める必要があることを忘れないようにしてください。
--losetup losetup|losetup.orig
利用するホストシステムの losetup バイナリのファイル名を指定します。これは自動的に検出
されるため通常は独自に指定する必要はありません。
--memtest memtest86+|memtest86|none
補助的なブートローダ設定として、memtest や memtest86+ を収録するか、あるいはメモリのテ
スト用プログラムを収録しないのかを決定します。これは amd64 及び i386 でのみ利用可能
で、デフォルトは memtest86+ となっています。
-m|--parent-mirror-bootstrap URL
パッケージ収集段階で利用するパッケージミラーの場所を指定します。デフォルトは
「http://ftp.de.debian.org/debian/」ですが、ヨーロッパ以外では適切なデフォルトではない
かもしれません。
--parent-mirror-chroot URL
Live システムをビルドするためにパッケージを取得するのに利用するパッケージのミラーの場
所をセットします。デフォルトでは --parent-mirror-bootstrap で指定された値が利用されま
す。
--parent-mirror-chroot-security URL
Live システムをビルドするためにパッケージを取得するのに利用するセキュリティパッケージ
のミラーの場所をセットします。デフォルトでは「http://security.debian.org/debian/」が利
用されます。
--parent-mirror-chroot-updates URL
Live システムをビルドするためにパッケージを取得するのに利用する updates パッケージのミ
ラーの場所をセットします。デフォルトでは --parent-mirror-chroot で指定された値が利用さ
れます。
--parent-mirror-chroot-backports URL
Live システムをビルドするためにパッケージを取得するのに利用する backports パッケージの
ミラーの場所をセットします。デフォルトでは
「http://backports.debian.org/debian-backports/」が利用されます。
--parent-mirror-binary URL
出来上がったイメージ中で設定され、ユーザが利用することになる Debian パッケージミラーの
場所を指定します。これはイメージのビルドに利用するものと同一である必要はありません。例
えばローカルミラーを利用しているけれどもイメージでは公式のミラーを使うようにしたい場
合。デフォルトでは「http://httpredir.debian.org/debian/」を利用します。
--parent-mirror-binary-security URL
最終的に出来上がるイメージで設定すべきセキュリティパッケージのミラーの場所をセットしま
す。デフォルトでは「http://security.debian.org/」が利用されます。
--parent-mirror-binary-updates URL
最終的に出来上がるイメージで設定すべき updates パッケージのミラーの場所をセットしま
す。デフォルトでは --parent-mirror-binary で指定された値が利用されます。
--parent-mirror-binary-backports URL
最終的に出来上がるイメージで設定すべき backports パッケージのミラーの場所をセットしま
す。デフォルトでは「http://backports.debian.org/debian-backports/」が利用されます。
--parent-mirror-debian-installer URL
debian インストーラのイメージを取得するのに利用するミラーの場所をセットします。デフォ
ルトでは Live システムをビルドするために利用するのと同じミラー、つまり
--parent-mirror-bootstrap で指定された値が利用されます。
--mirror-bootstrap URL
派生物のパッケージ収集段階で利用するパッケージのミラーの場所をセットします。デフォルト
は「http://ftp.de.debian.org/debian/」ですが、ヨーロッパ以外では適切なデフォルトではな
いかもしれません。
--mirror-chroot URL
Live システムをビルドするために派生物のパッケージを取得するのに利用するパッケージのミ
ラーの場所をセットします。デフォルトでは --mirror-bootstrap で指定された値が利用されま
す。
--mirror-chroot-security URL
Live システムをビルドするために派生物のパッケージを取得するのに利用するセキュリティ
パッケージのミラーの場所をセットします。デフォルトでは
「http://security.debian.org/debian/」が利用されます。
--mirror-chroot-updates URL
Live システムをビルドするために派生物のパッケージを取得するのに利用する updates パッ
ケージのミラーの場所をセットします。デフォルトでは --mirror-chroot で指定された値が利
用されます。
--mirror-chroot-backports URL
Live システムをビルドするために派生物のパッケージを取得するのに利用する backports パッ
ケージのミラーの場所をセットします。デフォルトでは
「http://backports.debian.org/debian-backports/」が利用されます。
--mirror-binary URL
出来上がったイメージ中で設定され、ユーザが利用することになる派生物のパッケージミラーの
場所を指定します。これはイメージのビルドに利用するものと同一である必要はありません。例
えばローカルミラーを利用しているけれどもイメージでは公式のミラーを使うようにしたい場
合。デフォルトでは「http://httpredir.debian.org/debian/」を利用します。
--mirror-binary-security URL
最終的に出来上がるイメージで設定すべき派生セキュリティパッケージのミラーの場所をセット
します。
--mirror-binary-updates URL
最終的に出来上がるイメージで設定すべき派生 updates パッケージのミラーの場所をセットし
ます。
--mirror-binary-backports URL
最終的に出来上がるイメージで設定すべき派生 backports パッケージのミラーの場所をセット
します。
--mirror-debian-installer URL
派生物の debian インストーラのイメージを取得するのに利用するミラーの場所をセットしま
す。デフォルトでは Live システムをビルドするために利用するのと同じミラー、つまり
--mirror-bootstrap で指定された値が利用されます。
--mode debian|progress|ubuntu
プロジェクト特有のデフォルト値を読み込むようにする大域モードを指定します。デフォルトで
は debian となっています。
--system live|normal
出来上がるシステムのイメージを Live システムにするのか Live システムではない普通のイ
メージにするのかを指定します。
--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-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-tarball true|false
圧縮した tar アーカイブを作成するか否かを決定します。このオプションを無効にすると tar
アーカイブは作成されなくなり、その場合はそのままのバイナリディレクトリが出力されること
になります。デフォルトは true です。
--quiet
lb build からのメッセージの出力を少なくします。
--archive-areas アーカイブ領域|"アーカイブ領域"
設定した Debian パッケージミラーに利用する Debian パッケージアーカイブのパッケージアー
カイブ領域を指定します。デフォルトでは main となっています。この仕組みにより contrib
や non-free を有効化する際は、該当する法律の下で再配布が可能かどうか、各パッケージのラ
イセンスを忘れずに確認してください。
--parent-archive-areas 親アーカイブ領域|"親アーカイブ領域"
出来上がる Live システムの派生物のアーカイブ領域のディストリビューションを決定します。
--security true|false
セキュリティミラーオプションで指定されたセキュリティリポジトリを利用するか否かを決定し
ます。
--source true|false
バイナリイメージに対応するソースイメージをビルドするか否かを決定します。ソースパッケー
ジはほとんどの人にとって不要で、ダウンロードする必要があるものはかなり少数なので、デ
フォルトでは false となっています。しかし、作成した Live イメージの配布を始める際には
平行して、ソースイメージを利用してビルドできることを確認すべきです。
-s|--source-images iso|netboot|tar|hdd
ソースイメージのイメージの種類を指定します。デフォルトは tar です。
--firmware-binary true|false
ファームウェアパッケージを debian-installer 用のバイナリ置き場に自動的に収録するか否か
を決定します。設定したアーカイブ領域で利用できるファームウェアパッケージだけが収録され
ることに注意してください。例えば main のパッケージだけで構成したイメージでは non-free
のファームウェアを自動的には収録しません。このオプションはバイナリパッケージ一覧で明示
的に指定したパッケージには干渉しません。
--firmware-chroot true|false
ファームウェアパッケージを Live イメージに自動的に収録するか否かを決定します。設定した
アーカイブ領域で利用できるファームウェアパッケージだけが収録されることに注意してくださ
い。例えば main のパッケージだけで構成したイメージでは non-free のファームウェアを自動
的には収録しません。このオプションはバイナリパッケージ一覧で明示的に指定したパッケージ
には干渉しません。
--swap-file-path パス
バイナリイメージ中に作成するスワップファイルのパスを指定します。デフォルトではスワップ
ファイルを作成しません。
--swap-file-size MB
スワップファイルを作成する場合のサイズをメガバイトで指定します。デフォルトは 512MB で
す。
--tasksel apt|tasksel
タスクのインストールに利用するプログラムを選択します。デフォルトでは tasksel となって
います。
--templates パス
例えばブートローダ用に live-build が利用するテンプレートへのパスを指定します。デフォル
トでは /usr/share/live/build/templates/ となっています。
--hdd-size MB
hddイメージのサイズを指定します。デフォルトは 10000 (= 10GB) となっていますが、イメー
ジファイルはわずかなファイルとして作成されるためハードディスクに 10GB の空き容量が必要
というわけではないことに注意してください。
--updates true|false
イメージに updates パッケージアーカイブを収録すべきか否かを決定します。
--backports true|false
イメージに backports パッケージアーカイブを収録すべきか否かを決定します。
--verbose
lb build からのメッセージの出力を多くします。
--win32-loader true|false
バイナリイメージに win32-loader を収録すべきか否かを決定します。
環境変数
コマンドラインオプションは現在、対応する環境変数でも同様に指定できます。しかし、この実装は
将来のリリースで変更される対象であり、基本的に使うべきではありません。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 の一部です。
ホームページ
live-build 及び Live システムプロジェクトについてのさらなる情報
は、<http://live-systems.org/> のホームページや <http://live-systems.org/manual/> のマニュ
アルにあります。
バグ
バグは <http://bugs.debian.org/> にあるバグ追跡システムに live-build パッケージのバグ報告
として提出するか、<debian-live@lists.debian.org> にある Live システムのメーリングリスト宛
てにメールを書くことにより報告できます。
作者
live-build は Daniel Baumann さん <mail@daniel-baumann.ch> により書かれました。