.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LIVE\-BOOT 7 2015\-09\-22 5.0~a5\-1 "Live システムプロジェクト"

.SH 名前
\fBlive\-boot\fP \- システム起動構成要素

.SH 説明
\fBlive\-boot\fP はブートプロセス中 (早期ユーザ空間) に Live システムを設定する構成要素を収録しています。
.PP
.\" FIXME
live\-boot は initramfs\-tools 用のフックで、例えば \fIlive\-helper\fP(7) で作成した Live
システムをブートできる initramfs を生成するのに利用します。これには Live システムの ISO やネットワーク経由でブートするための
tar アーカイブ、USB メモリ用のイメージ等があります。
.PP
.\" FIXME
これはブート時に root ファイルシステム (squashfs 等圧縮ファイルシステムのイメージであることが多い)
が置かれている「/live」ディレクトリを収録する (読み取り専用の) メディアを検索します。見つけた場合は aufs
を使って書き込み可能な環境を作成してシステムを起動します。

.SH 設定
\fBlive\-boot\fP はブートパラメータまたは設定ファイル経由で設定できます。
.PP
Live イメージで利用されるデフォルトの live\-boot パラメータを設定する場合は \fIlb_config\fP(1) マニュアルページの
\-\-bootappend\-live オプションを見てください。

.SS カーネルパラメータ
\fBlive\-boot\fP はカーネルパラメータとして「boot=live」が利用された場合にのみ有効になります。
.PP
さらに、挙動に影響するブートパラメータが他にもいくつかあります。下記を見てください。

