ユーザーコマンド                                          cpio(1)

【名前】
     cpio - アーカイブからのファイルの抽出または復元

【形式】
     cpio  -i  [-bBcdfkmPrsStuvV6@]  [-C bufsize]  [-E file]   [-
     H header] [ -I file    [-M message]] [-R id] [pattern ...]

     cpio -o [-aABcLPvV@] [-C bufsize] [-H header]  [  -O file
     [-M message]]

     cpio -p [-adlLmPuvV@] [-R id] directory

【機能説明】
     cpio コマンドは、ファイルを cpio アーカイブへコピーした り、
     cpio からコピーしたりします。cpio アーカイブは複数のボリュー
     ムにわたる (により構成される) ことも可能です。-i 、-o  、 -p
     の各オプションは、実行する処理を選択します。以下に、これらの
     各処理を説明します (これらの処理は相互に排他的です)。

  ［復元モード］
     cpio -i (copy in、復元) は、以前に cpio -o コマンドが生成 し
     た 出力を標準入力としてファイルを抽出します。pattern の 1 つ
     に一致する名前を持つファイルのみが選択されます。pattern につ
     い ての詳細は、後述する「オペランド」の項および sh(1) の説明
     を参照してください。抽出されたファイルは条件に応じて作 成 さ
     れ、 以 下に述べるオプションに基づいて現在のディレクトリにコ
     ピーされます。ファイルのアクセス権は前の cpio -o コマンド の
     出力ファイルと同じです。現在のユーザーがスーパーユーザーでな
     いかぎり、所有者およびグループは現在のユーザーと同じ で す。
     スー パーユーザーの場合は、前に実行した cpio -o コマンドの出
     力ファイルから得られる所有者およびグループと同じになります。
     cpio -i が作成しようとするファイルがすでに存在していて、さら
     に既存のファイルが同じか新しいバージョンのときは、メッセージ
     が 出力されファイルは置換されないので注意してください。-u オ
     プションは既存のファイルを無条件に置換するときに使用します。

  ［保管モード］
     cpio -o (copy out、保管) は、ファイルのパス名のリストを標 準
     入力から読み込んで、それらのファイルをパス名およびステータス
     情報と共に、cpio アーカイブ形式で標準出力へコピーします。 出
     力は、デフォルトでは 8192 バイト境界でブロック化されますが、
     (-B または -C オプションを使用して) ユーザーが指定したブロッ
     クサイズまたは (CTC テープのように) デバイスに依存したブロッ
     クサイズでの出力も可能です。

  ［パスモード］
     cpio -p (pass、パス) は、ファイルのパス名のリストを標準入 力
     から読み込んで、条件に応じてファイルを作成し、以下のオプショ
     ンに基づいてコピー先のディレクトリへコピーします。

     注意 :  cpio は 4 バイトワードを前提としています。

     文字型デバイスへ出力 (-o) または文字型デバイスからの入力  (-
     i) 時に、媒体の終わり (たとえば、フロッピーディスクの終わり)
     に到達し、さらに -O オプションや -I オプションが使用されてい
     ないと cpio は次のメッセージを表示します。

     To continue, type device/file name when ready.

     継続するには、媒体を交換して文字型特殊デバイス名 (たと え ば
     /dev/rdiskette) を入力して RETURN キーを押してください。これ
     は、cpio に異なるデバイスを使用するように命令して、処理を 続
     行したい場合などに使います。たとえば、2 台のフロッピーデバイ
     スがあるなら、フロッピー交換の間に cpio が処理を継続できるよ
     う 他方のデバイスへ切り替えたいという場合です。RETURN キーを
     押すと cpio は処理を終了します。

