home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Enter 1999 April / enter_04_1999_1.iso / OS2 / RAR250B2 / TECHNOTE.TXT < prev    next >
Text File  |  1999-01-09  |  10KB  |  365 lines
  1.  
  2.  ██████╗   █████╗  ██████╗
  3.  ██╔══██╗ ██╔══██╗ ██╔══██╗     RAR version 2.50 - Technical information
  4.  ██████╔╝ ███████║ ██████╔╝     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  ██╔══██╗ ██╔══██║ ██╔══██╗
  6.  ██║  ██║ ██║  ██║ ██║  ██║
  7.  ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝
  8.  
  9.  ┌────────────────────────────────────────────────────────────────────────┐
  10.  │THE ARCHIVE FORMAT DESCRIBED BELOW IS ONLY VALID FOR VERSIONS SINCE 1.50│
  11.  └────────────────────────────────────────────────────────────────────────┘
  12.  
  13.  ╔════════════════════════════════════════════════════════════════════════╗
  14.  ║ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ RAR archive file format ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  15.  ╚════════════════════════════════════════════════════════════════════════╝
  16.  
  17.    Archive file consists of variable length blocks. The order of these
  18. blocks may vary, but the first block must be a marker block followed by
  19. an archive header block.
  20.  
  21.    Each block begins with the following fields:
  22.  
  23. HEAD_CRC       2 bytes     CRC of total block or block part
  24. HEAD_TYPE      1 byte      Block type
  25. HEAD_FLAGS     2 bytes     Block flags
  26. HEAD_SIZE      2 bytes     Block size
  27. ADD_SIZE       4 bytes     Optional field - added block size
  28.  
  29.    Field ADD_SIZE present only if (HEAD_FLAGS & 0x8000) != 0
  30.  
  31.    Total block size is HEAD_SIZE if (HEAD_FLAGS & 0x8000) == 0
  32. and HEAD_SIZE+ADD_SIZE if the field ADD_SIZE is present - when
  33. (HEAD_FLAGS & 0x8000) != 0.
  34.  
  35.    In each block the followings bits in HEAD_FLAGS have the same meaning:
  36.  
  37.   0x4000 - if set, older RAR versions will ignore the block
  38.            and remove it when the archive is updated.
  39.            if clear, the block is copied to the new archive
  40.            file when the archive is updated;
  41.  
  42.   0x8000 - if set, ADD_SIZE field is present and the full block
  43.            size is HEAD_SIZE+ADD_SIZE.
  44.  
  45.   Declared block types:
  46.  
  47. HEAD_TYPE=0x72          marker block
  48. HEAD_TYPE=0x73          archive header
  49. HEAD_TYPE=0x74          file header
  50. HEAD_TYPE=0x75          comment header
  51. HEAD_TYPE=0x76          extra information
  52. HEAD_TYPE=0x77          subblock
  53. HEAD_TYPE=0x78          recovery record
  54.  
  55.    Comment block is actually used only within other blocks and doesn't
  56. exist separately.
  57.  
  58.    Archive processing is made in the following manner:
  59.  
  60. 1. Read and check marker block
  61. 2. Read archive header
  62. 3. Read or skip HEAD_SIZE-sizeof(MAIN_HEAD) bytes
  63. 4. If end of archive encountered then terminate archive processing,
  64.    else read 7 bytes into fields HEAD_CRC, HEAD_TYPE, HEAD_FLAGS,
  65.    HEAD_SIZE.
  66. 5. Check HEAD_TYPE.
  67.    In case block read needed:
  68.          if HEAD_TYPE==0x74
  69.            read file header ( first 7 bytes already read )
  70.            read or skip HEAD_SIZE-sizeof(FILE_HEAD) bytes
  71.            read or skip FILE_SIZE bytes
  72.          else
  73.            read corresponding HEAD_TYPE block:
  74.              read HEAD_SIZE-7 bytes
  75.              if (HEAD_FLAGS & 0x8000)
  76.                read ADD_SIZE bytes
  77.    In case block skip needed:
  78.          skip HEAD_SIZE-7 bytes
  79.          if (HEAD_FLAGS & 0x8000)
  80.            skip ADD_SIZE bytes
  81. 6. go to 4.
  82.  
  83.  
  84.  ╔════════════════════════════════════════════════════════════════════════╗
  85.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Block Formats  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  86.  ╚════════════════════════════════════════════════════════════════════════╝
  87.  
  88.  
  89.    Marker block ( MARK_HEAD )
  90.  
  91.  
  92. HEAD_CRC        Always 0x6152
  93. 2 bytes
  94.  
  95. HEAD_TYPE       Header type: 0x72
  96. 1 byte
  97.  
  98. HEAD_FLAGS      Always 0x1a21
  99. 2 bytes
  100.  
  101. HEAD_SIZE       Block size = 0x0007
  102. 2 bytes
  103.  
  104.    The marker block is actually considered as a fixed byte
  105. sequence: 0x52 0x61 0x72 0x21 0x1a 0x07 0x00
  106.  
  107.  
  108.  
  109.    Archive header ( MAIN_HEAD )
  110.  
  111.  
  112. HEAD_CRC        CRC of fields HEAD_TYPE to RESERVED2
  113. 2 bytes
  114.  
  115. HEAD_TYPE       Header type: 0x73
  116. 1 byte
  117.  
  118. HEAD_FLAGS      Bit flags:
  119. 2 bytes
  120.                 0x01    - Volume attribute (archive volume)
  121.                 0x02    - Archive comment present
  122.                 0x04    - Archive lock attribute
  123.                 0x08    - Solid attribute (solid archive)
  124.                 0x10    - Unused
  125.                 0x20    - Authenticity information present
  126.  
  127.                 other bits in HEAD_FLAGS are reserved for
  128.                 internal use
  129.  
  130. HEAD_SIZE       Archive header total size including archive comments
  131. 2 bytes
  132.  
  133. RESERVED1       Reserved
  134. 2 bytes
  135.  
  136. RESERVED2       Reserved
  137. 4 bytes
  138.  
  139.  
  140. Comment block   present if (HEAD_FLAGS & 0x02) != 0
  141.  
  142.  
  143.  
  144.    File header (File in archive)
  145.  
  146.  
  147. HEAD_CRC        CRC of fields from HEAD_TYPE to FILEATTR
  148. 2 bytes         and file name
  149.  
  150. HEAD_TYPE       Header type: 0x74
  151. 1 byte
  152.  
  153. HEAD_FLAGS      Bit flags:
  154. 2 bytes
  155.                 0x01 - file continued from previous volume
  156.                 0x02 - file continued in next volume
  157.                 0x04 - file encrypted with password
  158.                 0x08 - file comment present
  159.                 0x10 - information from previous files is used (solid flag)
  160.                        (for RAR 2.0 and later)
  161.  
  162.                 bits 7 6 5 (for RAR 2.0 and later)
  163.  
  164.                      0 0 0    - dictionary size   64 Kb
  165.                      0 0 1    - dictionary size  128 Kb
  166.                      0 1 0    - dictionary size  256 Kb
  167.                      0 1 1    - dictionary size  512 Kb
  168.                      1 0 0    - dictionary size 1024 Kb
  169.                      1 0 1    - reserved
  170.                      1 1 0    - reserved
  171.                      1 1 1    - file is directory
  172.  
  173.                 (HEAD_FLAGS & 0x8000) == 1, because full
  174.                 block size is HEAD_SIZE + PACK_SIZE
  175.  
  176. HEAD_SIZE       File header full size including file name and comments
  177. 2 bytes
  178.  
  179. PACK_SIZE       Compressed file size
  180. 4 bytes
  181.  
  182. UNP_SIZE        Uncompressed file size
  183. 4 bytes
  184.  
  185. HOST_OS         Operating system used for archiving
  186. 1 byte                 0 - MS DOS
  187.                        1 - OS/2
  188.                        2 - Win32
  189.                        3 - Unix
  190.                        4 - Mac OS
  191.  
  192. FILE_CRC        File CRC
  193. 4 bytes
  194.  
  195. FTIME           Date and time in standard MS DOS format
  196. 4 bytes
  197.  
  198. UNP_VER         RAR version needed to extract file
  199. 1 byte
  200.  
  201. METHOD          Packing method
  202. 1 byte
  203.  
  204. NAME_SIZE       File name size
  205. 2 bytes
  206.  
  207. ATTR            File attributes
  208. 4 bytes
  209.  
  210. FILE_NAME       File name - string of NAME_SIZE bytes size
  211.  
  212.  
  213. Comment block   present if (HEAD_FLAGS & 0x08) != 0
  214.  
  215.  
  216.  
  217.   Comment block
  218.  
  219.  
  220. HEAD_CRC        CRC of fields from HEAD_TYPE to COMM_CRC
  221. 2 bytes
  222.  
  223. HEAD_TYPE       Header type: 0x75
  224. 1 byte
  225.  
  226. HEAD_FLAGS      Bit flags
  227. 2 bytes
  228.  
  229. HEAD_SIZE       Comment header size + comment size
  230. 2 bytes
  231.  
  232. UNP_SIZE        Uncompressed comment size
  233. 2 bytes
  234.  
  235. UNP_VER         RAR version needed to extract comment
  236. 1 byte
  237.  
  238. METHOD          Packing method
  239. 1 byte
  240.  
  241. COMM_CRC        Comment CRC
  242. 2 bytes
  243.  
  244. COMMENT         Comment text
  245.  
  246.  
  247.  
  248.   Extra info block
  249.  
  250.  
  251. HEAD_CRC        Block CRC
  252. 2 bytes
  253.  
  254. HEAD_TYPE       Header type: 0x76
  255. 1 byte
  256.  
  257. HEAD_FLAGS      Bit flags
  258. 2 bytes
  259.  
  260. HEAD_SIZE       Total block size
  261. 2 bytes
  262.  
  263. INFO            Other data
  264.  
  265.  
  266.   Subblock
  267.  
  268. An object in the archive (the block or header) can be followed
  269. by a subblock. The subblock is dependant upon the main object.
  270. Subblock can be erased or moved to a new version of the archive
  271. when it is updated.
  272.  
  273.  The subblock contains the following fields:
  274.  
  275. HEAD_CRC        Block CRC
  276. 2 bytes
  277.  
  278. HEAD_TYPE       Header type: 0x77
  279. 1 byte
  280.  
  281. HEAD_FLAGS      Bit flags
  282. 2 bytes
  283.                 (HEAD_FLAGS & 0x8000) == 1, because full
  284.                 block size is HEAD_SIZE + DATA_SIZE
  285.  
  286. HEAD_SIZE       Total block size
  287. 2 bytes
  288.  
  289. DATA_SIZE       Total data size
  290. 4 bytes
  291.  
  292. SUB_TYPE        Subblock type
  293. 2 bytes
  294.  
  295. RESERVED        Must be 0
  296. 1 byte
  297.  
  298. Other           Other fields depending on the subblock type
  299. fields
  300.  
  301.  
  302.   OS/2 extended attributes subblock
  303.  
  304.  
  305. HEAD_CRC        Block CRC
  306. 2 bytes
  307.  
  308. HEAD_TYPE       Header type: 0x77
  309. 1 byte
  310.  
  311. HEAD_FLAGS      Bit flags
  312. 2 bytes
  313.                 (HEAD_FLAGS & 0x8000) == 1, because full
  314.                 block size is HEAD_SIZE + DATA_SIZE
  315.  
  316. HEAD_SIZE       Total block size
  317. 2 bytes
  318.  
  319. DATA_SIZE       Total data size (packed extended attributes size)
  320. 4 bytes
  321.  
  322. SUB_TYPE        0x100
  323. 2 bytes
  324.  
  325. RESERVED        Must be 0
  326. 1 byte
  327.  
  328. UNP_SIZE        Uncompressed extended attributes size
  329. 4 bytes
  330.  
  331. UNP_VER         RAR version needed to extract extended attributes
  332. 1 byte
  333.  
  334. METHOD          Packing method
  335. 1 byte
  336.  
  337. EA_CRC          Extended attributes CRC
  338. 4 bytes
  339.  
  340.  
  341.  ╔════════════════════════════════════════════════════════════════════════╗
  342.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Application notes  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  343.  ╚════════════════════════════════════════════════════════════════════════╝
  344.  
  345.  
  346.    1. To process an SFX archive you need to skip the SFX module searching
  347. for the marker block in the archive. There is no marker block sequence (0x52
  348. 0x61 0x72 0x21 0x1a 0x07 0x00) in the SFX module itself.
  349.  
  350.    2. The CRC is calculated using the standard polynomial 0xEDB88320. In
  351. case the size of the CRC is less than 4 bytes, only the low order bytes
  352. are used.
  353.  
  354.    3. Packing method encoding:
  355.          0x30 - storing
  356.          0x31 - fastest compression
  357.          0x32 - fast compression
  358.          0x33 - normal compression
  359.          0x34 - good compression
  360.          0x35 - best compression
  361.  
  362.    4. The RAR extraction version number is encoded as 10 * Major version
  363. + minor version.
  364.  
  365.