manual/GNU_cpio/release/man1/cpio.1

   1 .\" -*- nroff -*-
   2 .\"*******************************************************************
   3 .\"
   4 .\" This file was generated with po4a. Translate the source file.
   5 .\"
   6 .\"*******************************************************************
   7 .\"
   8 .\" About Japanese translation
   9 .\" The original version was contributed to Linux JM Project
  10 .\"   by NetBSD jman Project, 1998-02-18.
  11 .\" Update 2012-06-02, Akihiro MOTOKI <amotoki@gmail.com>
  12 .\"
  13 .TH CPIO 1L
  14 .SH 名前
  15 cpio \- アーカイブファイルへのファイルのコピーや、アーカイブファイルからファイルへのコピーを行う
  16 .SH 書式
  17 \fBcpio\fP {\-o|\-\-create} [\-0acvABLV] [\-C bytes] [\-H format] [\-M message] [\-O
  18 [[user@]host:]archive] [\-F [[user@]host:]archive]
  19 [\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-message=message]
  20 [\-\-null] [\-\-reset\-access\-time] [\-\-verbose] [\-\-dot] [\-\-append]
  21 [\-\-block\-size=blocks] [\-\-dereference] [\-\-io\-size=bytes] [\-\-quiet]
  22 [\-\-force\-local] [\-\-rsh\-command=command] [\-\-help] [\-\-version] < name\-list
  23 [> archive]
  24
  25 \fBcpio\fP {\-i|\-\-extract} [\-bcdfmnrtsuvBSV] [\-C bytes] [\-E file] [\-H format]
  26 [\-M message] [\-R [user][:.][group]] [\-I [[user@]host:]archive] [\-F
  27 [[user@]host:]archive] [\-\-file=[[user@]host:]archive] [\-\-make\-directories]
  28 [\-\-nonmatching] [\-\-preserve\-modification\-time] [\-\-numeric\-uid\-gid]
  29 [\-\-rename] [\-t|\-\-list] [\-\-swap\-bytes] [\-\-swap] [\-\-dot] [\-\-unconditional]
  30 [\-\-verbose] [\-\-block\-size=blocks] [\-\-swap\-halfwords] [\-\-io\-size=bytes]
  31 [\-\-pattern\-file=file] [\-\-format=format] [\-\-owner=[user][:.][group]]
  32 [\-\-no\-preserve\-owner] [\-\-message=message] [\-\-force\-local]
  33 [\-\-no\-absolute\-filenames] [\-\-sparse] [\-\-only\-verify\-crc] [\-\-to\-stdout]
  34 [\-\-quiet] [\-\-rsh\-command=command] [\-\-help] [\-\-version] [pattern...] [<
  35 archive]
  36
  37 \fBcpio\fP {\-p|\-\-pass\-through} [\-0adlmuvLV] [\-R [user][:.][group]] [\-\-null]
  38 [\-\-reset\-access\-time] [\-\-make\-directories] [\-\-link] [\-\-quiet]
  39 [\-\-preserve\-modification\-time] [\-\-unconditional] [\-\-verbose] [\-\-dot]
  40 [\-\-dereference] [\-\-owner=[user][:.][group]] [\-\-no\-preserve\-owner] [\-\-sparse]
  41 [\-\-help] [\-\-version] destination\-directory < name\-list
  42 .SH 説明
  43 本マニュアルは、GNU 版の \fBcpio\fP について説明します。 \fBcpio\fP は、cpio 形式もしくは tar
  44 形式のアーカイブファイルに格納されたファイルを取り出したり、その逆を行ったりします。アーカイブファイルの中には、ファ
  45 イルそのものの情報の他に、それら個々のファイルについての所有者や属性その他の情報も格納されています。アーカイブファイルは、ディスク上のファイルでも、テープ上に格納してあっても、もしくはパイプであっても構いません。
  46 \fBcpio\fP は、3つの操作モードを持っています。
  47 .PP
  48 コピーアウトモードでは、 \fBcpio\fP はファイルをアーカイブファイルにコピーします。 \fBcpio\fP
  49 は、標準入力からファイル名のリストを1行ずつ読み込み、標準出力にそのファイルのアーカイブを書き出します。ファイルリストの作成には、 \fBfind\fP
  50 コマンドが多く使われます。 \fBfind\fP コマンドに、\-depth
  51 オプションを付加してやって、ディレクトリの属性によって読み込み不可であったり、検索が出来なかったりする問題を最小限に抑えるようにして下さい。
  52 .PP
  53 コピーインモードでは、 \fBcpio\fP
  54 はファイルをアーカイブファイル、もしくはアーカイブの内容のリストからコピーします。cpioは、アーカイブを標準入力から読み込みます。オプションでないコマンドラインの引数は、すべてシェルによって展開される文字列として解釈されます。これは、アーカイブ内のファイル名が、この文字列によって指定されるパターンにマッチする場合にのみそのファイルを展開することを意味します。また、シェルでの解釈にかかわらず、ファイル名の先頭に
  55 `.' を含む場 合には、パターンの最初にワイルドカードがある場合にパターン一致します。そして、ファイル名に `/'
  56 を含む場合にも、ワイルドカードによる一致が期待 できます。パターンが指定されない場合には、全てのファイルが展開対象となります。
  57 .PP
  58 コピーパスモードでは、 \fBcpio\fP
  59 はファイルをあるディレクトリから別のディレクトリにコピーします。実際には、アーカイブファイルを用いて、コピーアウトモードとコピーインモードを組み合わせて実行するような形になります。
  60 cpioは、コピーするファイルリストを標準入力から受けとります。これらのファイルのコピー先のディレクトリについては、オプション以外の引数で与えられ
  61 ます。
  62 .PP
  63 \fBcpio\fP は、 binary, old ASCII, new ASCII, crc, HPUX binary, HPUX old ASCII,
  64 old tar, POSIX.1 tar の各形式のアーカイブフォーマットをサポートします。 binary
  65 フォーマットは、異なるマシンアーキテクチャの間でアーカイブフォー マットが異なるため、ほとんど使われません。 old ASCII
  66 フォーマットは、異なるマシンアーキテクチャの間でのアーカイブの互換性は保たれますが、65536 個を超える i\-node
  67 を備えるシステムで使われることが想定されてません。 new ASCII
  68 フォーマットは、異なるマシンアーキテクチャの間でのアーカイブの互換性は保たれます。old ASCII
  69 フォーマットのように、ファイルシステムのサイズの制限はありませんが、全てのバージョンの \fBcpio\fP
  70 でこの形式がサポートされているわけではありません。現状でこのフォーマットをサポートする \fBcpio\fP は、GNU cpio と SVR4 の cpio
  71 のみです。 crc フォーマットは、new ASCII フォーマットと似てますが、アーカイブ作成時に \fBcpio\fP
  72 が各ファイルについてチェックサムを計算し、アーカイブ内に含めるところが異なります。このチェックサムは、アーカイブからファイルを取り出す時の検証に使用されます。
  73 HPUX フォーマットは、デバイスファイルを格納する形式が他の cpio と異なる HPUX の cpio 形式との互換性を持たせるために存在します。
  74 .PP
  75 tar フォーマットは、 \fBtar\fP との互換性を持たせるために存在します。tar フォーマットでは、アーカイブされるファイル名としては、100
  76 文字を超えるものは使えません。そして、ブロックデバイス特殊ファイルやキャラクタデバイス特殊ファイルをアーカイブすることも出来ません。 POSIX.1
  77 tar フォーマットは、アーカイブされるファイル名としては、255文字を超えるものは使えません (ちょうどその場所に "/"
  78 が含まれる場合は除きます)。
  79 .PP
  80 デフォルトでは、 \fBcpio\fP は、古い \fBcpio\fP
  81 との互換性を確保するためにバイナリフォーマットアーカイブを作成します。アーカイブを展開する場合には、 \fBcpio\fP
  82 は自動的に、読み込まれたアーカイブの種類、そして異なるバイトオーダのマシンで作成されたかどうかを判断します。
  83 .PP
  84 ある \fBcpio\fP のオプションは、操作モードを指定します。どのオプションがどのモードに対応するかについては、書式のセクションを見て下さい。
  85 .SS オプション
  86 .TP
  87 \fI\-0, \-\-null\fP
  88 コピーアウトおよびコピーパスモードにおいて、改行のかわりにヌル文字で終了するファイル名のリストを、読み込みます。これは、改行を含むファイル名を持つファイルをアーカイブできるようにするためです。
  89 GNU \fBfind\fP を使うことで、ヌル文字で終了するファイル名のリストを生成することが出来ます。
  90 .TP
  91 \fI\-a, \-\-reset\-access\-time\fP
  92 ファイルを読み込んだ後に、それらのファイルのアクセス時刻を元に戻します。これにより、これらのファイルがその時点でアクセスされていないように見せることができます。
  93 .TP
  94 \fI\-A, \-\-append\fP
  95 すでに存在するアーカイブファイルに追加書き込みをします。コピーアウトモードでのみ機能します。本オプションを使うためには、  \fI\-O\fP もしくは
  96 \fI\-F (\-\-file)\fP オプションで指定するアーカイブファイルがディスク上に存在する必要 があります。
  97 .TP
  98 \fI\-b, \-\-swap\fP
  99 コピーインモードにおいて、データ中の 1 ワード (32ビット) データの上下 16 ビットを入れ換え、1 ハーフワード (16ビット) の上下 8
 100 ビットを入れ換えます。本オプショ ンは \fI\-sS\fP と同等です。 本オプションは、ビッグエンディアンマシンとリトルエンディアンのマシンの間で 32
 101 ビット整数を変換するために用います。
 102 .TP
 103 \fI\-B\fP
 104 I/O ブロックサイズを 5120 バイトに設定します。ブロックサイズの初期値は 512 バイト です。
 105 .TP
 106 \fI\-\-block\-size=BLOCK\-SIZE\fP
 107 I/O ブロックサイズを BLOCK\-SIZE * 512 バイトに設定します。
 108 .TP
 109 \fI\-c\fP
 110 アーカイブ形式として old portable (old ASCII) フォーマットを用います。
 111 .TP
 112 \fI\-C IO\-SIZE, \-\-io\-size=IO\-SIZE\fP
 113 I/O ブロックサイズを IO\-SIZE バイトに設定します。
 114 .TP
 115 \fI\-d, \-\-make\-directories\fP
 116 必要に応じてディレクトリを作成します。
 117 .TP
 118 \fI\-E FILE, \-\-pattern\-file=FILE\fP
 119 コピーインモードにおいて、展開もしくはリスト表示するファイルを指定するパターンをファイル FILE から読み出します。 FILE の各行は、
 120 \fBcpio\fP のオプション以外の引き数として扱われます。
 121 .TP
 122 \fI\-f, \-\-nonmatching\fP
 123 指定されたパターンのいずれにも一致しないファイルのみコピーします。
 124 .TP
 125 \fI\-F, \-\-file=archive\fP
 126 標準入力や標準出力のかわりに、指定されたアーカイブファイルを用います。他のマシンのテープドライブをアーカイブファイルとして扱う場合には、
 127 `HOSTNAME:' で始まるファイル名を使用して下さい。
 128 リモートテープドライブに特定のユーザーでアクセスできる場合 (通常は、そのユーザーの `~/.rhosts'
 129 ファイルにエントリがある場合が多い)、ホスト名の前にユーザ名と `@' を置くことで、そのユーザでリモートのテープドライブにアクセスできます。
 130 .TP
 131 \fI\-\-force\-local\fP
 132 \fI\-F\fP, \fI\-I\fP, \fI\-O\fP
 133 オプションを用いる際に、ファイル名がコロン文字を含んでいたとしてもファイル名をローカルファイル名とみなします。通常、コロン文字は、リモートホスト名を示すのに使用されます。
 134 .TP
 135 \fI\-H FORMAT, \-\-format=FORMAT\fP
 136 アーカイブフォーマットとして FORMAT を使用します。FORMAT
 137 に指定出来る文字列を以下に示します。これらの名前は、すべて大文字の場合でも認識されます。コピーインモードでは、入力ファイルの内容から自動的に判定されたアーカイブフォーマットがデフォルトのフォーマットとなります。コピーインモードではデフォルトは
 138 "bin" フォーマットです。
 139 .RS
 140 .IP bin
 141 binary フォーマットです。ほとんど使われません。
 142 .IP odc
 143 old ASCII フォーマットです (POSIX.1 portable フォーマット、old portable フォーマットとも呼ばれます)。
 144 .IP newc
 145 new ASCII フォーマットです (SVR4 portable フォーマット、new portable フォーマットとも呼ばれます)。 65536
 146 個を越える i\-node を持つファイルシステムに対応しています。
 147 .IP crc
 148 チェックサム付きの new portable フォーマット (SVR4 portable フォーマット) です
 149 (crc フォーマットとも呼ばれます)。
 150 .IP tar
 151 old tar フォーマットです。
 152 .IP ustar
 153 POSIX.1 tar フォーマットです。 GNU \fBtar\fP アーカイブも取り扱うことが出来ます。 POSIX.1 tar と GNU tar
 154 は、よく似ていますが、同じではありません。
 155 .IP hpbin
 156 HPUX の cpio で使用された、古い binary フォーマットです。 (他の cpio とは異なる形式でデバイスファイルを保存します)。
 157 .IP hpodc
 158 HPUX の cpio で使用されている portable フォーマットです (他の cpio とは異 なる形式でデバイスファイルを保存します)。
 159 .RE
 160 .TP
 161 \fI\-i, \-\-extract\fP
 162 コピーインモードで動作させます。
 163 .TP
 164 \fI\-I archive\fP
 165 標準入力のかわりに、指定されたアーカイブファイルを用います。他のマシンのテープドライブをアーカイブファイルとして扱う場合には、 `HOSTNAME:'
 166 で始まるファイル名を使用して下さい。リモートテープドライブに特定のユーザーでアクセスできる場合 (通常は、そのユーザーの `~/.rhosts'
 167 ファイルにエントリがある場合が多い)、ホスト名の前にユーザ名と `@' を置くことで、そのユーザでリモートのテープドライブにアクセスできます。
 168 .TP
 169 \fI\-k\fP
 170 無視されます。他のバージョンの \fBcpio\fP との互換性を保つためにのみ存在します。
 171 .TP
 172 \fI\-l, \-\-link\fP
 173 可能な限り、ファイルをコピーする代わりにリンクを作成します。
 174 .TP
 175 \fI\-L, \-\-dereference\fP
 176 シンボリックリンクを展開します (シンボリックリンク自身をコピーする代わりに、シンボリックリンクファイルが指すファイルをコピーします)。
 177 .TP
 178 \fI\-m, \-\-preserve\-modification\-time\fP
 179 ファイルの作成時に、ファイルの元の更新時刻を保持します。
 180 .TP
 181 \fI\-M MESSAGE, \-\-message=MESSAGE\fP
 182 バックアップ媒体 (テープやフロッピーディスクなど) のボリュームの終端まで到達した場合に、指定された MESSAGE
 183 を出力し、ユーザに新しい媒体を挿入するように指示を出します。 MESSAGE に文字列 "%d" が含まれる場合には、 "%d"
 184 は現在のボリューム番号に置き換えられます (ボリューム番号は 1 から始まります)。
 185 .TP
 186 \fI\-n, \-\-numeric\-uid\-gid\fP
 187 詳細モードで内容のリストを表示する場合に、UID と GID を、名前に変換せずに数字で表示します。
 188 .TP
 189 \fI\-\-no\-absolute\-filenames\fP
 190 コピーインモードにおいて、アーカイブ内のファイル名が絶対パスの場合であっても現在のディレクトリへの相対パスとしてファイルの作成を行います。
 191 .TP
 192 \fI\-\-no\-preserve\-owner\fP
 193 コピーインモードとコピーパスモードにおいて、ファイルの所有者を変更しません。展開後のファイルの所有者は、ファイルの展開を行ったユーザとなります。スーパユーザ以外のユーザが使用する場合には、デフォルトでこのオプションが有効になります。これは
 194 System V のユーザが間違ってファイルの所有権を手放さないようにするためです。
 195 .TP
 196 \fI\-o, \-\-create\fP
 197 コピーアウトモードで動作させます。
 198 .TP
 199 \fI\-O archive\fP
 200 標準出力のかわりに、指定されたアーカイブファイルを用います。他のマシンのテープドライブをアーカイブファイルとして扱う場合には、 `HOSTNAME:'
 201 で始まるファイル名を使用して下さい。リモートテープドライブに特定のユーザーでアクセスできる場合 (通常は、そのユーザーの `~/.rhosts'
 202 ファイルにエントリがある場合が多い)、ホスト名の前にユーザ名と `@' を置くことで、そのユーザでリモートのテープドライブにアクセスできます。
 203 .TP
 204 \fI\-\-only\-verify\-crc\fP
 205 コピーインモードで CRC フォーマットのアーカイブを読み込む際に、アーカイブ内の各ファイルの CRC
 206 の検証のみを行い、実際のファイルの展開は行いません。
 207 .TP
 208 \fI\-p, \-\-pass\-through\fP
 209 コピーパスモードで動作させます。
 210 .TP
 211 \fI\-\-quiet\fP
 212 コピーしたブロック数を表示しません。
 213 .TP
 214 \fI\-r, \-\-rename\fP
 215 対話的にファイル名を変更します。
 216 .TP
 217 \fI\-R [user][:.][group], \-\-owner [user][:.][group]\fP
 218 コピーアウトモードとコピーパスモードにおいて、全ての生成ファイルの所有権を指定したユーザやグループに設定します。ユーザとグループのどちらか一方、もしくは両方を指定する必要があります。グループの指定ないで区切り文字
 219 ":" や "."
 220 が指定された場合には、ユーザのログイングループがグループとして設定されます。スーパーユーザだけがファイルの所有権を変更することができます。
 221 .TP
 222 \fI\-\-rsh\-command=command\fP
 223 リモートマシンにあるデバイスと通信する際に \fIcommand\fP を使用する。
 224 .TP
 225 \fI\-\-sparse\fP
 226 コピーアウトモードとコピーパスモードにおいて、内容が 0 の大きなブロックを持つファイルを sparse ファイルとして書き出します。
 227 .TP
 228 \fI\-s, \-\-swap\-bytes\fP
 229 コピーインモードにおいて、ファイル中のデータの 16 ビットの上位 8 ビットと下位 8 ビットを入れ換えます。
 230 .TP
 231 \fI\-S, \-\-swap\-halfwords\fP
 232 コピーインモードにおいて、ファイル中のデータのワード (32 ビット) の上位 16 ビットと下位 16 ビットを入れ換えます。
 233 .TP
 234 \fI\-t, \-\-list\fP
 235 入力の内容一覧を出力します。
 236 .TP
 237 \fI\-\-to\-stdout\fP
 238 取り出ししたファイルを標準出力に出力します。このオプションはコピーインモードで使用できます。
 239 .TP
 240 \fI\-u, \-\-unconditional\fP
 241 新しいファイルを古いファイルで置き換えるかどうかを問い合わせることなく、全てのファイルを上書きします。
 242 .TP
 243 \fI\-v, \-\-verbose\fP
 244 処理されたファイル名を表示します、 \fI\-t\fP オプションが同時に指定された場合には `ls \-l' 形式の表示を行います。ustar
 245 フォーマットのアーカイブの詳細表示では、アーカイブ中のローカルシステムに存在しないユーザ名、グループ名は、アーカイブ内に格納された UID および
 246 GID の値に対応するローカル上のユーザ名、グループ名に置き換えて表示されます。
 247 .TP
 248 \fI\-V \-\-dot\fP
 249 各ファイルを処理するごとに、"."を表示します。
 250 .TP
 251 \fI\-\-version\fP
 252 \fBcpio\fP のプログラムバージョンを表示して終了します。