OSDN Git Service

Examine the printf command to pass the test13 on MacOS X
[lha/lha.git] / header.doc.jp
1 /* header.doc (In Japanese) */
2 LHa for UNIX で使用されるヘッダ構造について      Mar. 2, 1992, Masaru Oki.
3
4 ----------------------------------------------------------------
5     本バージョンでは過渡的な措置として3種類のヘッダ形式を用意し、level-1
6   を既定値としていますが、将来的にはパス名の文字数に制限のない level-2に
7   統一する方針です。
8
9
10   A. ヘッダの仕様
11
12 -----------------------------------------------------------------------------
13         level-0                 level-1                 level-2
14 -----------------------------------------------------------------------------
15       1 header size           1 header size           2 total header size
16       1 header sum            1 header sum
17       5 method ID             5 method ID             5 method ID
18 基    4 packed size           4 skip size             4 packed size
19       4 original size         4 original size         4 original size
20 本    2 time                  2 time                  4 time(UNIX type)
21       2 date                  2 date
22 部    1 attribute             1 0x20                  1 RESERVED
23       1 level 0x00            1 level 0x01            1 level 0x02
24 分    1 name length           1 name length
25       ? pathname              ? filename
26       2 file crc              2 file crc              2 file crc
27       . ........              1 OS ID 'U'             1 OS ID 'U'
28                               . ........
29                               2 next-header size      2 next-header size
30     *************************************************************************
31      24 + ?                  27 + ?                  26
32 -----------------------------------------------------------------------------
33 拡                            1 ext-type              1 ext-type
34 張                            . ........              . ........
35 部                            2 next-header size      2 next-header size
36
37 -----------------------------------------------------------------------------
38
39     a. ヘッダの種類
40
41       level-0 ヘッダ
42           従来の LHarc, LArc と同じ形式です。ディレクトリ名の区切りは '\'
43         を標準としています。
44
45       level-1 ヘッダ
46           既定値でこのヘッダが作成されます。-x0 で作成された -lh0- の書庫
47         は LHarc で解凍可能ですが、解凍時に CRC チェックは行われません。
48
49       level-2 ヘッダ
50           長いファイル名をサポートするためのヘッダです。将来的には本ヘッ
51         ダを標準としたいので、LH 関連のユーティリティを作成される方は今後
52         準拠してくださるようにお願いします。
53
54     b. 凍結・解凍可能な method ID について
55
56       * は作成可能な method
57
58       -lh0- * no compression
59
60       -lh1- * 4k sliding dictionary(max 60 bytes) + dynamic Huffman
61               + fixed encoding of position
62
63       -lh2-   8k sliding dictionary(max 256 bytes) + dynamic Huffman
64
65       -lh3-   8k sliding dictionary(max 256 bytes) + static Huffman
66
67       -lh4- * 4k sliding dictionary(max 256 bytes) + static Huffman
68               + improved encoding of position and trees
69
70       -lh5- * 8k sliding dictionary(max 256 bytes) + static Huffman
71               + improved encoding of position and trees
72
73       -lh6-   32k sliding dictionary(max 256 bytes) + static Huffman
74                           + improved encoding of position and trees
75
76       -lh7-   64k sliding dictionary(max 256 bytes) + static Huffman
77                           + improved encoding of position and trees
78
79       -lzs-   2k sliding dictionary(max 17 bytes)
80
81       -lz4-   no compression
82
83       -lz5-   4k sliding dictionary(max 17 bytes)
84
85     c. OS ID について
86
87       現在のところ、以下の ID を予約しています。
88
89         MS-DOS  'M'
90         OS/2    '2'
91         OS9     '9'
92         OS/68K  'K'
93         OS/386  '3'
94         HUMAN   'H'
95         UNIX    'U'
96         CP/M    'C'
97         FLEX    'F'
98         Mac     'm'
99         Runser  'R'
100
101   B. 拡張部分
102
103     a. OS 非依存 (0x00 - 0x3f)
104
105         common header
106          1 0x00
107          2 header crc
108        ( 1 information )
109          2 next-header size
110
111         filename header
112          1 0x01
113          ? filename
114          2 next-header size
115
116         dirname header
117          1 0x02
118          ? dirname
119          2 next-header size
120
121         comment header
122          1 0x3f
123          ? comments
124          2 next-header size
125
126 (以上、吉崎氏の lhx.doc より)
127 ----------------------------------------------------------------
128 LHa for UNIX 拡張ヘッダ仕様
129
130 ・依存情報の種類(格納すべき情報)
131         UNIX に依存する情報で記録すべきは以下のものである。
132         (1) パーミッション
133         (2) GID,UID
134         (3) グループ名、ユーザ名
135         (4) 最終変更時刻(UNIX time)
136
137 ・依存情報のタイプ(ext-type)
138           拡張ヘッダの先頭1バイトには情報が何を示すもの
139         か識別するための値が格納されている。
140         UNIX依存情報として 0x50 - 0x54 を使用する。
141
142 ・依存情報の格納方法
143         上記 (1) - (4) をそれぞれ別のタイプとする。
144
145         (1)パーミッション
146                 size    値
147                 1       0x50
148                 2       パーミッション値
149                 2       next-header size
150
151         (2)GID,UID
152                 size    値
153                 1       0x51
154                 2       GID
155                 2       UID
156                 2       next-header size
157
158         (3)-1 グループ名
159                 1       0x52
160                 ?       グループ名文字列
161                 2       next-header size
162
163         (3)-2 ユーザ名
164                 1       0x53
165                 ?       ユーザ名文字列
166                 2       next-header size
167
168         (4) 最終変更時刻 (for header_level1)
169                 1       0x54
170                 4       UNIX 時間
171                 2       next-header size
172
173 ・LHa for UNIX ver 1.14 での実装(綿崎)
174         上記(3)をサポートしていない。
175         (3)のグループ名、ユーザ名の情報を含む書庫を作成すること
176         はなく、展開時には無視する。
177         また、(4)はヘッダレベル1の書庫にのみ含まれる。
178
179         (3) を作成するようにしてみました。展開と一覧表示のときに (3) 
180         の情報があれば ID に優先します。
181         作成は configure オプション --enable-user-name-header を指定して
182         build したときに有効になります。(2002-06-04 新井)
183
184 ----------------------------------------------------------------
185 以上。
186
187 一部改変:
188 綿崎 修隆 (Nobutaka Watazaki)
189 watazaki@shimadzu.co.jp