.SS 設定ファイル
\fBlive\-boot\fP can be configured (but not activated) through configuration
files. Those files can be placed either in the root filesystem itself
(/etc/live/boot.conf, /etc/live/boot/*), or on the live media
(live/boot.conf, live/boot/*).  These environment variables can only be set
in the configuration files:

.TP 
\fBDISABLE_CDROM\fP=[\fItrue\fP|\fIfalse\fP]
Disable support for booting from CD\-ROMs.  If set to '\fItrue\fP' mkinitramfs
will build an initramfs without the kernel modules for reading CD\-ROMs.

.TP 
\fBDISABLE_FAT\fP=[\fItrue\fP|\fIfalse\fP]
Disable support for booting from FAT file systems.  If set to '\fItrue\fP'
mkinitramfs will build an initramfs without the kernel module vfat and some
nls_* modules.

.TP 
\fBDISABLE_FUSE\fP=[\fItrue\fP|\fIfalse\fP]
Disable support for booting from FUSE\-based file systems.  If set to
\&'\fItrue\fP' mkinitramfs will build an initramfs without the kernel module fuse
and file systems that depend on it (like curlftpfs and httpfs2).

.TP 
\fBDISABLE_NTFS\fP=[\fItrue\fP|\fIfalse\fP]
Disable support for booting from NTFS file systems.  If set to '\fItrue\fP'
mkinitramfs will build an initramfs without the kernel module ntfs.

.TP 
\fBDISABLE_USB\fP=[\fItrue\fP|\fIfalse\fP]
Disable support for booting from USB devices.  If set to '\fItrue\fP'
mkinitramfs will build an initramfs without the kernel module sd_mod.

.TP 
\fBMINIMAL\fP=[\fItrue\fP|\fIfalse\fP]
Build a minimal initramfs.  If set to '\fItrue\fP' mkinitramfs will build an
initramfs without some udev scripts and without rsync.

.TP 
\fBPERSISTENCE_FSCK\fP=[\fItrue\fP|\fIfalse\fP]
Run fsck on persistence filesystem on boot. Will attempt to repair
errors. The execution log will be saved in /var/log/live/fsck.log.

.TP 
\fBFSCKFIX\fP=[\fItrue\fP|\fIfalse\fP]
If PERSISTENCE_FSCK or forcefsck are set, will pass \-y to fsck to stop it
from asking questions interactively and assume yes to all queries.

.SH オプション
.\" FIXME
\fBlive\-boot\fP では以下のパラメータが現在有効です。
.IP \fBaccess\fP=\fIアクセス\fP 4
物理的または視覚的に障害のあるユーザ向けのアクセシビリティレベルをセットします。\fIアクセス\fPに入るのは v1、v2、v3、m1、m2
のどれかでないといけません。v1=軽度の視覚障害、 v2=中程度の視覚障害、 v3=盲目、 m1=運動神経に些細な難あり、
m2=運動神経に中程度の難あり。
.IP \fBconsole\fP=\fITTY,速度\fP 4
「live\-getty」オプションで利用するデフォルトのコンソールをセットします。例: 「console=ttyS0,115200」
.IP \fBdebug\fP 4
initramfs ブートプロセスの出力をもっと冗長にします。
.br
debug=1 としてください
.br
debug に値をセットしないとメッセージは表示されないかもしれません。
.IP \fBfetch\fP=\fIURL\fP 4
.IP \fBhttpfs\fP=\fIURL\fP 4
指定した URL から squashfs イメージをダウンロードしてネットワーク経由でブートする別のやり方で、この取得方法ではイメージを RAM
にコピーし、httpfs を使う方法では FUSE と httpfs2 を使ってイメージを適切な位置にマウントします。RAM
へのコピーにはさらに多くのメモリが必要で、大きなイメージでは多少時間がかかるかもしれません。しかしその後はネットワークを必要としないため正常に動作する可能性が高くなり、それ以上サーバとやりとりする必要がないためブート後はそのシステムは高速に動作します。
.br
busybox の現在の wget 及び DNS 解決の制限のために URL にはホスト名を使えず、IPアドレスにしか対応していません。
.br
機能しない: http://example.com/path/to/your_filesystem.squashfs
.br
機能する: http://1.2.3.4/path/to/your_filesystem.squashfs
.br
また、そのため httpd の名前ベースのバーチャルホストからイメージを取得することは、httpd
のそのホストの設定で同一のIPアドレスを共有している場合は現在不可能であることにも注意してください。
.br
また、squashfs イメージの適切な位置にある Live ISO イメージも利用できます。
.IP \fBiscsi\fP=\fIサーバのIPアドレス[,サーバのポート];対象の名前\fP 4
LUN (Logical Unit Number、論理ユニット番号) が iso またはディスクの Live イメージを指している iSCSI
ターゲットからのブートで、指定されたターゲットは LUN のうち Live メディアらしきものから検索されます。\fBiscsitarget\fP
ソフトウェアを使って iSCSI ターゲットを判定している場合の ietd.conf はこのようになります:
.br
# iscsi= パラメータで指定したターゲットの名前
.br
Target <ターゲットの名前>
  Lun 0 Path=<live\-image.iso のパス>,Type=fileio,IOMode=ro
  # 複数のマシンのブートに使いたい場合は
  # Wthreads や MaxConnections のような一部の
  # パラメータを調整してみるのもいいかもしれません。
.IP \fBfindiso\fP=\fI/イメージ/への/パス\fP 4
\&.squashfs ファイルを通常検索する位置にある全ディスクから、指定した ISO ファイルを検索します (そのため
fromiso=... で指定するデバイス名を知っている必要はありません)。
.IP \fBforcefsck\fP 4
Run fsck on persistence filesystem on boot. Will attempt to repair
errors. The execution log will be saved in /var/log/live/fsck.log.
.IP \fBfromiso\fP=\fI/イメージ/への/パス\fP 4
Use a filesystem from within an ISO image that's available on
live\-media. The first part of the argument should be the block device where
the image is stored, followed by the path and filename
(e.g. fromiso=/dev/sda1/live/image.iso).
.br
Alternatively, it can be used to boot from an ISO embedded into an initrd
(e.g. fromiso=/live/image.iso).
.IP \fBignore_uuid\fP 4
検出したメディアに合う initramfs に埋め込まれた UUID の確認を一切行いません。initramfs のビルド時に
LIVE_GENERATE_UUID=1 を設定して UUID を生成するように live\-boot に指示しているかもしれません。
.IP \fBverify\-checksums\fP 4
指定するとブート中に Live メディアの MD5 サムを計算し、その Live メディアのルートディレクトリにある md5sum.txt
中の値と比較します。
.IP "\fBip\fP=[\fIデバイス\fP]:[\fIクライアントのIPアドレス\fP]:[\fIネットマスク\fP]:[\fIゲートウェイのIPアドレス\fP]:[\fIネームサーバ\fP] [,[\fIデバイス\fP]:[\fIクライアントのIPアドレス\fP]:[\fIネットマスク\fP]:[\fIゲートウェイのIPアドレス\fP]:[\fIネームサーバ\fP]]" 4
Let you specify the name(s) and the options of the interface(s) that should
be configured at boot time. Do not specify this if you want to use dhcp
(default). It will be changed in a future release to mimic official kernel
boot param specification
(e.g. ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp).
.IP \fBip\fP=[\fI読み込み元メディア\fP] 4
この変数をセットすると dhcp 及び固定のネットワーク設定は単に飛ばされ、システムはメディアで事前に設定されている (設定されていないといけません)
/etc/network/interfaces を代わりに利用します。
.IP {\fBlive\-media\fP|\fBbootfrom\fP}=\fIデバイス\fP 4
この2つは等価で、どちらかを指定すると live\-boot
はまずこのデバイスについて読み取り専用のルートファイルシステムが存在するであろう「/live」ディレクトリを検索します。それで使えそうなものが見つからない場合は通常のブロックデバイスの走査が行われます。
.br
Instead of specifying an actual device name, the keyword 'removable' can be
used to limit the search of acceptable live media to removable type
only. Note that if you want to further restrict the media to usb mass
storage only, you can use the 'removable\-usb' keyword.
.IP {\fBlive\-media\-encryption\fP|\fBencryption\fP}=\fI暗号化の種類\fP 4
live\-boot はパスフレーズを質問することで暗号化する種類の rootfs をマウントできます。凝った Live システムをビルドするのに有用です
:\-)。これまでのところサポートしているのは loop\-aes 暗号化を指示する「aes」です。
.IP \fBlive\-media\-offset\fP=\fIバイト数\fP 4
このようにして、上記で指定したまたは自動検出したデバイスの、指定バイト数だけずれた位置からイメージが開始することを live\-boot
に指示できます。他の ISO やイメージの中にある Live システムの ISO
やイメージを見えないようにして「クリーン」なイメージを作成するのに有用かもしれません。
.IP \fBlive\-media\-path\fP=\fIパス\fP 4
メディア上の Live
ファイルシステムへのパスをセットします。このデフォルト値は「/live」で、合わせてメディアを独自化していない限りこの値を変更すべきではありません。
.IP \fBlive\-media\-timeout\fP=\fI秒数\fP 4
「live\-media=」により指定したデバイスがその処理をあきらめるまでの制限時間を秒数で指示します。
.IP \fBmodule\fP=\fI名前\fP 4
デフォルトとなっているオプションのファイル「filesystem.module」(以下参照)
を使う代わりに別のファイルを拡張子「.module」を外して指定することができます。これは Live
メディアの「/live」ディレクトリに配置すべきです。
.IP \fBnetboot\fP[=nfs|cifs] 4
ネットワークマウントを行うことを live\-boot に指示します。(オプションの「nfsopts=」で)
パラメータ「nfsroot=」によりルートファイルシステムが置かれている場所を指定します。引数を付けない場合はまず cifs
を試し、それが失敗した場合は nfs を試します。
.IP \fBnfsopts\fP= 4
これを使って nfs オプションを指定できます。
.IP \fBnofastboot\fP 4
このパラメータは /etc/fstab
にあるファイルシステムのチェックがデフォルトで無効化されているのを無効にします。ハードディスクに静的ファイルシステムがあり、ブート時にそれをチェックさせたい場合はこのパラメータを使ってください。使わない場合はファイルシステムのチェックは飛ばされます。
.IP \fBnopersistence\fP 4
「保持 (persistence)」機能を無効化します。ブートローダ (syslinux のようなもの)
が保持機能を有効にしてインストールされている場合に有用です。
.IP \fBnoeject\fP 4
Live メディアを取り出すかどうか確認しません。
.IP \fBramdisk\-size\fP 4
This parameter defines a custom ramdisk size (it's the '\-o size' option of
tmpfs mount). By default, there is no ramdisk size set, so the default of
mount applies (currently 50% of available RAM). Note that this option has
currently no effect when booting with toram.
.IP \fBoverlay\-size\fP=\fISIZE\fP 4
The size of the tmpfs mount (used for the upperdir union root mount) in
bytes, and rounded up to entire pages. This option accepts a suffix % to
limit the instance to that percentage of your physical RAM or a suffix k, m
or g for Ki, Mi, Gi (binary kilo (kibi), binary mega (mebi) and binary giga
(gibi)). By default, 50% of available RAM will be used.
.IP \fBswap=true\fP 4
このパラメータはローカルのスワップパーティションの利用を有効にします。
.IP \fBpersistence\fP 4
live\-boot は保持用メディアのデバイスを調査します。このデバイスにはパーティション (GPT (GUID Partition
Table、GUIDパーティションテーブル) の名前を正しく指定) やファイルシステム (ラベルの名前を正しく指定)、イメージファイル
(ファイル名を正しく指定) を使えます。保存先は「persistence」(\fIpersistence.conf\fP(5) 参照)
という名前/ラベルになります。保存先のイメージファイルは「persistence」という名前になります。
.IP "\fBpersistence\-encryption\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
This option determines which types of encryption that are allowed to be used
when probing devices for persistence media. If "none" is in the list, we
allow unencrypted media; if "luks" is in the list, we allow LUKS\-encrypted
media. Whenever a device containing encrypted media is probed the user will
be prompted for the passphrase. The default value is "none".
.IP \fBpersistence\-media\fP={\fIremovable\fP|\fIremovable\-usb\fP} 4
「removable」というキーワードを指定すると、live\-boot は保持用パーティションを脱着可能なメディアからのみ検索します。メディアを USB
大容量記憶装置だけにさらに限定したい場合は「removable\-usb」というキーワードを使えることに注目してください。
.IP "\fBpersistence\-method\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
このオプションは許可する保持用メディアの種類を決定します。「overlay」が一覧にある場合はオーバーレイと見なします
(つまり「live\-rw」と「home\-rw」)。デフォルト値は「overlay」です。
.IP \fBpersistence\-path\fP=\fIパス\fP 4
live\-boot
は保持用ファイルをパーティションのルートディレクトリから検索します。このパラメータを使ってパスを設定すると同一のパーティションの複数のディレクトリを保持用ファイルの保管先にできます。
.IP \fBpersistence\-read\-only\fP 4
ファイルシステムの変更は保持用メディアには残されません。特にオーバーレイとネットワーク経由のブート用の NFS
マウントは読み取り専用でマウントされます。
.IP "\fBpersistence\-storage\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
このオプションは保持用メディアの調査時に対象とする保持用記憶装置の種類を決定します。「filesystem」が一覧にある場合はラベルが該当するファイルシステムを利用します。「file」が一覧にある場合は全ファイルシステムについてファイル名が該当するアーカイブやイメージファイルを調査します。デフォルト値は「file,filesystem」です。
.IP \fBpersistence\-label\fP=\fIラベル\fP 4
live\-boot
は保持用記憶装置の検索時に「persistence」の代わりにここで指定した「ラベル」を使います。「ラベル」はファイル名やパーティションのラベル、GPT
の名前として有効な任意のものを使えます。
.IP \fBnoeject\fP 4
このオプションを使うと live\-boot はメディアを取り出さず、ブート用メディアを削除するかユーザに質問することもなくリブートします。
.IP \fBshowmounts\fP 4
このパラメータを使うと live\-boot は「/」で「/lib/live」上の (ほとんどの場合圧縮されている) ro
ファイルシステムを提示します。これはインストール時にバイナリのパスを記憶する「mono」のようなアプリケーションで問題を起こす可能性があるためデフォルトでは有効にされていません。
.IP \fBsilent\fP 4
通常の quiet パラメータを付けてブートすると live\-boot
が出すほとんどのメッセージを非表示にします。「silent」を付けると全て非表示にします。
.IP \fBtodisk\fP=\fIデバイス\fP 4
このパラメータを追加すると、live\-boot
はルートファイルシステムをマウントする前に読み取り専用メディア全体を指定したデバイスにコピーしようとします。これには恐らく多くの RAM
が必要となります。以後のブートではこの段階を飛ばして、今回そのデバイスで使ったのと同一の「live\-media=デバイス」ブートパラメータを単に指定するようにしてください。
.IP \fBtoram\fP 4
このパラメータを追加すると、live\-boot はルートファイルシステムをマウントする前に読み取り専用メディア全体をそのコンピュータの RAM
にコピーしようとします。その読み取り専用メディアで利用している容量により、これには多くの RAM が必要となるかもしれません。
.IP \fBunion\fP=overlay|aufs 4
.\" FIXME
デフォルトで live\-boot は overlay を利用します。このパラメータにより aufs に切り替えることができます。

.\" FIXME
.SH "ファイル (古い情報)"
.IP \fB/etc/live.conf\fP 4
一部の変数はこの (Live システム中の) 設定ファイルにより設定できます。
.IP \fBlive/filesystem.module\fP 4
.\" FIXME
この (Live メディア内の)
オプションのファイルは「/live」ディレクトリ中のディスクイメージに対応するファイル名を空白文字または復帰文字で区切った一覧を収録します。このファイルが存在する場合はその中の一覧にあるイメージだけがルート
aufs に統合され、その一覧の順に読み込まれます。このファイルの最初の項目が /overlay 直下で aufs
の「最下位の」マウントポイント、この一覧の最後のファイルが /overlay 直下で aufs
の「最上位の」マウントポイントとなります。このファイルがない場合は「/live」ディレクトリにあるイメージを英数字順に読み込みます。

.SH ファイル
.IP \fB/etc/live/boot.conf\fP 4
.IP \fB/etc/live/boot/*\fP 4
.IP \fBlive/boot.conf\fP 4
.IP \fBlive/boot/*\fP 4
.IP \fBpersistence.conf\fP 4

.SH 関連項目
\fIpersistence.conf\fP(5)
.PP
\fIlive\-build\fP(7)
.PP
\fIlive\-config\fP(7)
.PP
\fIlive\-tools\fP(7)

.SH ホームページ
More information about live\-boot and the Live Systems project can be found
on the homepage at <\fIhttps://wiki.debian.org/DebianLive\fP> and in
the manual at <\fIhttps://live\-team.pages.debian.net/live\-manual/\fP>.

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

.SH 作者
live\-boot は Daniel Baumann さん <\fImail@daniel\-baumann.ch\fP> により書かれました。