Provided by: live-boot-doc_20190614_all bug

名前

       live-boot - システム起動構成要素

説明

       live-boot はブートプロセス中 (早期ユーザ空間) に Live システムを設定する構成要素を収録して
       います。

       live-boot は initramfs-tools 用のフックで、例えば live-helper(7) で作成した Live  システム
       をブートできる  initramfs  を生成するのに利用します。これには Live システムの ISO やネット
       ワーク経由でブートするための tar アーカイブ、USB メモリ用のイメージ等があります。

       これはブート時に root ファイルシステム (squashfs  等圧縮ファイルシステムのイメージであるこ
       とが多い)  が置かれている「/live」ディレクトリを収録する (読み取り専用の) メディアを検索し
       ます。見つけた場合は aufs を使って書き込み可能な環境を作成してシステムを起動します。

設定

       live-boot はブートパラメータまたは設定ファイル経由で設定できます。

       Live イメージで利用されるデフォルトの live-boot パラメータを設定する場合は lb_config(1) マ
       ニュアルページの --bootappend-live オプションを見てください。

   カーネルパラメータ
       live-boot はカーネルパラメータとして「boot=live」が利用された場合にのみ有効になります。

       さらに、挙動に影響するブートパラメータが他にもいくつかあります。下記を見てください。

   設定ファイル
       live-boot  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:

       DISABLE_CDROM=[true|false]
              Disable support for booting from CD-ROMs.  If set to 'true' mkinitramfs will  build
              an initramfs without the kernel modules for reading CD-ROMs.

       DISABLE_FAT=[true|false]
              Disable  support  for  booting from FAT file systems.  If set to 'true' mkinitramfs
              will build an initramfs without the kernel module vfat and some nls_* modules.

       DISABLE_FUSE=[true|false]
              Disable support for booting  from  FUSE-based  file  systems.   If  set  to  'true'
              mkinitramfs will build an initramfs without the kernel module fuse and file systems
              that depend on it (like curlftpfs and httpfs2).

       DISABLE_NTFS=[true|false]
              Disable support for booting from NTFS file systems.  If set to  'true'  mkinitramfs
              will build an initramfs without the kernel module ntfs.

       DISABLE_USB=[true|false]
              Disable  support  for  booting from USB devices.  If set to 'true' mkinitramfs will
              build an initramfs without the kernel module sd_mod.

       MINIMAL=[true|false]
              Build a minimal initramfs.  If set to 'true' mkinitramfs will  build  an  initramfs
              without some udev scripts and without rsync.

       PERSISTENCE_FSCK=[true|false]
              Run  fsck  on  persistence  filesystem  on boot. Will attempt to repair errors. The
              execution log will be saved in /var/log/live/fsck.log.

       FSCKFIX=[true|false]
              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.

