manpages/ja/live-boot.ja.7

   1 .\"*******************************************************************
   2 .\"
   3 .\" This file was generated with po4a. Translate the source file.
   4 .\"
   5 .\"*******************************************************************
   6 .TH LIVE\-BOOT 7 2013\-10\-30 4.0~alpha17\-1 "Live システムプロジェクト"
   7
   8 .SH 名前
   9 \fBlive\-boot\fP \- システム起動構成要素
  10
  11 .SH 説明
  12 \fBlive\-boot\fP はブートプロセス中 (早期ユーザ空間) に Live システムを設定する構成要素を収録しています。
  13 .PP
  14 .\" FIXME
  15 live\-boot は initramfs\-tools 用のフックで、例えば \fIlive\-helper\fP(7) で作成した Live
  16 システムをブートできる initramfs を生成するのに利用します。これには Live システムの ISO やネットワーク経由でブートするための
  17 tar アーカイブ、USB メモリ用のイメージ等があります。
  18 .PP
  19 .\" FIXME
  20 これはブート時に root ファイルシステム (squashfs 等圧縮ファイルシステムのイメージであることが多い)
  21 が置かれている「/live」ディレクトリを収録する (読み取り専用の) メディアを検索します。見つけた場合は aufs
  22 を使って書き込み可能な環境を作成してシステムを起動します。
  23
  24 .SH 設定
  25 \fBlive\-boot\fP はブートパラメータまたは設定ファイル経由で設定できます。
  26 .PP
  27 Live イメージで利用されるデフォルトの live\-boot パラメータを設定する場合は \fIlb_config\fP(1) マニュアルページの
  28 \-\-bootappend\-live オプションを見てください。
  29
  30 .SS カーネルパラメータ
  31 \fBlive\-boot\fP はカーネルパラメータとして「boot=live」が利用された場合にのみ有効になります。
  32 .PP
  33 さらに、挙動に影響するブートパラメータが他にもいくつかあります。下記を見てください。
  34
  35 .SS 設定ファイル
  36 \fBlive\-boot\fP は設定ファイルを利用して設定 (但し有効化しない) できます。この設定ファイルは root ファイルシステム自体
  37 (/etc/live/boot.conf、 /etc/live/boot/*)、または Live メディア (live/boot.conf、
  38 live/boot/*) に配置できます。
  39
  40 .SH オプション
  41 .\" FIXME
  42 \fBlive\-boot\fP では以下のパラメータが現在有効です。
  43 .IP \fBaccess\fP=\fIアクセス\fP 4
  44 物理的または視覚的に障害のあるユーザ向けのアクセシビリティレベルをセットします。\fIアクセス\fPに入るのは v1、v2、v3、m1、m2
  45 のどれかでないといけません。v1=軽度の視覚障害、 v2=中程度の視覚障害、 v3=盲目、 m1=運動神経に些細な難あり、
  46 m2=運動神経に中程度の難あり。
  47 .IP \fBconsole\fP=\fITTY,速度\fP 4
  48 「live\-getty」オプションで利用するデフォルトのコンソールをセットします。例: 「console=ttyS0,115200」
  49 .IP \fBdebug\fP 4
  50 initramfs ブートプロセスの出力をもっと冗長にします。
  51 .br
  52 debug=1 としてください
  53 .br
  54 debug に値をセットしないとメッセージは表示されないかもしれません。
  55 .IP \fBfetch\fP=\fIURL\fP 4
  56 .IP \fBhttpfs\fP=\fIURL\fP 4
  57 Another form of netboot by downloading a squashfs image from a given URL.
  58 The fetch method copies the image to RAM and the httpfs method uses FUSE and
  59 httpfs2 to mount the image in place. Copying to RAM requires more memory and
  60 might take a long time for large images. However, it is more likely to work
  61 correctly because it does not require networking afterwards and the system
  62 operates faster once booted because it does not require to contact the
  63 server anymore.
  64 .br
  65 Due to current limitations in busybox's wget and DNS resolution, an URL can
  66 not contain a hostname but an IP address only.
  67 .br
  68 機能しない: http://example.com/path/to/your_filesystem.squashfs
  69 .br
  70 機能する: http://1.2.3.4/path/to/your_filesystem.squashfs
  71 .br
  72 Also note that therefore it's currently not possible to fetch an image from
  73 a name\-based virtualhost of an httpd if it is sharing the IP address with
  74 the main httpd instance.
  75 .br
  76 You may also use the live ISO image in place of the squashfs image.
  77 .IP \fBiscsi\fP=\fIサーバのIPアドレス[,サーバのポート];対象の名前\fP 4
  78 Boot from an iSCSI target that has an ISO or disk live image as one of its
  79 LUNs. The specified target is searched for a LUN which looks like a live
  80 media. If you use the \fBiscsitarget\fP software iSCSI target solution your
  81 ietd.conf might look like this:
  82 .br
  83 # iscsi= パラメータで指定したターゲットの名前
  84 .br
  85 Target <ターゲットの名前>
  86   Lun 0 Path=<live\-image.iso のパス>,Type=fileio,IOMode=ro
  87   # 複数のマシンのブートに使いたい場合は
  88   # Wthreads や MaxConnections のような一部の
  89   # パラメータを調整してみるのもいいかもしれません。
  90 .IP \fBfindiso\fP=\fI/イメージ/への/パス\fP 4
  91 \&.squashfs ファイルを通常検索する位置にある全ディスクから、指定した ISO ファイルを検索します (そのため
  92 fromiso=... で指定するデバイス名を知っている必要はありません)。
  93 .IP \fBfromiso\fP=\fI/イメージ/への/パス\fP 4
  94 Allows to use a filesystem from within an ISO image that's available on
  95 live\-media.
  96 .IP \fBignore_uuid\fP 4
  97 検出したメディアに合う initramfs に埋め込まれた UUID の確認を一切行いません。initramfs のビルド時に
  98 LIVE_GENERATE_UUID=1 を設定して UUID を生成するように live\-boot に指示しているかもしれません。
  99 .IP \fBverify\-checksums\fP 4
 100 指定するとブート中に Live メディアの MD5 サムを計算し、その Live メディアのルートディレクトリにある md5sum.txt
 101 中の値と比較します。
 102 .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
 103 ブート時に設定するインターフェイスの名前とオプションを指定できます。dhcp (デフォルト)
 104 を使いたい場合は指定しないでください。将来のリリースでは公式のカーネルブートパラメータの仕様に倣って変更される (例えば
 105 ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp) かもしれません。
 106 .IP \fBip\fP=[\fI読み込み元メディア\fP] 4
 107 この変数をセットすると dhcp 及び固定のネットワーク設定は単に飛ばされ、システムはメディアで事前に設定されている (設定されていないといけません)
 108 /etc/network/interfaces を代わりに利用します。
 109 .IP {\fBlive\-media\fP|\fBbootfrom\fP}=\fIデバイス\fP 4
 110 この2つは等価で、どちらかを指定すると live\-boot
 111 はまずこのデバイスについて読み取り専用のルートファイルシステムが存在するであろう「/live」ディレクトリを検索します。それで使えそうなものが見つからない場合は通常のブロックデバイスの走査が行われます。
 112 .br
 113 実際のデバイス名を指定する代わりに「removable」というキーワードを使って、検索対象とする Live
 114 メディアを脱着可能なものだけに限定することができます。メディアを USB
 115 大容量記憶装置だけにさらに限定したい場合は「removable\-usb」というキーワードを使えることに注目してください。
 116 .IP {\fBlive\-media\-encryption\fP|\fBencryption\fP}=\fI暗号化の種類\fP 4
 117 live\-boot will mount the encrypted rootfs TYPE, asking the passphrase,
 118 useful to build paranoid live systems :\-). TYPE supported so far is "aes"
 119 for loop\-aes encryption type.
 120 .IP \fBlive\-media\-offset\fP=\fIバイト数\fP 4
 121 This way you could tell live\-boot that your image starts at offset BYTES in
 122 the above specified or autodiscovered device, this could be useful to hide
 123 the live system ISO or image inside another ISO or image, to create "clean"
 124 images.
 125 .IP \fBlive\-media\-path\fP=\fIパス\fP 4
 126 メディア上の Live
 127 ファイルシステムへのパスをセットします。このデフォルト値は「/live」で、合わせてメディアを独自化していない限りこの値を変更すべきではありません。
 128 .IP \fBlive\-media\-timeout\fP=\fI秒数\fP 4
 129 「live\-media=」により指定したデバイスがその処理をあきらめるまでの制限時間を秒数で指示します。
 130 .IP \fBmodule\fP=\fI名前\fP 4
 131 デフォルトとなっているオプションのファイル「filesystem.module」(以下参照)
 132 を使う代わりに別のファイルを拡張子「.module」を外して指定することができます。これは Live
 133 メディアの「/live」ディレクトリに配置すべきです。
 134 .IP \fBnetboot\fP[=nfs|cifs] 4
 135 ネットワークマウントを行うことを live\-boot に指示します。(オプションの「nfsopts=」で)
 136 パラメータ「nfsroot=」によりルートファイルシステムが置かれている場所を指定します。引数を付けない場合はまず cifs
 137 を試し、それが失敗した場合は nfs を試します。
 138 .IP \fBnfsopts\fP= 4
 139 これを使って nfs オプションを指定できます。
 140 .IP \fBnofastboot\fP 4
 141 このパラメータは /etc/fstab
 142 にあるファイルシステムのチェックがデフォルトで無効化されているのを無効にします。ハードディスクに静的ファイルシステムがあり、ブート時にそれをチェックさせたい場合はこのパラメータを使ってください。使わない場合はファイルシステムのチェックは飛ばされます。
 143 .IP \fBnopersistence\fP 4
 144 「保持 (persistence)」機能を無効化します。ブートローダ (syslinux のようなもの)
 145 が保持機能を有効にしてインストールされている場合に有用です。
 146 .IP \fBnoeject\fP 4
 147 Live メディアを取り出すかどうか確認しません。
 148 .IP \fBramdisk\-size\fP 4
 149 This parameter allows to set a custom ramdisk size (it's the '\-o size'
 150 option of tmpfs mount). By default, there is no ramdisk size set, so the
 151 default of mount applies (currently 50% of available RAM). Note that this
 152 option has currently no effect when booting with toram.
 153 .IP \fBswapon\fP 4
 154 このパラメータはローカルのスワップパーティションの利用を有効にします。
 155 .IP \fBpersistence\fP 4
 156 live\-boot は保持用メディアのデバイスを調査します。このデバイスにはパーティション (GPT (GUID Partition
 157 Table、GUIDパーティションテーブル) の名前を正しく指定) やファイルシステム (ラベルの名前を正しく指定)、イメージファイル
 158 (ファイル名を正しく指定) を使えます。保存先は「persistence」(\fIpersistence.conf\fP(5) 参照)
 159 という名前/ラベルになります。保存先のイメージファイルは「persistence」という名前になります。
 160 .IP "\fBpersistence\-encryption\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
 161 このオプションは保持用メディアのデバイス調査時に利用を許可する暗号化の種類を決定します。「none」が一覧にある場合は暗号化されていないメディアを許可します。「luks」が一覧にある場合は
 162 LUKS
 163 により暗号化されているメディアを許可します。暗号化されているメディアがデバイスにある場合はそのメディアの調査時にパスフレーズをユーザに質問します。デフォルト値は「none」です。
 164 .IP \fBpersistence\-media\fP={\fIremovable\fP|\fIremovable\-usb\fP} 4
 165 「removable」というキーワードを指定すると、live\-boot は保持用パーティションを脱着可能なメディアからのみ検索します。メディアを USB
 166 大容量記憶装置だけにさらに限定したい場合は「removable\-usb」というキーワードを使えることに注目してください。
 167 .IP "\fBpersistence\-method\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
 168 このオプションは許可する保持用メディアの種類を決定します。「overlay」が一覧にある場合はオーバーレイと見なします
 169 (つまり「live\-rw」と「home\-rw」)。デフォルト値は「overlay」です。
 170 .IP \fBpersistence\-path\fP=\fIパス\fP 4
 171 live\-boot
 172 は保持用ファイルをパーティションのルートディレクトリから検索します。このパラメータを使ってパスを設定すると同一のパーティションの複数のディレクトリを保持用ファイルの保管先にできます。
 173 .IP \fBpersistence\-read\-only\fP 4
 174 ファイルシステムの変更は保持用メディアには残されません。特にオーバーレイとネットワーク経由のブート用の NFS
 175 マウントは読み取り専用でマウントされます。
 176 .IP "\fBpersistence\-storage\fP=\fI種類1\fP,\fI種類2\fP ... \fI種類n\fP" 4
 177 このオプションは保持用メディアの調査時に対象とする保持用記憶装置の種類を決定します。「filesystem」が一覧にある場合はラベルが該当するファイルシステムを利用します。「file」が一覧にある場合は全ファイルシステムについてファイル名が該当するアーカイブやイメージファイルを調査します。デフォルト値は「file,filesystem」です。
 178 .IP \fBpersistence\-label\fP=\fIラベル\fP 4
 179 live\-boot
 180 は保持用記憶装置の検索時に「persistence」の代わりにここで指定した「ラベル」を使います。「ラベル」はファイル名やパーティションのラベル、GPT
 181 の名前として有効な任意のものを使えます。
 182 .IP \fBnoeject\fP 4
 183 このオプションを使うと live\-boot はメディアを取り出さず、ブート用メディアを削除するかユーザに質問することもなくリブートします。
 184 .IP \fBshowmounts\fP 4
 185 このパラメータを使うと live\-boot は「/」で「/lib/live」上の (ほとんどの場合圧縮されている) ro
 186 ファイルシステムを提示します。これはインストール時にバイナリのパスを記憶する「mono」のようなアプリケーションで問題を起こす可能性があるためデフォルトでは有効にされていません。
 187 .IP \fBsilent\fP 4
 188 通常の quiet パラメータを付けてブートすると live\-boot
 189 が出すほとんどのメッセージを非表示にします。「silent」を付けると全て非表示にします。
 190 .IP \fBtodisk\fP=\fIデバイス\fP 4
 191 このパラメータを追加すると、live\-boot
 192 はルートファイルシステムをマウントする前に読み取り専用メディア全体を指定したデバイスにコピーしようとします。これには恐らく多くの RAM
 193 が必要となります。以後のブートではこの段階を飛ばして、今回そのデバイスで使ったのと同一の「live\-media=デバイス」ブートパラメータを単に指定するようにしてください。
 194 .IP \fBtoram\fP 4
 195 このパラメータを追加すると、live\-boot はルートファイルシステムをマウントする前に読み取り専用メディア全体をそのコンピュータの RAM
 196 にコピーしようとします。その読み取り専用メディアで利用している容量により、これには多くの RAM が必要となるかもしれません。
 197 .IP \fBunion\fP=aufs|unionfs 4
 198 .\" FIXME
 199 デフォルトで live\-boot は aufs を利用します。このパラメータにより unionfs に切り替えることができます。
 200
 201 .\" FIXME
 202 .SH "ファイル (古い情報)"
 203 .IP \fB/etc/live.conf\fP 4
 204 一部の変数はこの (Live システム中の) 設定ファイルにより設定できます。
 205 .IP \fBlive/filesystem.module\fP 4
 206 .\" FIXME
 207 この (Live メディア内の)
 208 オプションのファイルは「/live」ディレクトリ中のディスクイメージに対応するファイル名を空白文字または復帰文字で区切った一覧を収録します。このファイルが存在する場合はその中の一覧にあるイメージだけがルート
 209 aufs に統合され、その一覧の順に読み込まれます。このファイルの最初の項目が /overlay 直下で aufs
 210 の「最下位の」マウントポイント、この一覧の最後のファイルが /overlay 直下で aufs
 211 の「最上位の」マウントポイントとなります。このファイルがない場合は「/live」ディレクトリにあるイメージを英数字順に読み込みます。
 212
 213 .SH ファイル
 214 .IP \fB/etc/live/boot.conf\fP 4
 215 .IP \fB/etc/live/boot/*\fP 4
 216 .IP \fBlive/boot.conf\fP 4
 217 .IP \fBlive/boot/*\fP 4
 218 .IP \fBpersistence.conf\fP 4
 219
 220 .SH 関連項目
 221 \fIpersistence.conf\fP(5)
 222 .PP
 223 \fIlive\-build\fP(7)
 224 .PP
 225 \fIlive\-config\fP(7)
 226 .PP
 227 \fIlive\-tools\fP(7)
 228
 229 .SH ホームページ
 230 live\-boot 及び Live
 231 システムプロジェクトについてのさらなる情報は、<\fIhttp://live\-systems.org/\fP> のホームページや
 232 <\fIhttp://live\-systems.org/manual/\fP> のマニュアルにあります。
 233
 234 .SH バグ
 235 バグは <\fIhttp://bugs.debian.org/\fP> にあるバグ追跡システムに live\-boot
 236 パッケージのバグ報告として提出するか、<\fIdebian\-live@lists.debian.org\fP> にある Live
 237 システムのメーリングリスト宛てにメールを書くことにより報告できます。
 238
 239 .SH 作者
 240 live\-boot は Daniel Baumann さん <\fImail@daniel\-baumann.ch\fP> により書かれました。