日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
LIBARCHIVE-FORMA... FreeBSD ファイルフォーマットマニュアル LIBARCHIVE-FORMA...
名称
libarchive-formats -- libarchive ライブラリによってサポートされたアーカイ
ブ形式
解説
libarchive(3) ライブラリは、さまざまなストリーミングのアーカイブ形式を読
み込みと書き込みします。一般的に言えば、これらのアーカイブ形式のすべて
は、一連の ``エントリ'' から成ります。各エントリは、ファイル、ディレクト
リ、またはシンボリックリンクのような単一のファイルシステムオブジェクトを
格納します。
次は、現在のライブラリサポートの認識された拡張または制限に関する何らかの
情報で、libarchive によってサポートされるそれぞれの形式の簡単な説明を提供
しています。形式が libarchive によってサポートされるからといって、
libarchive を使用するプログラムがその形式をサポートすることを意味しないこ
とに注意してください。libarchive を使用するアプリケーションは、それらがサ
ポートしたい形式を指定しますが、多くのプログラムは、サポートされた形式の
すべてを有効にするために libarchive 便利関数を使用します。
tar 形式
libarchive(3) ライブラリは、ほとんどの tar アーカイブを読み込むことができ
ます。それは、v7 tar 形式と GNU tar 形式の部分集合と同様に、POSIX 標準の
``ustar'' と ``pax interchange'' を書き込むことができます。
すべての tar 形式は、1 つ以上の 512 バイトレコードで各エントリを格納しま
す。最初のレコードは、ファイル名、タイムスタンプ、およびモード情報を含む
ファイルメタデータに使用されます、そして、ファイルデータは、その後のレ
コードに格納されます。後の変形は、複数のレコードへのヘッダを拡張した適切
なヘッダレコードの未定義の領域、またはその後のエントリの解釈を変更する特
別なエントリを格納することによって拡張されています。
gnutar libarchive(3) ライブラリは、ほとんどの GNU 形式 tar アーカイブを
読み込むことができます。それは、現在、atime と ctime データと同様
に、最近のロングファイル名とリンク名サポートを含んでいて、最も一
般的な GNU 拡張をサポートします。libarchive ライブラリは、マルチ
ボリュームアーカイブ、と古い GNU ロングファイル名形式をサポートし
ません。新しい POSIX ベース形式を含む GNU スパースエントリを読み
込むことができます。
libarchive(3) ライブラリは、atime と ctime のデータと同様に、ロン
グファイル名とリンク名 (linkname) のサポートを含む、GNU tar 形式
を書き込むことができます。
pax libarchive(3) ライブラリは、POSIX 準拠の pax 交換形式アーカイブを
読み込み書き込みすることができます。pax 交換形式アーカイブは、各
正規のエントリの直前にキー/値の組として格納される追加属性がある別
々のエントリを追加している、より古い ustar 形式の拡張です。これら
の追加エントリの存在は、pax 交換形式と、古い ustar 形式の間の唯一
の違いです。拡張属性は、無制限な長さがあり、UTF-8 Unicode 文字列
として格納されます。標準で定義されたキーワードは、すべて小文字で
す。ベンダは、すべての大文字のベンダ名を先行することによって、カ
スタムキーを定義することができます。pax アーカイブを書き込むと
き、libarchive は、Joerg Schilling の ``star'' アーカイバと少しの
LIBARCHIVE キーによって定義された SCHILY キーの多くを使用します。
libarchive ライブラリは、SCHILY キーの大部分と GNU tar によって導
入された GNU キーの大部分を読み込むことができます。理解していない
任意のキーワードを静かに無視します。
pax 交換形式は、UTF-8 エンコーディングを使用して、ファイル名を
Unicode に変換し、それらを格納します。libarchive 3.0 より前に、
libarchive は、システムのワイド文字ルーチンがネイティブに Unicode
サポートしていると誤って仮定していました。これは、この仮定を満た
さなかったシステムで ASCII でないファイル名で操作ミスを引き起こし
ます。
制限された pax
また、libarchive ライブラリは、可能ならいつでも、拡張属性エントリ
を削除しようと試みる pax アーカイブを書き込むことができます。拡張
属性エントリが長いファイル名、長いリンク名、拡張 ACL、ファイルフ
ラグを格納する必要がないなら、または標準の ustar データ (ユーザ
名、グループ名、UID、GID など) のいずれかが ustar ヘッダで完全に
表現することができないなら、結果は、ustar アーカイブと同じになり
ます。すべての場合において、POSIX 準拠の pax 交換形式アーカイブを
読み込むことができるどんなプログラムでも結果をアーカイブから取り
出す (dearchive) ことができます。ustar 形式 (下記参照) を正しく読
み込むプログラムは、この形式も読み込むこともできます。任意の拡張
属性は、PaxHeader ディレクトリに格納された個別のファイルとして抽
出されます。
ustar libarchive ライブラリは、この形式を読み込み書き込みすることができ
ます。この形式には、次の制限があります:
• デバイスのメジャとマイナ番号は、21 ビットに制限されます。大き
い数があるノードは、アーカイブに追加されません。
• アーカイブ中のパス名は、255 バイトに制限されます。(右の位置に
正確に / 文字がなければ、短くします。)
• シンボリックリンクとハードリンクは、参照されたファイルの名前
でアーカイブに格納されます。この名前は、100 バイトに制限され
ます。
• 拡張属性、ファイルフラグ、と他の拡張セキュリティ情報は、格納
することができません。
• アーカイブエントリは、8 ギガバイトのサイズに制限されます。
pax 交換形式には、これらの制限がないことに注意してください。ustar
形式は、古くて広くサポートされています。互換性が主要な事柄である
とき、推奨されます。
v7 libarchive ライブラリは、古い v7 tar 形式を読み込み、書き込むこと
ができます。この形式には、次の制限があります:
• 通常のファイル、ディレクトリとシンボリックリンクだけを、アー
カイブすることができます。ブロックとキャラクタデバイスノー
ド、FIFOとソケットは、アーカイブできません。
• アーカイブのパス名は、100 バイトに制限されています。
• シンボリックリンクとハードリンクは、参照されるファイルの名前
でアーカイブに格納されます。この名前は、100 バイトに制限され
ています。
• ユーザとグループ情報は、数値 ID として格納されます。ユーザま
たはグループ名を格納するための用意はありません。
• 拡張された属性、ファイルフラグと他の拡張されたセキュリティ情
報は、格納されません。
• アーカイブエントリは、8 ギガバイトのサイズに制限されていま
す。
一般的に、v7 tar 形式は、有用性が低く、移植性も少ないので、ユーザ
は、移植性のために ustar 形式を好むはずです。
また、libarchive ライブラリは、基本的な tar 形式のいろいろな一般に使用さ
れる拡張を読み込みます。これらの拡張は、それらが現れるときはいつも、自動
的に認識されます。
数値拡張
POSIX 標準は、ターミネータのために予約されている、いくつかの文字
位置に書き込まれている固定長の数字フィールドを必要とします。
libarchive は、ターミネータ文字なしでこれらのフィールドに書き込む
ことができます。これは、許容可能な範囲を拡張しています。特に、こ
の拡張がある ustar アーカイブは、最大 64 ギガバイトのサイズまでの
エントリをサポートすることができます。また、libarchive は、ほとん
どの数字フィールドの base-256 値を認識します。これは、本質的に
ファイルサイズ、更新時刻とデバイス番号ですべての制限を取り除きま
す。
Solaris 拡張
libarchive は、ACL と Solaris tar によって書かれた拡張属性レコー
ドを認識します。
最初の tar プログラムは、1979 年の Seventh Edition Unix で登場しました。
tar ファイル形式のための最初の公式の規格は、1988 年に POSIX によって定義
された ``ustar'' (unix 標準 tar) 形式でした。POSIX.1-2001 は、``pax 交
換'' 形式を作成するために ustar 形式を拡張しました。
cpio 形式
libarchive ライブラリは、多くの一般的な cpio 変形を読み込むことができ
``odc'' と ``newc'' 形式アーカイブを書き込むことができます。cpio アーカイ
ブは、可変長のファイル名と可変長のデータが後に続く固定サイズヘッダとして
各エントリを格納します。tar 形式と異なって、cpio 形式は、ヘッダまたはファ
イルデータに最小の詰め物だけをします。どのように初期のヘッダを格納するか
が主に異なるいくつかの cpio 形式があります: いくつかは、ASCII の 8 進か
16 進数として値を格納し、他は、バイト順と長さを変えるバイナリの値として格
納します。
binary libarchive ライブラリは、元のバイナリ cpio 形式のビッグエンディア
ンとリトルエンディアン異形の両方を透過的に読み込みます。この形式
は、ファイルサイズと mtime には、32 ビットのバイナリ値を使用し、
他のフィールドのためには、16 ビットのバイナリ値を使用します。
odc libarchive ライブラリは、``cpio 交換形式'' または ``オクテット指
向 (octet-oriented) cpio アーカイブ形式'' として公式に知られ、ど
きどき ``古い文字形式'' として非公式に参照される、この POSIX 標準
形式を読み込み書き込みすることができます。この形式は、ASCII で 8
進の値としてヘッダの内容を格納します。それは、標準で、移植可能
で、バイト順混乱の心配がありません。ファイルサイズと mtime は、33
ビット (8GB のファイルサイズ) に制限されて、他のフィールドは、18
ビットに制限されます。
SVR4/newc
libarchive ライブラリは、この形式の CRC と非 CRC 変形の両方を読み
込むことができます。SVR4 形式は、すべてのヘッダフィールドに 8 桁
の 16 進の値を使用します。これは、ファイルサイズを 4GB に制限し
て、mtime と他のフィールドを 32 ビットに制限します。libarchive
は、現在、この CRC について確かめられていませんが、SVR4 形式は、
オプションでファイルの内容の CRC を含むことができます。
cpio は、1977 年に AT&T 中でリリースされた、PWB/UNIX 1.0 ではじめて登場し
ました。PWB/UNIX 1.0 は、1981 年に AT&T の外でリリースされた、System III
Unix の基礎を形成しました。これで、cpio は、tar より古くなりますが、cpio
は、Version 7 AT&T Unix には含まれていませんでした。その結果、tar コマン
ドは、Version 7 を使用した大学と研究グループではるかによく知られるように
なりました。find と cpio ユーティリティの組み合わせは、ファイル選択を行う
上でたいへん正確な制御を提供しました。残念ながら、その形式には、それを広
範に使用することを不適切とする多くの制限があります。POSIX 形式だけが 4GB
以上のファイルを可能にし、他のほとんどのフィールドのための 18 ビットの限
界は、現代のシステムに不適切です。さらに、cpio の形式は、異なるユーザの番
号付けで、システムの向こう側に正しくアーカイブを転送することを非常に難し
くする、(ユーザ名とグループ名でない) 数値の UID/GID 値を格納するだけで
す。
shar 形式
``シェルアーカイブ'' は、POSIX 準拠のシステムで実行されるとき、ファイルシ
ステムオブジェクトの収集を再現するシェルスクリプトです。libarchive ライブ
ラリは、2 つの異なった種類の shar アーカイブを書くことができます:
shar 伝統的な shar 形式は、echo(1), mkdir(1) と sed(1) を含む限られた
ひとそろいの POSIX コマンドを使用します。それは、プレーンテキスト
ファイルの小さな収集を移植可能状態でアーカイブするのに適当です。
しかしながら、それは、一般的に大きなアーカイブに適していません
し、(sh(1) の多くの実装には、スクリプトのサイズに制限があります)
テキストでないファイルにそれを使用するべきではありません。
shardump
この形式は、shar と同様ですが、結果がファイルの内容にかかわらずプ
レーンテキストファイルになるように uuencode(1) を使用してファイル
をエンコードします。また、それは、所有者、モードとフラグ含んで、
できるだけ多くのファイル属性を再現しようと試みる追加のシェルコマ
ンドを含んでいます、ファイル属性を復旧するために使用される追加コ
マンドは、shardump アーカイブを単純な shar アーカイブよりも移植性
がないようにします。
ISO9660 形式
libarchive は、ISO9660 準拠の CDROM イメージに含まれるファイルを読み込
み、抽出することができます。多くの場合、これは、単に ISO9660 イメージ中に
含まれたファイルを読み込むために、物理的な CDROM を焼く必要性を取り除くこ
とができます。また、それは、仮想のマウントとループバックデバイスをもたら
すセキュリティと複雑さの問題を避けます。libarchive は、最も一般的な Rock
ridge 拡張をサポートし、Joliet 拡張の部分的なサポートもあります。両方の拡
張が存在しているなら、Joliet 拡張が使用され、Rockridge 拡張は、無視されま
す。特に、これは、Joliet にはない、Rockridge によってサポートされるハード
リンクとシンボリックリンクの問題を生じさせます。
libarchive は、ストリーミング戦略を使用する ISO9660 イメージを読み込みま
す。これによって、圧縮されたイメージを直接 (その場で圧縮復元して) 読み込
むことができ、ネットワークソケット、パイプと他のシーク不可能なデータソー
スから直接をイメージを読み込むことができます。この戦略は、多くの一般的な
プログラムによって作成された、最適化された ISO9660 イメージに対してよく動
作します。そのようなプログラムは、ISO9660 イメージの最初で、すべてのディ
レクトリ情報を収集するので、最小のシークで物理的なディスクからそれを読み
込むことができます。しかしながら、すべての ISO9660 イメージは、この方法で
読み込むことはできません。
また、libarchive は、ISO9660 イメージを書き込むことができます。そのような
イメージは、すべてのファイルデータに先行するディレクトリの情報で完全に最
適化されます。これは、メモリ中のディレクトリ情報を収集する間にテンポラリ
ファイルへのファイルデータをすべて格納することにより行われます。イメージ
が終了するとき、libarchive は、ファイルデータが後続するディレクトリ構造を
書き込みます。テンポラリファイルのために使用される位置は、通常の環境変数
によって変更することができます。
zip 形式
libarchive は、圧縮復元されたエントリと ``deflate'' アルゴリズムで圧縮さ
れたエントリがある zip 形式アーカイブを読み書きすることができます。それ
は、現在、非圧縮したエントリと ``デフレート'' アルゴリズムで圧縮されたエ
ントリのみをサポートします。他の zip 圧縮アルゴリズムは、サポートされませ
ん。それは、jar アーカイブ、Zip64 拡張を使用するアーカイブ、と自己抽出す
る zip アーカイブを抽出することができます。libarchive は、Zip アーカイブ
を読み込むために、次の 2 つの異なる戦略のいずれかを使用することができま
す: 速くて非常に大きなアーカイブと扱うことができるストリーミング戦略、と
自己抽出の Zip アーカイブと削除されたメンバまたは他のインプレース (in
place) 修正があるアーカイブを正確に処理することができるシーク戦略です。
ストリーミングリーダ (reader) は、それらが読み込まれるように、Zip アーカ
イブを処理します。それは、テープまたはネットワークのソケットから任意のサ
イズのアーカイブを読み込むことができ、別々に圧縮されたかまたはエンコード
された Zip アーカイブをデコードすることができます。しかしながら、自己抽出
の Zip アーカイブと修正の特定のタイプがあるアーカイブは、正確に扱うことが
できません。そのようなアーカイブは、リーダが、通常、Zip アーカイブの終わ
りに位置し、したがって、ストリーミングリーダ (reader) にとってアクセスで
きない、Central Directory (中央のディレクトリ) を最初に処理することを必要
とします。libarchive を使用するプログラムに有効にされたシークサポートがあ
るなら、libarchive は、最初に中央のディレクトリを処理するために、これを使
用します。
特に、シーキングリーダ (seeking reader) は、自己抽出のアーカイブを正確に
操作するために使用されなければなりません。そのようなアーカイブは、通常の
Zip アーカイブが後続するプログラムから成ります。ストリーミングリーダ
(reader) は、最初のプログラム部分を解析することができませんが、シーキング
リーダ (seeking reader) は、アーカイブの終了から Central Directory (中央
のディレクトリ) を読み込むことによって開始します。同様に、インプレース
(in-place) で修正された Zip アーカイブは、最初に Central Directory (中央
のディレクトリ) を読み込むことによって削除されたエントリまたは正確に検出
することだけができる他のごみのデータがあるかもしれません。
アーカイブ (ライブラリ) ファイル形式
(ar(1) アーカイバによって共通に作成される) Unix アーカイブ形式は、リンク
エディタ ld(1) によって読み込まれるオブジェクトファイルのためにほとんど独
占的に使用される汎用形式です。ar 形式は、一度も標準化されたことがありませ
ん。2 つの共通的な変異型があります: SVR4 に由来する GNU 形式と 4.4BSD で
はじめて登場した BSD 形式です。2 つは、主として 15 文字より長いファイル名
の取り扱いで異なります: GNU/SVR4 変異型は、アーカイブの始めにファイル名の
テーブルを書き込みます。BSD 形式は、エントリに隣接している拡張領域に各ロ
ングファイル名を格納します。libarchive は、両方のロングファイル名のタイプ
を含むアーカイブを含んで、両方の拡張を読み込みことができます。libarchive
を使用するプログラムは、それらが、エントリのいずれか前に、アーカイブに書
き込まれるファイル名のテーブルを含んでいる // と呼ばれるエントリを提供す
るるなら、GNU/SVR4 形式を書き込むことができます。名前がファイル名のテーブ
ルにない、すべてのエントリは、BSD スタイルのロングファイル名を使用して書
き込まれます。これは、BSD スタイルのロングファイル名をサポートしない GNU
ld のようなプログラムに対して問題を起こすかもしれません。
mtree
libarchive は、mtree(5) 形式でファイルを読み込み書き込みすることができま
す。この形式は、真のアーカイブ形式ではなく、むしろ各行がファイルの名前を
指定し、そのファイルに関する特定のメタデータを提供するファイルの階層構造
のテキスト型の記述です。libarchive は、mtree(8) の NetBSD と FreeBSD バー
ジョンの両方でサポートされたすべてのキーワードを読み込むことができます
が、現在、archive_entry オブジェクトにキーワードの多くを格納することがで
きません。書き込むとき、libarchive は、どのキーワードが出力に含まれるべき
であるかを指定する archive_write_set_options(3) インタフェースの使用をサ
ポートしています。libarchive が (OpenSSL ライブラリのような) 適切な暗号の
ライブラリへのアクセスでコンパイルされたなら、書き込まれているファイル
データから mtree ライタ (writer) まで sha512 または md5 のようなハッシュ
エントリを計算できます。
mtree ファイルを読み込むとき、libarchive は、存在しているか、または通常の
ファイル名なら、contents キーワードを使用してディスク上の対応するファイル
を位置付けます。ディスク上のファイルを位置付けて、オープンすることができ
るなら、mtree ファイルから失われた任意のメタデータに書き込むために使用
し、ファイルの内容を読み込んで、それらを libarchive を使用してプログラム
に返します。ディスク上のファイルを位置付けて、オープンすることができない
なら、libarchive は、エントリ本体を読み込む試みのためにエラーを返します。
7-Zip
libarchive は、7-Zip 形式のアーカイブを読み込み、書き込むことができます。
TODO: より多くの情報が必要です。
CAB
libarchive は、Microsoft Cabinet (``CAB'') 形式アーカイブを読み込むことが
できます。TODO: より多くの情報が必要です。
LHA
TODO: libarchive の LHA サポートに関する情報。
RAR
libarchive には、RAR 形式のアーカイブを読み込むための制限されたサポートが
あります。現在、libarchive は、圧縮されずに作成された、または RARv3 形式
によってサポートされた圧縮方法のいずれかを使用して圧縮された RARv3 形式の
アーカイブを読み込むことができます。また、libarchive は、自己抽出の RAR
アーカイブを読み込むことができます。
Warc
libarchive は、``web archives'' を読み込み、書き込むことができます。TODO:
より多くの情報が必要です。
XAR
libarchive は、多くの Apple ツールによって使用される XAR 形式を読み込み、
書き込むことができます。TODO: より多くの情報が必要です。
関連項目
ar(1), cpio(1), mkisofs(1), shar(1), tar(1), zip(1), zlib(3), cpio(5),
mtree(5), tar(5)
FreeBSD 11.2 December 27, 2016 FreeBSD 11.2