【オプション】
     以下のオプションを指定できます。

     -i              (copy in、復元) 標準入力からアーカイブを読み
                     込んで、条件に応じて、アーカイブに含まれてい
                     るファイルを抽出し、現在のディレクトリツリー
                     に配置します。



     -o              (copy out、保管) ファイルのパス名のリスト を
                     標 準入力から読み込んで、そのファイルを cpio
                     形式で標準出力へコピーします。



     -p              (pass、パス) ファイルのパス名のリストを標 準
                     入力から読み込んで、条件に応じて、読み込んだ
                     ファイルを宛先のディレクトリツリーへコピーし
                     ます。



     上記の  -i、-o、-p オプションのいずれかを指定した後に、以 下
     のオプションを任意の順序で指定できます。

     -a              コピー後に入力ファイルのアクセス時間をリセッ
                     ト して、cpio によるアクセスの痕跡を消去しま
                     す。cpio -pla が指定されていると、リンクされ
                     た ファ イルのアクセス時間はリセットされませ
                     ん。



     -A              ファイルをアーカイブへ追加します。 -A  オ プ
                     ションには -O が必要です。このオプションは、
                     ファイル、フロッピーディスク、または ハー ド
                     ディスクパーティションのアーカイブにのみ有効
                     です。アーカイブ内に以前から存在する、リンク
                     されたファイルへの影響は予測不能です。



     -b              各ワード内のバイト順を逆にします。 -i  オ プ
                     ションとのみ使用できます。



     -B              入出力を 5120 バイトでブロック化します。この
                     オプションと -C オプションを使用していないと
                     きのデフォルトのバッファサイズは 8192 バイト
                     です。-B は -p (pass、パス) オプションには適
                     用されません。



     -c              可搬性のために、ASCII 文字形式でヘッダー情報
                     を 読 み書きします。このヘッダー形式に関して
                     ユーザーID またはグループ ID の制限はあり ま
                     せ ん。SVR4 をベースとしたマシン間ではこのオ
                     プションを使用してください。また種類が不明な
                     マシン間では -H odc オプションを使用してくだ
                     さい。-c オプションは、SVR4 ベースのシステム
                     でだけサポートされている拡張デバイス番号を使
                     うことを意味していま す。 SunOS  4  ま た は
                     Interactive  UNIX と、Solaris 2.6 オペーレー
                     ティング環境またはその互換バージョンとの間で
                     ファ イルを転送する場合は、-H odc を使用して
                     ください。



     -C  bufsize     入出力を bufsize 単位でブロック化 し ま す。
                     bufsize は正の整数で置き換えられます。このオ
                     プションと -B オプションを使用していないとき
                     のデフォルトのバッファサイズは 8192 バイトで
                     す。-C は -p (pass、パス) オプションには適用
                     されません。



     -d              必要に応じてディレクトリを作成します。



     -E file         アーカイブから抽出するファイル名のリストを含
                     む (1 行 1 ファイル名の) 入力ファイル (file)
                     を指定します。



     -f              pattern で指定されたものを除くすべてのファイ
                     ルを抽出します。pattern については「オペラン
                     ド」の項を参照してください。



     -H header       header 形式でヘッダー情報を読み書きしま す。
                     コピー先とコピー元のマシンが異なるタイプのと
                     きは常にこのオプション (または -c オプション
                     )  を 使用してください。このオプションは、-c
                     および -6 と同時には使用できませ ん。 header
                     として有効な値は以下のとおりです。

                     bar              bar ヘッダーと形式。-i オプ
                                     ション (読み取り専用) とのみ
                                     使用されます。




                     crc または CRC  拡張デバイス番号とファイル単
                                     位 の チェッ ク サムを持った
                                     ASCII ヘッダー。このヘッダー
                                     形 式に関してユーザーID また
                                     はグループ ID の制限はありま
                                     せん。



                     odc             スモールデバイス番号を持った
                                     ASCII   ヘッ ダー。 こ れ は
                                     IEEE/P1003 データ交換標準 に
                                     よる cpio のヘッダーと形式で
                                     す。他のヘッダー形式と 比 べ
                                     て、最も幅広い可搬性を提供し
                                     ます。POSIX に準拠したシステ
                                     ム間でファイル転送を行う場合
                                     の公式の 形 式 で す  (stan-
                                     dards(5) を参照)。SunOS 4 ま
                                     たは Interactive UNIX と通信
                                     する場合には、この形式を使用
                                     してください。このヘッダー形
                                     式では 262143 までのユーザー
                                     ID とグループ ID をヘッ ダー
                                     に格納できます。



                     tar または TAR  tar ヘッダーと形式。こ れ は
                                     2097151  までのユーザーID と
                                     グループ ID を格納できる、古
                                     い  tar ヘッダー形式です。-i
                                     オプションと一緒に使用して、
                                     古い形式のアーカイブを読み込
                                     むためにのみ用意されて い ま
                                     す。

                                     このアーカイブ形式を-o オ プ
                                     ショ ン と一緒に使用すると、
                                     "ustar" 形式を指定した場合と
                                     同 じ 効果が得られます。つま
                                     り、出力アーカイブ は  ustar
                                     形式になり、アーカイブの読み
                                     込みには -H ustar を使用する
                                     必要があります。



                     ustar または USTIEEE/P1003 データ交換標準 の
                                     tar ヘッダーと形式。このヘッ
                                     ダー形式では 2097151 まで の
                                     ユー ザーID とグループ ID を
                                     ヘッダーに格納できます。



                     上述の制限値を超えたユーザーID とグループ ID
                     を持つファイルは 60001 のユーザーID とグルー
                     プ ID で保存されます。大規模ファイル (8 G バ
                     イト - 1 Gバイト) を転送するには、ヘッダー形
                     式は tar または TAR、ustar または USTAR、odc
                     のいずれかを使用できます。


     -I file         入力アーカイブとして、標準入力の 代 わ り に
                     file の内容を読み込みます。file が文字型特殊
                     デバイスで、現在の媒体をすべて読み終え た 場
                     合、 処理を続けるために媒体を交換して RETURN
                     キーを押してください。このオプションは -i オ
                     プションとのみ使用できます。



     -k              破壊されたファイルヘッダーや I/O エラーを 読
                     み飛ばします。破壊されたりシーケンスが乱れた
                     りした媒体からファイルをコピーしたい場合は、
                     こ の オプションによって正常なヘッダーを持つ
                     ファイルだけを読むことができます。他の  cpio
                     アー カ イブを含む cpio アーカイブの場合、エ
                     ラーが発生すると cpio は終了します。cpio  は
                     次の正常なヘッダーを検索し、より小さいアーカ
                     イブを見つけるとそのトレーラに到達するまで読
                     み 取って、終了します。-i オプションとのみ使
                     用できます。



     -l              パスモードでは、可能な場合は必ずリンク元とリ
                     ン ク先の間にハードリンクを作成します。-L オ
                     プションを同時に指定した場合は、シンボリック
                     リンクによって参照されているファイルに対して
                     ハードリンクを作成します。そうでない場合は、
                     シンボリックリンク自体に対してハードリンクを
                     作成します。このオプションは、-p オプショ ン
                     とのみ使用してください。



     -L              シンボリックリンクをたどります。シンボリック
                     リンクの宛先がディレクトリであった場合は、参
                     照されているディレクトリを、そのリンクの名前
                     で保存します。そうでない場合は、参照されてい
                     るファイルを、そのリンクの名前で保存します。



     -m              以前のファイル更新時間を保持します。このオプ
                     ションは、コピー中のディレクトリには無効です
                     (-a とは同時使用不可)。



     -M message      媒体交換時の message を定義します。オプ ショ
                     ン -O または -I を使用して、文字型特殊デバイ
                     スを指定しているときに、媒体の終わりに達した
                     ときに出力されるメッセージを定義します。次の
                     媒体のシーケンス番号を表示するのに 1 つの %d
                     を使用できます。



     -O file         cpio の出力先を、標準出力から file に変更 し
                     ま す。file が文字型特殊デバイスで現在の媒体
                     が一杯のとき処理を継続するには、媒体を交換し
                     て キャリッジリターンを押してください。-o オ
                     プションとのみ使用できます。



     -P              ACL を保持します。このオプションを出力用に使
                     用 した場合、既存の ACL が、拡張属性以外のそ
                     の他の属性とともに標準出力に書き出されます。
                     ACL は、特殊なファイルタイプを持つ特殊ファイ
                     ルとして作成されます。このオプションを入力用
                     に使用した場合、ACL は他の属性とともに標準入
                     力から復元されます。このオプションは特殊ファ
                     イルタイプを認識できます。なお旧バージョンの
                     cpio を使って ACL を持つ cpio アーカイブを復
                     元しようとすると、エラーが発生します。ACL が
                     すべてのシステムにサポートされているとは限ら
                     ず、可搬性がないため、このオプションは -c オ
                     プションとともに使用しないでください。可搬性
                     を 保つために ASCII ヘッダーを使用してくださ
                     い。



     -r              対話形式でファイル名を変更します。キャリッジ
                     リターンだけを押すと、そのファイルを飛ばしま
                     す。"." と入力すると、元のパス名を使用 し ま
                     す。cpio -p とは使用できません。



     -R  id          各ファイルの所有者とグループ情報を  user  ID
                     に変更します (ID は /etc/passwd ファイル内の
                     有効なログイン ID でなければなりません)。 こ
                     のオプションはスーパーユーザーだけが使用でき
                     ます。



     -s              各ハーフワード毎にバイトを交換します。



     -S              各ワード毎にハーフワードを交換します。



     -t              入力の内容を表示します。入力したファイルに拡
                     張属性が含まれている場合は、それらの属性も表
                     示します。ファイルは生成されません。-t と -V
                     は同時には使用できません。



     -u              無条件にコピーを実行します。通常、古いファイ
                     ルは同一名の新しいファイルを置換しません。



     -v              詳細表示。ファイル名のリストと拡張属性の名前
                     を 出力します。-t オプションと一緒に使用する
                     と ls -l コマンドの出力のよう に な り ま す
                     (ls(1) 参照)。



     -V              詳細表示。入力または出力した各ファイルの内容
                     を完全に表示します。すべてのファイル名を表示
                     せずに cpio が動作していることをユーザーが確
                     認するときに便利です。



     -6              UNIX System Sixth Edition 形式のアーカイブ形
                     式 ・ファイルを処理します。-i オプションとの
                     み使用できます。このオプションは、-c およ び
                     -H オプションと同時には使用できません。



     -@              拡張属性をアーカイブに含めます。デフォルトで
                     は、 cpio  は 拡張属性をアーカイブに含めませ
                     ん。このフラグを指定すると cpio は、アーカイ
                     ブ内のファイルに拡張属性が存在するかどうかを
                     検査し、存在する場合は、その拡張属性を通常の
                     ファイルと同様にアーカイブに含めます。拡張属
                     性ファイルは、特殊なファイルタイプを持つ特殊
                     ファ イ ルとしてアーカイブに収められます。-@
                     フラグをオプション -i または -p と一緒に使用
                     す る と、 cpio は、拡張属性のデータを通常の
                     ファイルデータと一緒に復元します。拡張 属 性
                     ファイルの抽出は、通常のファイル抽出の一部と
                     してのみ実行できます。属性レコードだけを抽出
                     しようとしても無視されます。