オプション

       live-boot では以下のパラメータが現在有効です。

       access=アクセス
           物理的または視覚的に障害のあるユーザ向けのアクセシビリティレベルをセットします。アクセ
           に入るのは v1、v2、v3、m1、m2 のどれかでないといけません。v1=軽度の視覚障害、  v2=中
           程度の視覚障害、 v3=盲目、 m1=運動神経に些細な難あり、 m2=運動神経に中程度の難あり。

       console=TTY,速度
           「live-getty」オプションで利用するデフォルトのコンソールをセットします。例:
           「console=ttyS0,115200」

       debug
           initramfs ブートプロセスの出力をもっと冗長にします。
           debug=1 としてください
           debug に値をセットしないとメッセージは表示されないかもしれません。

       fetch=URL

       httpfs=URL
           指定した URL から squashfs  イメージをダウンロードしてネットワーク経由でブートする別の
           やり方で、この取得方法ではイメージを  RAM  にコピーし、httpfs  を使う方法では  FUSE と
           httpfs2 を使ってイメージを適切な位置にマウントします。RAM へのコピーにはさらに多くのメ
           モリが必要で、大きなイメージでは多少時間がかかるかもしれません。しかしその後はネット
           ワークを必要としないため正常に動作する可能性が高くなり、それ以上サーバとやりとりする必
           要がないためブート後はそのシステムは高速に動作します。
           busybox の現在の wget 及び DNS 解決の制限のために URL にはホスト名を使えず、IPアドレス
           にしか対応していません。
           機能しない: http://example.com/path/to/your_filesystem.squashfs
           機能する: http://1.2.3.4/path/to/your_filesystem.squashfs
           また、そのため httpd の名前ベースのバーチャルホストからイメージを取得することは、httpd
           のそのホストの設定で同一のIPアドレスを共有している場合は現在不可能であることにも注意し
           てください。
           また、squashfs イメージの適切な位置にある Live ISO イメージも利用できます。

       iscsi=サーバのIPアドレス[,サーバのポート];対象の名前
           LUN (Logical Unit Number、論理ユニット番号) が iso またはディスクの Live  イメージを指
           している iSCSI ターゲットからのブートで、指定されたターゲットは LUN のうち Live メディ
           アらしきものから検索されます。iscsitarget ソフトウェアを使って iSCSI  ターゲットを判定
           している場合の ietd.conf はこのようになります:
           # iscsi= パラメータで指定したターゲットの名前
           Target <ターゲットの名前>
             Lun 0 Path=<live-image.iso のパス>,Type=fileio,IOMode=ro
             # 複数のマシンのブートに使いたい場合は
             # Wthreads や MaxConnections のような一部の
             # パラメータを調整してみるのもいいかもしれません。

       findiso=/イメージ/への/パス
           .squashfs  ファイルを通常検索する位置にある全ディスクから、指定した ISO ファイルを検索
           します (そのため fromiso=... で指定するデバイス名を知っている必要はありません)。

       forcefsck
           Run fsck on persistence filesystem  on  boot.  Will  attempt  to  repair  errors.  The
           execution log will be saved in /var/log/live/fsck.log.

       fromiso=/イメージ/への/パス
           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).
           Alternatively,  it  can  be  used  to  boot  from an ISO embedded into an initrd (e.g.
           fromiso=/live/image.iso).

       ignore_uuid
           検出したメディアに合う initramfs に埋め込まれた UUID の確認を一切行いません。initramfs
           のビルド時に  LIVE_GENERATE_UUID=1 を設定して UUID を生成するように live-boot に指示し
           ているかもしれません。

       verify-checksums
           指定するとブート中に Live メディアの MD5 サムを計算し、その Live  メディアのルートディ
           レクトリにある md5sum.txt 中の値と比較します。

       ip=[デバイス]:[クライアントのIPアドレス]:[ネットマスク]:[ゲートウェイのIPアドレス]:[ネーム
       サーバ]     [,[デバイス]:[クライアントのIPアドレス]:[ネットマスク]:[ゲートウェイのIPアドレ
       ]:[ネームサーバ]]
           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=[読み込み元メディア]
           この変数をセットすると dhcp 及び固定のネットワーク設定は単に飛ばされ、システムはメディ
           アで事前に設定されている (設定されていないといけません) /etc/network/interfaces を代わ
           りに利用します。

       {live-media|bootfrom}=デバイス
           この2つは等価で、どちらかを指定すると live-boot はまずこのデバイスについて読み取り専用
           のルートファイルシステムが存在するであろう「/live」ディレクトリを検索します。それで使
           えそうなものが見つからない場合は通常のブロックデバイスの走査が行われます。
           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.

       {live-media-encryption|encryption}=暗号化の種類
           live-boot   はパスフレーズを質問することで暗号化する種類の   rootfs   をマウントできま
           す。凝った Live システムをビルドするのに有用です :-)。これまでのところサポートしている
           のは loop-aes 暗号化を指示する「aes」です。

       live-media-offset=バイト数
           このようにして、上記で指定したまたは自動検出したデバイスの、指定バイト数だけずれた位置
           からイメージが開始することを live-boot に指示できます。他の  ISO  やイメージの中にある
           Live システムの ISO やイメージを見えないようにして「クリーン」なイメージを作成するのに
           有用かもしれません。

       live-media-path=パス
           メディア上の      Live      ファイルシステムへのパスをセットします。このデフォルト値は
           「/live」で、合わせてメディアを独自化していない限りこの値を変更すべきではありません。

       live-media-timeout=秒数
           「live-media=」により指定したデバイスがその処理をあきらめるまでの制限時間を秒数で指示
           します。

       module=名前
           デフォルトとなっているオプションのファイル「filesystem.module」(以下参照) を使う代わり
           に別のファイルを拡張子「.module」を外して指定することができます。これは  Live メディア
           の「/live」ディレクトリに配置すべきです。

       netboot[=nfs|cifs]
           ネットワークマウントを行うことを live-boot  に指示します。(オプションの「nfsopts=」で)
           パラメータ「nfsroot=」によりルートファイルシステムが置かれている場所を指定します。引数
           を付けない場合はまず cifs を試し、それが失敗した場合は nfs を試します。

       nfsopts=
           これを使って nfs オプションを指定できます。

       nofastboot
           このパラメータは /etc/fstab にあるファイルシステムのチェックがデフォルトで無効化されて
           いるのを無効にします。ハードディスクに静的ファイルシステムがあり、ブート時にそれを
           チェックさせたい場合はこのパラメータを使ってください。使わない場合はファイルシステムの
           チェックは飛ばされます。

       nopersistence
           「保持  (persistence)」機能を無効化します。ブートローダ (syslinux のようなもの) が保持
           機能を有効にしてインストールされている場合に有用です。

       noeject
           Live メディアを取り出すかどうか確認しません。

       ramdisk-size
           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.

       overlay-size=SIZE
           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.

       swap=true
           このパラメータはローカルのスワップパーティションの利用を有効にします。

       persistence
           live-boot  は保持用メディアのデバイスを調査します。このデバイスにはパーティション (GPT
           (GUID Partition Table、GUIDパーティションテーブル) の名前を正しく指定)  やファイルシス
           テム  (ラベルの名前を正しく指定)、イメージファイル  (ファイル名を正しく指定)  を使えま
           す。保存先は「persistence」(persistence.conf(5) 参照)  という名前/ラベルになります。保
           存先のイメージファイルは「persistence」という名前になります。

       persistence-encryption=種類1,種類2 ... 種類n
           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".

       persistence-media={removable|removable-usb}
           「removable」というキーワードを指定すると、live-boot  は保持用パーティションを脱着可能
           なメディアからのみ検索します。メディアを USB  大容量記憶装置だけにさらに限定したい場合
           は「removable-usb」というキーワードを使えることに注目してください。

       persistence-method=種類1,種類2 ... 種類n
           このオプションは許可する保持用メディアの種類を決定します。「overlay」が一覧にある場合
           はオーバーレイと見なします            (つまり「live-rw」と「home-rw」)。デフォルト値は
           「overlay」です。

       persistence-path=パス
           live-boot は保持用ファイルをパーティションのルートディレクトリから検索します。このパラ
           メータを使ってパスを設定すると同一のパーティションの複数のディレクトリを保持用ファイル
           の保管先にできます。

       persistence-read-only
           ファイルシステムの変更は保持用メディアには残されません。特にオーバーレイとネットワーク
           経由のブート用の NFS マウントは読み取り専用でマウントされます。

       persistence-storage=種類1,種類2 ... 種類n
           このオプションは保持用メディアの調査時に対象とする保持用記憶装置の種類を決定しま
           す。「filesystem」が一覧にある場合はラベルが該当するファイルシステムを利用しま
           す。「file」が一覧にある場合は全ファイルシステムについてファイル名が該当するアーカイブ
           やイメージファイルを調査します。デフォルト値は「file,filesystem」です。

       persistence-label=ラベル
           live-boot      は保持用記憶装置の検索時に「persistence」の代わりにここで指定した「ラベ
           ル」を使います。「ラベル」はファイル名やパーティションのラベル、GPT の名前として有効な
           任意のものを使えます。

       noeject
           このオプションを使うと  live-boot はメディアを取り出さず、ブート用メディアを削除するか
           ユーザに質問することもなくリブートします。

       showmounts
           このパラメータを使うと live-boot は「/」で「/lib/live」上の  (ほとんどの場合圧縮されて
           いる)  ro ファイルシステムを提示します。これはインストール時にバイナリのパスを記憶する
           「mono」のようなアプリケーションで問題を起こす可能性があるためデフォルトでは有効にされ
           ていません。

       silent
           通常の quiet パラメータを付けてブートすると live-boot が出すほとんどのメッセージを非表
           示にします。「silent」を付けると全て非表示にします。

       todisk=デバイス
           このパラメータを追加すると、live-boot はルートファイルシステムをマウントする前に読み取
           り専用メディア全体を指定したデバイスにコピーしようとします。これには恐らく多くの   RAM
           が必要となります。以後のブートではこの段階を飛ばして、今回そのデバイスで使ったのと同一
           の「live-media=デバイス」ブートパラメータを単に指定するようにしてください。

       toram
           このパラメータを追加すると、live-boot はルートファイルシステムをマウントする前に読み取
           り専用メディア全体をそのコンピュータの RAM  にコピーしようとします。その読み取り専用メ
           ディアで利用している容量により、これには多くの RAM が必要となるかもしれません。

       union=overlay|aufs
           デフォルトで live-boot は overlay を利用します。このパラメータにより aufs に切り替える
           ことができます。

ファイル (古い情報)

       /etc/live.conf
           一部の変数はこの (Live システム中の) 設定ファイルにより設定できます。

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

ファイル

       /etc/live/boot.conf

       /etc/live/boot/*

       live/boot.conf

       live/boot/*

       persistence.conf

関連項目

       persistence.conf(5)

       live-build(7)

       live-config(7)

       live-tools(7)

ホームページ

       More information about live-boot and the Live Systems project can be found on the homepage
       at      <https://wiki.debian.org/DebianLive>      and      in      the      manual      at
       <https://live-team.pages.debian.net/live-manual/>.

バグ

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

作者

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