diff options
Diffstat (limited to 'manpages/ja/live-build.ja.7')
| -rw-r--r-- | manpages/ja/live-build.ja.7 | 341 |
1 files changed, 199 insertions, 142 deletions
diff --git a/manpages/ja/live-build.ja.7 b/manpages/ja/live-build.ja.7 index a6c63accd..19a6113d4 100644 --- a/manpages/ja/live-build.ja.7 +++ b/manpages/ja/live-build.ja.7 @@ -23,8 +23,9 @@ live\-build は Live システムのイメージをビルドするためのス \fIコマンド\fPは live\-build コマンドの名前です (以下参照)。 .PP .\" FIXME -live\-build 及び Live システムプロジェクトについてのさらなる情報は、それぞれの man ページや -<\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。 +More documentation about how to use live\-build is available in the +individual manpages for each helper and in the manual at +<\fIhttps://debian\-live.alioth.debian.org/manual/\fP>. .SH オプション .\" FIXME @@ -64,30 +65,29 @@ live\-build は高レベル (「porcelain」) コマンドと低レベル (「pl .\" 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 -システムのビルド用ディレクトリを掃除します +.IP "\fBlb config\fP(1)" 4 +creates configuration for live\-build +.IP "\fBlb bootstrap\fP(1)" 4 +executes the first build stage, creating (bootstraping) a basic Debian root +filesystem +.IP "\fBlb chroot\fP(1)" 4 +executes the second build stage, building the live OS filesystem +.IP "\fBlb installer\fP(1)" 4 +executes the third build stage, obtaining installer components (optional) +.IP "\fBlb binary\fP(1)" 4 +executes the fourth build stage, generating a binary image +.IP "\fBlb source\fP(1)" 4 +executes the fifth build stage, generating a source image (optional) +.IP "\fBlb clean\fP(1)" 4 +cleans up system build directories .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 +generic live\-build script execution wrapper +.IP "\fBlb build\fP(1)" 4 .\" FIXME -システムが root により構成されていることを確認します +alias for all build stages -.SH "低レベルコマンド (PLUMBING)" +.SH "LOW\-LEVEL COMMANDS (PLUMBING) \- BUILD STAGE COMPONENTS" .\" FIXME live\-build の実際の作業は低レベルコマンドにより実装されています。低レベルコマンドはエンドユーザが直接実行することは想定していません。高レベルの主要コマンドに操作させることにより、様々な低レベルコマンドを必ず正しい順で実行するようにしています。しかし、live\-build @@ -95,119 +95,176 @@ 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 +.SS "Bootstrap stage specific commands" +.IP "\fBlb bootstrap_archives\fP(1)" 4 +applies apt archive configuration +.IP "\fBlb bootstrap_cache\fP(1)" 4 +in save mode, saves to cache a copy of the generated bootstrap directory, +and in restore mode, restores from cache a previously generated copy +.IP "\fBlb bootstrap_debootstrap\fP(1)" 4 +creates (bootstrap) a basic Debian root filesystem using debootstrap(8) +.SS "Chroot stage specific commands" +.PP +Note: The following chroot_ prefixed commands are used in building the live +OS filesystem. Another set of similarly prefixed files are listed separately +(see further down). +.IP "\fBlb chroot_cache\fP(1)" 4 +in save mode, saves to cache a copy of the chroot directory, and in restore +mode, restores from cache a previously generated copy +.IP "\fBlb chroot_firmware\fP(1)" 4 +compiles a list of firmware packages to be installed in the live OS root +filesystem +.IP "\fBlb chroot_hacks\fP(1)" 4 +executes local hacks against the live OS root filesystem, if any are +provided +.IP "\fBlb chroot_hooks\fP(1)" 4 +executes local hooks against the live OS root filesystem, if any are +provided +.IP "\fBlb chroot_includes\fP(1)" 4 +copies a set of local files from the config directory into the live OS root +filesystem, if any are provided +.IP "\fBlb chroot_install\-packages\fP(1)" 4 +installs into the live OS root filesystem any packages listed in local +package lists +.IP "\fBlb chroot_interactive\fP(1)" 4 +pauses the build process and starts an interactive shell from the live OS +root filesystem, providing an oportunity for manual modifications or +testing; note that this is (currently) usually executed with several chroot +prep modifications applied (see description of these further down) +.IP "\fBlb chroot_linux\-image\fP(1)" 4 +compiles a list of kernel images to be installed in the live OS root +filesystem +.IP "\fBlb chroot_live\-packages\fP(1)" 4 +installs a set of live system specific packages to the live OS root +filesystem +.IP "\fBlb chroot_package\-lists\fP(1)" 4 +compiles a list of packages provided in the user\' local config to be +installed in the live OS root filesystem +.IP "\fBlb chroot_preseed\fP(1)" 4 +installs pre\-configured answers to certain install prompts into the live OS +root filesystem +.SS "Installer stage specific commands" +.IP "\fBlb installer_debian\-installer\fP(1)" 4 +obtains and sets up Debian installer(d\-i) components +.IP "\fBlb installer_preseed\fP(1)" 4 +installs pre\-configured answers to certain install prompts +.SS "Binary stage specific commands" +.IP "\fBlb binary_checksums\fP(1)" 4 +creates checksums (md5, sha1, and/or sha256) for live image content +.IP "\fBlb binary_chroot\fP(1)" 4 +duplicates the chroot directory, to place a copy of what whould be the +completed live OS root filesystem to one side, allowing the original to +continue to be used in executing certain parts of the remainder of the build +process +.IP "\fBlb binary_disk\fP(1)" 4 +creates disk information files to be added to live image +.IP "\fBlb binary_grub\fP(1)" 4 +installs grub into live image to provide image boot capability +.IP "\fBlb binary_grub2\fP(1)" 4 +installs grub2 into live image to provide image boot capability +.IP "\fBlb binary_hdd\fP(1)" 4 +compiles the final live image into an hdd image file +.IP "\fBlb binary_hooks\fP(1)" 4 +executes local hooks against the live image, if any are provided +.IP "\fBlb binary_includes\fP(1)" 4 +copies a set of local files from the config directory into the live image, +if any are provided +.IP "\fBlb binary_iso\fP(1)" 4 +compiles the final live image into an iso file +.IP "\fBlb binary_linux\-image\fP(1)" 4 +copies the linux\-image into the live image +.IP "\fBlb binary_loadlin\fP(1)" 4 +bundles a copy of loadlin into the live image +.IP "\fBlb binary_manifest\fP(1)" 4 +creates manifest of packages installed into live OS filesystem, and list of +packages to be excluded by a persistence mechanism installing the live OS to +disk +.IP "\fBlb binary_memtest\fP(1)" 4 +bundles a copy of memtest into the live image +.IP "\fBlb binary_netboot\fP(1)" 4 +compiles the final live image into a netboot tar archive +.IP "\fBlb binary_package\-lists\fP(1)" 4 +processes local lists of packages to obtain and bundle into image (from +which they could later be installed if not already) +.IP "\fBlb binary_rootfs\fP(1)" 4 +wraps up the completed live OS root filesystem into a virtual file system +image +.IP "\fBlb binary_syslinux\fP(1)" 4 +installs syslinux into live image to provide image boot capability +.IP "\fBlb binary_tar\fP(1)" 4 +compiles the final live image into a tar archive +.IP "\fBlb binary_win32\-loader\fP(1)" 4 +bundles a copy of win32\-loader into the live image and creates an +autorun.inf file +.IP "\fBlb binary_zsync\fP(1)" 4 +builds zsync control files +.SS "Source stage specific commands" +.IP "\fBlb source_checksums\fP(1)" 4 +creates checksums (md5, sha1, and/or sha256) for source image content +.IP "\fBlb source_debian\fP(1)" 4 +downloads source packages for bundling into source image +.IP "\fBlb source_disk\fP(1)" 4 +creates disk information files to be added to source image +.IP "\fBlb source_hdd\fP(1)" 4 +compiles the final source image into an hdd image file +.IP "\fBlb source_hooks\fP(1)" 4 +executes local hooks against the source image, if any are provided +.IP "\fBlb source_iso\fP(1)" 4 +compiles the final source image into an iso file +.IP "\fBlb source_live\fP(1)" 4 +copies live\-build config into source +.IP "\fBlb source_tar\fP(1)" 4 +.\" FIXME +compiles the final source image into a tar archive + +.SH "LOW\-LEVEL COMMANDS (PLUMBING) \- CHROOT PREP COMPONENTS" +.\" FIXME +The notes above under the section regarding build\-stage specific low\-level +plumbing commands also apply here. +.PP +The following chroot_ prefixed commands are used throughout the various +primary stages of the build process to apply and remove modifications to a +chroot root filesystem. Generally these are used to apply modification that +setup the chroot for use (execution of programs within it) during the build +process, and later to remove those modification, unmounting things that were +mounted, and making the chroot suitable for use as the root filesystem of +the live OS to be bundled into the live image. +.IP "\fBlb chroot_apt\fP(1)" 4 +manages apt configuration; in apply mode it applies configuration for use +during build process, and in remove mode removes that configuration +.IP "\fBlb chroot_archives\fP(1)" 4 +manages apt archive source lists; in apply mode it applies source list +configurations suitable for use of the chroot in the build process, and in +remove mode replaces that with a configuration suitable for the final live +OS +.IP "\fBlb chroot_debianchroot\fP(1)" 4 +manages a /etc/debian_chroot file +.IP "\fBlb chroot_devpts\fP(1)" 4 +manages mounting of /dev/pts +.IP "\fBlb chroot_dpkg\fP(1)" 4 +manages dpkg; in apply mode disabling things like the start\-stop\-daemon, and +in remove mode enabling them again +.IP "\fBlb chroot_hostname\fP(1)" 4 +manages the hostname configuration +.IP "\fBlb chroot_hosts\fP(1)" 4 +manages the /etc/hosts file +.IP "\fBlb chroot_proc\fP(1)" 4 +manages mounting of /proc +.IP "\fBlb chroot_resolv\fP(1)" 4 +manages configuration of the /etc/resolv.conf file +.IP "\fBlb chroot_selinuxfs\fP(1)" 4 +manages mounting of /sys/fs/selinux +.IP "\fBlb chroot_sysfs\fP(1)" 4 +manages mounting of /sys +.IP "\fBlb chroot_sysv\-rc\fP(1)" 4 +manages the /usr/sbin/policy\-rc.d file +.IP "\fBlb chroot_tmpfs\fP(1)" 4 +manages configuration of dpkg to use a tmpfs filesystem +.IP "\fBlb chroot_upstart\fP(1)" 4 .\" FIXME -ソースhddイメージをビルドします +manages use of upstart /sbin/initctl program; in apply mode blocking +execution through a dpkg diversion, and in remove mode enabling execution +again .SH 設定ファイル .\" FIXME @@ -217,11 +274,12 @@ config/bootstrap_debootstrap ページを見てください。こういったファイルには一般的に、変数とそれに指定する値を1行に1件ずつ収録します。live\-build の一部のプログラムでは組にした値や、変数の指定にわずかに複雑な方法を採っているものがあります。 .PP -例えば lb_bootstrap_debootstrap は利用するオプションを読み取るのに config/bootstrap 及び -config/bootstrap_debootstrap -という名のファイルを使います。利用するファイルの名前やフォーマットの詳細については個々のコマンドの man -ページを見てください。こういったファイルには一般的に、変数とそれに指定する値を1行に1件ずつ収録します。live\-build -の一部のプログラムでは組にした値や、変数の指定にわずかに複雑な方法を採っているものがあります。 +For example, lb bootstrap_debootstrap uses files named config/bootstrap and +config/bootstrap_debootstrap to read the options it will use. See the man +pages of individual commands for details about the names and formats of the +files they use. Generally, these files contain variables with values +assigned, one variable per line. Some programs in live\-build use pairs of +values or slightly more complicated variable assignments. .PP live\-build は実行中のシェルに存在する環境変数を尊重することに注意してください。変数が設定ファイルから読み取れる場合にはそれが環境変数より優先され、コマンドラインオプションで指定された場合にはそれが設定ファイルの値より優先されます。ある変数が見つからない、つまり値がセットされていない場合は @@ -247,9 +305,8 @@ live\-build が自動的にデフォルト値をセットします。 このプログラムは live\-build の一部です。 .SH ホームページ -live\-build 及び Live -システムプロジェクトについてのさらなる情報は、<\fIhttp://live\-systems.org/\fP> のホームページや -<\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。 +More information about live\-build and the Live Systems project can be found +on the homepage at <\fIhttps://debian\-live.alioth.debian.org/\fP>. .SH バグ バグは <\fIhttp://bugs.debian.org/\fP> にあるバグ追跡システムに live\-build |