1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261
|
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LIVE\-BUILD 7 2016\-07\-28 20160601 "Live システムプロジェクト"
.SH 名前
\fBlive\-build\fP \- Live システムツール集
.SH 概要
.\" FIXME
.\" FIXME
\fBlb \fP\fIコマンド\fP [\fB\-h|\-\-help\fP] [\fB\-u|\-\-usage\fP] [\fB\-v|\-\-version\fP]
[\fB\-\-breakpoints\fP] [\fB\-\-conffile\fP] [\fB\-\-debug\fP] [\fB\-\-force\fP] [\fB\-\-quiet\fP]
[\fB\-\-verbose\fP]
.SH 説明
.\" FIXME
live\-build は Live システムのイメージをビルドするためのスクリプト集です。live\-build
の背景となる考え方は、設定ディレクトリを使って Live イメージのビルドに関するあらゆる面を完全に自動化、独自化するツール集ということです。
.PP
\fIコマンド\fPは live\-build コマンドの名前です (以下参照)。
.PP
.\" FIXME
live\-build 及び Live システムプロジェクトについてのさらなる情報は、それぞれの man ページや
<\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。
.SH オプション
.\" FIXME
.SS "live\-build 共有オプション"
以下のコマンドラインオプションは全 live\-build プログラムでサポートされています。
.IP "\fB\-h, \-\-help\fP" 4
ヘルプを表示して終了します。
.IP "\fB\-u, \-\-usage\fP" 4
使用方法を表示して終了します。
.IP "\fB\-v, \-\-version\fP" 4
バージョン情報を表示して終了します。
.SS "live\-build 共通オプション"
以下のコマンドラインオプションはほとんどの live\-build プログラムでサポートされています。各オプションの完全な説明については各プログラムの
man ページを見てください。
.IP \fB\-\-breakpoints\fP 4
ブレークポイントをたどります。
.IP \fB\-\-conffile\fP 4
独自の設定ファイルを使います。
.IP \fB\-\-debug\fP 4
デバッグ情報を表示します。
.IP \fB\-\-force\fP 4
段階ファイルが存在する場合でも強制的にヘルパーを実行します。
.IP \fB\-\-quiet\fP 4
出力するメッセージを少なくします。
.IP \fB\-\-verbose\fP 4
.\" FIXME
出力するメッセージを多くします。
.SH "LIVE\-BUILD コマンド"
.\" FIXME
live\-build は高レベル (「porcelain」) コマンドと低レベル (「plumbing」) コマンドに分割されています。
.PP
.\" FIXME
利用可能な全 live\-build コマンドの一覧です。詳しくはそれぞれの man ページを見てください。
.SH "高レベルコマンド (PORCELAIN)"
.\" FIXME
高レベルコマンドは主要コマンドといくらかの副次的なユーザ向けユーティリティに分けられています。
.SS 主要コマンド
.IP \fBlb_config\fP(1) 4
live\-build の設定ファイルを作成します
.IP \fBlb_bootstrap\fP(1) 4
第1の段階で基本的な debian システムのパッケージ収集を行います
.IP \fBlb_chroot\fP(1) 4
第2の段階で chroot の独自化を行います
.IP \fBlb_binary\fP(1) 4
第3の段階でバイナリイメージの生成を行います
.IP \fBlb_source\fP(1) 4
オプションの第4の段階でソースイメージの生成を行います
.IP \fBlb_clean\fP(1) 4
システムのビルド用ディレクトリを掃除します
.SS 副次的なコマンド
.IP \fBlb\fP(1) 4
live\-build の包括的なラッパー
.IP \fBlb_build\fP(1) 4
全段階のラッパーです
.IP \fBlb_local\fP(1) 4
ローカルの live\-build を利用する支援コマンド
.IP \fBlb_testroot\fP(1) 4
.\" FIXME
システムが root により構成されていることを確認します
.SH "低レベルコマンド (PLUMBING)"
.\" FIXME
live\-build
の実際の作業は低レベルコマンドにより実装されています。低レベルコマンドはエンドユーザが直接実行することは想定していません。高レベルの主要コマンドに操作させることにより、様々な低レベルコマンドを必ず正しい順で実行するようにしています。しかし、live\-build
コマンドを自分のスクリプトで再利用したい場合はこの低レベルコマンドが対象となるかもしれません。
.PP
この低レベルコマンドへのインターフェイス (オプション群やセマンティクス)
は高レベルの主要コマンドよりもはるかに安定していることが求められることに注意してください。それに対して高レベルの主要コマンドへのインターフェイスは、エンドユーザの使い勝手改善のために変更される対象となります。
.SS パッケージ収集用のコマンド
.IP \fBlb_bootstrap_cache\fP(1) 4
パッケージ収集段階をキャッシュします
.IP \fBlb_bootstrap_debootstrap\fP(1) 4
debootstrap(8) により Debian システムのパッケージ収集を行います
.SS "chroot コマンド"
.IP \fBlb_chroot_apt\fP(1) 4
/etc/apt/apt.conf の管理
.IP \fBlb_chroot_cache\fP(1) 4
chroot 段階をキャッシュします
.IP \fBlb_chroot_debianchroot\fP(1) 4
/etc/debian_chroot の管理
.IP \fBlb_chroot_devpts\fP(1) 4
/dev/pts をマウントします。
.IP \fBlb_chroot_dpkg\fP(1) 4
/sbin/dpkg の管理
.IP \fBlb_chroot_hacks\fP(1) 4
hacks (応急的な操作を行うスクリプト) を chroot で実行します
.IP \fBlb_chroot_hostname\fP(1) 4
/bin/hostname の管理
.IP \fBlb_chroot_hosts\fP(1) 4
/etc/hosts の管理
.IP \fBlb_chroot_install\-packages\fP(1) 4
キューにあるパッケージを chroot にインストールします
.IP \fBlb_chroot_interactive\fP(1) 4
対話的にビルドします
.IP \fBlb_chroot_linux\-image\fP(1) 4
/etc/kernel\-img.conf の管理
.IP \fBlb_chroot_hooks\fP(1) 4
ローカルフックを chroot で実行します
.IP \fBlb_chroot_local\-includes\fP(1) 4
ローカルファイルを chroot にコピーします
.IP \fBlb_chroot_packages\fP(1) 4
chroot にインストールするパッケージをキューに追加します
.IP \fBlb_chroot_local\-patches\fP(1) 4
ローカルのパッチを chroot に適用させます
.IP \fBlb_chroot_local\-preseed\fP(1) 4
ローカルにある debconf の preseed 用ファイルを利用します
.IP \fBlb_chroot_packagelists\fP(1) 4
chroot にインストールするパッケージ一覧をキューに追加します
.IP \fBlb_chroot_proc\fP(1) 4
/proc をマウントします。
.IP \fBlb_chroot_resolv\fP(1) 4
/etc/resolv.conf の管理
.IP \fBlb_chroot_selinuxfs\fP(1) 4
/selinux をマウントします。
.IP \fBlb_chroot_archives\fP(1) 4
/etc/apt/sources.list の管理
.IP \fBlb_chroot_sysfs\fP(1) 4
/sys をマウントします。
.IP \fBlb_chroot_sysv\-rc\fP(1) 4
/usr/sbin/policy\-rc.d の管理
.IP \fBlb_chroot_task\-lists\fP(1) 4
タスク一覧を chroot にインストールします
.SS バイナリコマンド
.IP \fBlb_binary_chroot\fP(1) 4
chroot を chroot にコピーします
.IP \fBlb_binary_debian\-installer\fP(1) 4
debian\-installer をバイナリにインストールします
.IP \fBlb_binary_disk\fP(1) 4
ディスク情報をバイナリにインストールします
.IP \fBlb_binary_grub\fP(1) 4
grub をバイナリにインストールします
.IP \fBlb_binary_grub2\fP(1) 4
grub2 をバイナリにインストールします
.IP \fBlb_binary_includes\fP(1) 4
ファイルをバイナリにコピーします
.IP \fBlb_binary_iso\fP(1) 4
ISOバイナリイメージをビルドします
.IP \fBlb_binary_linux\-image\fP(1) 4
linux\-image をバイナリにインストールします
.IP \fBlb_binary_local\-hooks\fP(1) 4
ローカルフックをバイナリで実行します
.IP \fBlb_binary_local\-includes\fP(1) 4
ファイルをバイナリにコピーします
.IP \fBlb_binary_local\-packagelists\fP(1) 4
ローカルパッケージ一覧をバイナリにインストールします
.IP \fBlb_binary_manifest\fP(1) 4
名簿ファイルを作成します
.IP \fBlb_binary_checksums\fP(1) 4
バイナリのチェックサム (md5、sha1、sha256 のどれか) を作成します
.IP \fBlb_binary_memtest\fP(1) 4
memtest をバイナリにインストールします
.IP \fBlb_binary_net\fP(1) 4
ネットワークブート用バイナリイメージをビルドします
.IP \fBlb_binary_rootfs\fP(1) 4
rootfs イメージをビルドします
.IP \fBlb_binary_syslinux\fP(1) 4
syslinux をバイナリにインストールします
.IP \fBlb_binary_tar\fP(1) 4
ハードディスクバイナリイメージをビルドします
.IP \fBlb_binary_hdd\fP(1) 4
バイナリhddイメージをビルドします
.IP \fBlb_binary_win32\-loader\fP(1) 4
win32\-loader をバイナリにインストールします
.SS ソースコマンド
.IP \fBlb_source_debian\fP(1) 4
ソースをダウンロードします
.IP \fBlb_source_debian\-live\fP(1) 4
debian\-live の設定をソースにコピーします。
.IP \fBlb_source_disk\fP(1) 4
ディスク情報をソースにインストールします
.IP \fBlb_source_iso\fP(1) 4
ISOソースイメージをビルドします
.IP \fBlb_source_checksums\fP(1) 4
ソースのチェックサム (md5、sha1、sha256 のどれか) を作成します
.IP \fBlb_source_net\fP(1) 4
build source net image
.IP \fBlb_source_tar\fP(1) 4
ソースの tar アーカイブをビルドします
.IP \fBlb_source_hdd\fP(1) 4
.\" FIXME
ソースhddイメージをビルドします
.SH 設定ファイル
.\" FIXME
例えば lb_bootstrap_debootstrap は利用するオプションを読み取るのに config/bootstrap 及び
config/bootstrap_debootstrap
という名のファイルを使います。利用するファイルの名前やフォーマットの詳細については個々のコマンドの man
ページを見てください。こういったファイルには一般的に、変数とそれに指定する値を1行に1件ずつ収録します。live\-build
の一部のプログラムでは組にした値や、変数の指定にわずかに複雑な方法を採っているものがあります。
.PP
例えば lb_bootstrap_debootstrap は利用するオプションを読み取るのに config/bootstrap 及び
config/bootstrap_debootstrap
という名のファイルを使います。利用するファイルの名前やフォーマットの詳細については個々のコマンドの man
ページを見てください。こういったファイルには一般的に、変数とそれに指定する値を1行に1件ずつ収録します。live\-build
の一部のプログラムでは組にした値や、変数の指定にわずかに複雑な方法を採っているものがあります。
.PP
live\-build
は実行中のシェルに存在する環境変数を尊重することに注意してください。変数が設定ファイルから読み取れる場合にはそれが環境変数より優先され、コマンドラインオプションで指定された場合にはそれが設定ファイルの値より優先されます。ある変数が見つからない、つまり値がセットされていない場合は
live\-build が自動的にデフォルト値をセットします。
.PP
一部のまれな状況で、そういったファイルにアーキテクチャやディストリビューションにより異なるものを使いたいことがあるかもしれません。「config/段階.アーキテクチャ」または「config/段階_補助.アーキテクチャ」、それと「config/段階.ディストリビューション」または「config/段階_補助.ディストリビューション」(「アーキテクチャ」には「dpkg
\-\-print\-architecture」の出力と同じもの、「ディストリビューション」には対象ディストリビューションのコード名と同じものが入ります)
という名のファイルが存在する場合には他のそれよりも一般的な名前のファイルに優先してそのファイルが利用されます。
.PP
.\" FIXME
設定ファイルは全て、live\-build
プログラムにより作成されたシェルスクリプトです。それはつまり、通常のシェル構文に従う必要があるということです。また、設定ファイルにはコメントを残しておくこともできます。「#」で始まる行は無視されます。
.SH ファイル
.IP \fB/etc/live/build.conf\fP 4
.IP \fB/etc/live/build/*\fP 4
.SH 関連項目
\fIlive\-boot\fP(7)
.PP
\fIlive\-config\fP(7)
.PP
このプログラムは live\-build の一部です。
.SH ホームページ
live\-build 及び Live
システムプロジェクトについてのさらなる情報は、<\fIhttp://live\-systems.org/\fP> のホームページや
<\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。
.SH バグ
バグは <\fIhttp://bugs.debian.org/\fP> にあるバグ追跡システムに live\-build
パッケージのバグ報告として提出するか、<\fIdebian\-live@lists.debian.org\fP> にある Live
システムのメーリングリスト宛てにメールを書くことにより報告できます。
.SH 作者
live\-build は Daniel Baumann さん <\fImail@daniel\-baumann.ch\fP>
により書かれました。
|