【オペランド】
     以下のオペランドを指定できます。

     directory       cpio -p の対象となる既存ディレクトリの パ ス
                     名。



     pattern         パターンマッチング用の表現方法を利用した式。
                     これはシェルがファイル名のパターンマッチング
                     に利用する式 (sh(1) を参照) や正規表現に似た
                     ものです。以下に示すメタキャラクタが定義され
                     ています。

                     *        空の文字列を含み、あらゆる文字列 と
                              一致します。



                     ?        あらゆる 1 文字と一致します。




                     [...]    カッコ内のいずれかの文字と一致し ま
                              す。2 つの文字を - で区切って指定す
                              ると、システムのデフォルト の 照 合
                              シーケンスに従ってその 2 文字の間の
                              すべての文字 (2 文字自身も含む)  と
                              一致します。なお最初のカッコ [ の直
                              後の文字が ! のとき、結果は保証され
                              ません。



                     !        ! (感嘆符) は否定を表します。たとえ
                              ば  !abc*  と指定すると、文字列 abc
                              で始まるファイル名とは一致 し ま せ
                              ん。


                     pattern 指定において、メタキャラクタ ?  、 *
                     、 [...]  はスラッシュ(/) と一致し、バックス
                     ラッシュ(\) はエスケープと一致します。 複 数
                     pattern も指定可能で、pattern が何も指定され
                     なければデフォルト値として * (すなわち、すべ
                     てのファイルを選択する) が採用されます。各パ
                     ターンは二重引用符で囲む必要があります。

                     そうしないと、現在のディレクトリ内のファイル
                     が使用されることがあります。


【使用法】
     ファイルが 2 ギガバイト (2**31 バイト) 以上ある場合 の  cpio
     の動作については、largefile(5) を参照してください。

【使用例】
     以下に cpio の使用例を示します。

     例 1: 標準入力を使用する

     example% ls | cpio -oc > ../newfile

     上記の例のように標準入力をパイプ経由で cpio -o に 渡 す と、
     ファ イ ル が グ ルー プ 化 さ れて 1 つのアーカイブファイル
     (../newfile) にまとめられます。-c オプションは (-H オプ ショ
     ン と同様に)、アーカイブファイルの他のマシンとの互換性を保証
     します。ファイル名のリストをパイプ経由で cpio に渡す に は、
     ls(1)  の 代わりに find(1)、echo(1)、cat(1) などを使用できま
     す。ファイルではなくデバイスへ出力先を変更することもで き ま
     す。

     例 2: ディレクトリにファイルを抽出する

     example% cat newfile | cpio -icd "memo/a1" "memo/b*"

     この例では、cpio  -i は cpio -o の出力を使用して (cat を使用
     し てパイプに渡している)、パターン (memo/a1、memo/b*) に一致
     するファイルを抽出します。さらに必要に応じて現在のディレクト
     リ下にディレクトリを作成し (-d オプション)、適切なディレクト
     リにファイルを格納します。-c オプションは互換性の あ る ヘッ
     ダー で 入力ファイルが作成されているときに使用します。何もパ
     ターンを指定しないと、newfile 内のすべてのファイルをディレク
     トリに格納します。

     例 3: 別のディレクトリにファイルをコピーまたはリンクする

     example% find . -depth -print | cpio -pdlmv newdir

     この例では、cpio -p はパイプ経由でファイル名を読み込んで、そ
     れらのファイルを別のディレクトリ (newdir) へコピーまたはリン
     ク (-l オプション) します。-d オプションは必要に応じてディレ
     ク ト リ を 作 成します。-m オプションは変更時間を保持します
     (cpio に渡すパス名を作成するには find(1) の -depth オプ ショ
     ン を 使用してください。これによって読み取りのみが許可された
     ディレクトリ下にファイルを作成しようとするときに発生する問題
     を 排除できます)。コピー先のディレクトリ newdir が存在してい
     る必要があります。

     find と一緒に cpio を使用する場合、cpio のオプションに -L を
     使 用しているときは find のオプションに -follow を (逆の場合
     も同様) 使用してください。そうしない場合の結果は保証されませ
     ん。

     マルチリールアーカイブに対しては、古いボリュームのマウントを
     解除し、新しいボリュームをマウントし、さらに次の装置名を入力
     して (通常、最初のリールと同じ) 次のテープに引き継いでくださ
     い。<RETURN> キーを押すと cpio が終了します。

【環境】
     cpio の実行に影響を与える環境 変 数  LC_COLLATE、 LC_CTYPE、
     LC_MESSAGES、 LC_TIME、 TZ、 NLSPATH  に つ い て の詳細は、
     environ(5) を参照してください。

     TMPDIR          cpio の一時ファイル は、 デ フォ ル ト で は
                     /var/tmp  に作成されます。デフォルト以外の場
                     合は、TMPDIR で指定したディレクトリに作成 さ
                     れます。



【終了ステータス】
     以下の終了ステータスが返されます。

     0               正常終了

     >0              エラーが発生した



【属性】
     次の属性については attributes(5) のマニュアルページを参照 し
     てください。
     ____________________________________________________________
    |         属性タイプ          |            属性値           |
    |_____________________________|_____________________________|
    | 使用条件                    | SUNWcsu                     |
    |_____________________________|_____________________________|
    | CSI                         | 対応済み                    |
    |_____________________________|_____________________________|
    | インタフェース安定性        | 安定                        |
    |_____________________________|_____________________________|

【関連項目】
     ar(1), cat(1), echo(1), find(1), ls(1), setfacl(1), sh(  1),
     tar(1),  vold(1M),  archives(4),  attributes(5), environ(5),
     fsattr(5), largefile(5), standards(5)

【注意事項】
     cpio アーカイブで使用できるパス名の最大長は、そのアーカイ ブ
     に含まれているヘッダータイプによって決まります。以下の表に、
     サポートされているヘッダータイプと、そのヘッダータイプで許可
     されている最大パス長を示します。
     ヘッダータイプ       コマンド行オプション   最大パス長
     BINARY               "-o"                   256
     POSIX                "-oH odc"              256
     ASCII                "-oc"                  1023
     CRC                  "-oH crc"              1023
     USTAR                "-oH ustar"            255

     コマンド行オプション"-o -H tar" を指定した場合は、作成される
     アー カイブのタイプは USTAR になります。つまり、このアーカイ
     ブをコマンド行オプション "-i -H tar" を使用して読み込むと エ
     ラーが発生します。このアーカイブの読み込みには、コマンド行オ
     プション "-i -H ustar" を使用してください。"-i -H tar" オ プ
     ションは、古い tar アーカイブ形式を読み込むためのものです。

     選択されたヘッダー形式に対してユーザーID またはグルー プ  ID
     が 大 きすぎるファイルについてはエラーメッセージが出力されま
     す。ユーザーID またはグループ ID のすべての値をサポートで き
     る アーカイブを作成するには、-H crc あるいは -c を使用してく
     ださい。

     スーパーユーザーだけが特殊ファイルをコピーできます。

     512 バイトを 1 ブロックとみなします。
     ファイルのアクセス権が 000 で、なんらかの文字データを持 ち、
     さらにユーザーが root でない場合、そのファイルは保管または復
     元されません。

     ヘッ ダー  に  書  か  れ  て  い  る   i   ノー  ド  番  号
     (/usr/include/archives.h)  は  unsigned  short (2 バイト) で
     す。このため、この i ノード番号は 0 から 65535 までの値と な
     り ます。ハードリンクされたファイルはこの i ノード番号の範囲
     に入る必要があります。これはベンダーが異なるマシン間で  cpio
     アーカイブを移動する場合に問題となることがあります。

     ボリューム管理デーモンが稼働している場合には、/dev/rdiskette
     などの通常のデバイス名を使ってフロッピー装置にアクセスできな
     いことがあります。詳しくは vold(1M) を参照してください。

     テープからハードディスクへファイルを取り出したりコピーしたり
     す る 場合は、ハードディスクからテープへコピーした時と同じブ
     ロック化因数を使用してください。したがって、-B オプション ま
     たは -C オプションを指定してください。

     -p および -o の処理中は、標準入力上のファイルリストは、 cpio
     によって一時ファイルに保存されます。

     大規模ファイルに対しては、新しい pax(1) 形式とそれをサポート
     するコマンド (pax、tar、または cpio など) を使用する必要があ
     ります。現在、cpio コマンドは最新の POSIX 標準の一部でありま
     せんので、pax の方が推奨されます。