home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / FILEMAN / ZTB120 / ARCHIVER.BB2 next >
Text File  |  1994-10-17  |  12KB  |  443 lines
  1. 21
  2. ;That first line is how many lines/record in this archiver.bb2 file...
  3. ;very important, do not change.  Allows future modifications to the
  4. ;file to be transparent to older programs.
  5. ;
  6. ;ARCHIVER.BB2, archiver control file for XBBS-OS/2, XGROUP and AV
  7. ;KEEP A COPY OF THIS ORIGINAL FILE FOR INFORMATION LATER!
  8. ;
  9. ;format for this archiver.bb2 file (each entry has 21 lines):
  10. ;
  11. ; 1st line:  ID of archiver (like ARC, LHARC, PKZIP, etc.; human consumption)
  12. ; 2nd line:  normal extension for archives (like ZIP, ARC, LZH; note no period)
  13. ; 3rd line:  offset into file to signature
  14. ; 4th line:  list command
  15. ; 5th line:  extract command
  16. ; 6th line:  extract w/ directories command
  17. ; 7th line:  test archive command
  18. ; 8th line:  add/create command
  19. ; 9th line:  add/create w/ paths command
  20. ;10th line:  add/create & recurse command
  21. ;11th line:  move command
  22. ;12th line:  move w/ paths command
  23. ;13th line:  delete command
  24. ;14th line:  signature (case sensitive, leading spaces count!
  25. ;15th line:  startlist string
  26. ;16th line:  endlist string
  27. ;17th line:  old size position  (all positions 0-based, -1 = not available)
  28. ;18th line:  new size position
  29. ;19th line:  file date position
  30. ;20th line:  number of positions in dates (for "03 June 92" would be 3)
  31. ;21st line:  file name position (absolutely required, of course)
  32. ;
  33. ;a semicolon demarks a comment.  they may appear at any point *except*
  34. ;within the 21 lines of an archiver entry.  comments are ignored by AV.
  35. ;
  36. ;note that all archiver strings should include the archiver's parameter to
  37. ;prevent it from stopping for input!  also note that archive types are checked
  38. ;in order of their listing in this file.  finally, this file is set up for
  39. ;the archivers I had lying around; if yours are different versions, you may
  40. ;have to modify this file.  All archivers are OS/2 (or FAPI) versions.
  41. ;DOS archivers will NOT work.  I said DOS archivers will NOT work.
  42. ;
  43. ;how archive listing works (for the curious):
  44. ;
  45. ;AV first tries to find a signature match.  failing that, it checks
  46. ;to see if the file might be an ARC-format file.  If the latter, READARC.CMD
  47. ;is spawned (by XBBS) with ARC as the first argument and v as the second,
  48. ;followed by the filename (AV spawns ARC directly).  If the former, the list 
  49. ;command is sent, followed by the filename.  AV (and XBBS) then parses the
  50. ;resultant file using the start and end list lines and offsets in file lines
  51. ;listed in this file for the given archiver.
  52. ;
  53. ;Warning:  I'm told there's a bug in some versions of 4OS2 that can cause
  54. ;a call to an archiver to fail if the archiver has an extension (i.e.
  55. ;UNZIP works, UNZIP.EXE doesn't).  If things fail for no apparent reason
  56. ;and you're using 4OS2 you might keep it in mind.
  57. ;
  58. ;Sample C code to access this information is in sample.c in the AV
  59. ;distribution archive, and is free for the using in your own projects.
  60. ;
  61. ;-----------------Archiver data begins-----------------------
  62. ;
  63. ;This entry is for ZIP 1.9/UNZIP 5.0 (available in 32-bit versions)
  64. ;ZIP/UNZIP should work with PKZIP 2.04 files.  Saves EAs well.  Won't
  65. ;extract a file stored with path without the path (actually, this seems
  66. ;to be fixed now.  Maybe.  There are dozens of versions floating around;
  67. ;you don't pays your money and you takes your chances).  If you have a
  68. ;version that won't extract files with paths without the paths, there's
  69. ;a workaround -- change the line "UNZIP.EXE -jo" below to "UNZIP.EXE -o".
  70. ;Because of broken ZIP archives floating around everywhere, this is here
  71. ;without the version flag in the signature (should really be PK\x3\x4\x14).
  72. ;Damnit, it looks like Katz's own software is what does the botching.  So
  73. ;much for the keeper of the ZIP standard...  Zip still seems to have to
  74. ;have erratic problems with creating archives with some pathnames...
  75. ;
  76. Zip/UnZip 1.9/5.0
  77. ZIP
  78. 0
  79. UNZIP.EXE -vU
  80. UNZIP.EXE -jo
  81. UNZIP.EXE -o
  82. UNZIP.EXE -t
  83. ZIP.EXE -j9
  84. ZIP.EXE -9
  85. ZIP.EXE -r9
  86. ZIP.EXE -mj9
  87. ZIP.EXE -m9
  88. ZIP.EXE -d
  89. PK\x3\x4
  90.  ------  ------   ----  -----   ----    ----   ------     ----
  91.  ------          ------  ---                              -------
  92. 0
  93. 2
  94. 4
  95. 1
  96. 7
  97. ;
  98. ;
  99. ;This entry is for PKZIP 1.01
  100. ;
  101. PK(Un)Zip 1.01
  102. ZIP
  103. 0
  104. PKZIP.EXE -v
  105. PKUNZIP.EXE -o
  106. PKUNZIP.EXE -o -d
  107. PKUNZIP.EXE -t
  108. PKZIP.EXE -a
  109. PKZIP.EXE -a -P
  110. PKZIP.EXE -a -p -r
  111. PKZIP.EXE -m
  112. PKZIP.EXE -m -P
  113. PKZIP.EXE -d
  114. PK\x3\x4\xa
  115.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  116.  ------          ------  ---                                 -------
  117. 0
  118. 2
  119. 4
  120. 2
  121. 8
  122. ;
  123. ;
  124. ;This entry is for PKZIP 1.01 named PK(Un)Zip2
  125. ;
  126. PK(Un)Zip2 1.01
  127. ZIP
  128. 0
  129. PKZIP2.EXE -v
  130. PKUNZIP2.EXE -o
  131. PKUNZIP2.EXE -o -d
  132. PKUNZIP2.EXE -t
  133. PKZIP2.EXE -a
  134. PKZIP2.EXE -a -P
  135. PKZIP2.EXE -a -p -r
  136. PKZIP2.EXE -m
  137. PKZIP2.EXE -m -P
  138. PKZIP2.EXE -d
  139. PK\x3\x4\xa
  140.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  141.  ------          ------  ---                                 -------
  142. 0
  143. 2
  144. 4
  145. 2
  146. 8
  147. ;
  148. ;This entry is for PKZIP self-extractors type 1
  149. ;
  150. PK(Un)Zip SE #1
  151.  
  152. 2934
  153. PKZIP.EXE -v
  154. PKUNZIP.EXE -o
  155. PKUNZIP.EXE -o -d
  156. PKUNZIP.EXE -t
  157.  
  158.  
  159.  
  160.  
  161.  
  162. PKZIP.EXE -d
  163. PK\x3\x4
  164.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  165.  ------          ------  ---                                 -------
  166. 0
  167. 2
  168. 4
  169. 2
  170. 8
  171. ;
  172. ;This entry is for PKZIP self-extractors type 2
  173. ;
  174. PK(Un)Zip SE #2
  175.  
  176. 12784
  177. PKZIP.EXE -v
  178. PKUNZIP.EXE -o
  179. PKUNZIP.EXE -o -d
  180. PKUNZIP.EXE -t
  181.  
  182.  
  183.  
  184.  
  185.  
  186. PKZIP.EXE -d
  187. PK\x3\x4
  188.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  189.  ------          ------  ---                                 -------
  190. 0
  191. 2
  192. 4
  193. 2
  194. 8
  195. ;
  196. ;
  197. ;
  198. ;This entry is for PKZIP self-extractors type 3
  199. ;
  200. PK(Un)Zip SE #2
  201.  
  202. 30948
  203. PKZIP.EXE -v
  204. PKUNZIP.EXE -o
  205. PKUNZIP.EXE -o -d
  206. PKUNZIP.EXE -t
  207.  
  208.  
  209.  
  210.  
  211.  
  212. PKZIP.EXE -d
  213. PK\x3\x4
  214.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  215.  ------          ------  ---                                 -------
  216. 0
  217. 2
  218. 4
  219. 2
  220. 8
  221. ;
  222. ; This entry is for LHarc 2.21.  Supposedly fixes bugs in earlier versions.
  223. ; Actually seems to have done so.  Good work, Peter.
  224. ;
  225. LH2 2.21
  226. LZH
  227. 2
  228. LH2.EXE /o V
  229. LH2.EXE /o x
  230. LH2.EXE /o /s x
  231. LH2.EXE t
  232. LH2.EXE /o a
  233.  
  234. LH2.EXE /o /s a
  235. LH2.EXE /o m
  236.  
  237. LH2.EXE /o d
  238. -lh
  239.   --------  --------  --- -------  -------- ------ ----- ----  ----------------
  240.   --------  --------  ---                                      ----------------
  241. 0
  242. 1
  243. 3
  244. 1
  245. 8
  246. ;
  247. ;
  248. ;This entry is for Unarj 2.30 demo version.  Don't use Unarj 2.41; it's broken.
  249. ;
  250. (Un)Arj 2.41.kkf
  251. ARJ
  252. 0
  253. UNARJ.EXE l
  254. UNARJ.EXE e
  255. UNARJ.EXE x
  256. UNARJ.EXE t
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. \x60\xea
  264. ------------ ---------- ---------- ----- ----------------- -------- -----------
  265. ------------ ---------- ---------- ----- -----------------
  266. 1
  267. 2
  268. 4
  269. 1
  270. 0
  271. ;
  272. ;This entry is for ARC 5.12mpl
  273. ;
  274. Arc 5.12mpl
  275. ARC
  276. 0
  277. ARC.EXE lwn
  278. ARC.EXE ewn
  279.  
  280. ARC.EXE t
  281. ARC.EXE awn
  282.  
  283.  
  284. ARC.EXE mwn
  285.  
  286. ARC.EXE dwn
  287. \x1a
  288. ============  ========  =========
  289.         ====  ========
  290. 1
  291. -1
  292. 2
  293. 3
  294. 0
  295. ;
  296. ;This entry is for ARC2 (6.0)
  297. ;Note that I don't actually have a copy of this...
  298. ;
  299. Arc2 6.0
  300. ARC
  301. 0
  302. ARC.EXE l
  303. ARC.EXE ewn
  304.  
  305. ARC.EXE t
  306. ARC.EXE awn
  307.  
  308.  
  309. ARC.EXE mwn
  310.  
  311. ARC.EXE dwn
  312. \x1a
  313. =================  ========  =========
  314.              ====  ========
  315. 1
  316. -1
  317. 2
  318. 3
  319. 0
  320. ;This entry is for Zoo 2.1
  321. ;
  322. ;NOTE:  Bug in Zoo 2.1 seems to cause files stored with paths to
  323. ;be extracted w/ paths even when you don't ask it to do so...
  324. ;
  325. ;
  326. Zoo 2.1
  327. ZOO
  328. 20
  329. ZOO.EXE v
  330. ZOO.EXE xO
  331. ZOO.EXE xO/
  332. ZOO.EXE -test
  333. ZOO.Exe ah:
  334. ZOO.EXE ah
  335.  
  336. ZOO.EXE aM:h
  337. ZOO.EXE aMh
  338. ZOO.EXE -delete
  339. \xdc\xa7\xc4\xfd
  340. --------  --- --------  --------- --------
  341. --------  --- --------  --------- --------
  342. 0
  343. 2
  344. 3
  345. 3
  346. 7
  347. ;
  348. ;-----------------Archiver data ends-----------------------
  349. ;
  350. ;
  351. ; For possible future use:
  352. ;
  353. ; Squeeze-it signature:  (Offset 0)     \x48\x4C\x53\x51\x5Ah
  354. ; HA signature:          (Offset 0)     HA
  355. ; HAP signature:         (Offset 0)     \x913HF
  356. ; HPK signature:         (Offset 0)     HPAK
  357. ; SQZ signature:         (Offset 0)     HLSQZ
  358. ; DWZ signature:         (Offset -3)    DWC
  359. ;
  360. ; No OS/2 versions available yet to my knowledge...
  361. ;
  362. ;
  363. ;
  364. ;Notes on modifying/updating this file:
  365. ;=====================================
  366. ;
  367. ;You can add as many archivers as you like to this file.
  368. ;here are some suggestions on how to go about it:
  369. ;
  370. ;list an archive with the archiver, redirecting to a disk
  371. ;file (ex. "ARC l AFILE.ARC > TEMP.").  Load the resultant
  372. ;file into a text editor.  Clip out the startlist and endlist
  373. ;strings and paste directly into this file on the appropriate
  374. ;lines; prevents errors due to typos when copying manually.
  375. ;Count the positions of filename, date, etc. and place on the
  376. ;appropriate line.  Now run the archiver redirected to a file
  377. ;to get its help screen (ex. "ARC > TEMP." or "ZOO h > TEMP.").
  378. ;Look for the various command options (extract, list, etc.) and
  379. ;put them into the file on the appropriate lines -- remember to
  380. ;add the modifiers to prevent the archiver from stopping to ask
  381. ;questions!  You could be in deep doo-doo if it's a detached
  382. ;process.  While it may seem a pain in the arse to have to
  383. ;edit this file when an archiver changes its command structure
  384. ;or list format, at least it's something within your control;
  385. ;you don't have to wait for an update to AV.  That means if I
  386. ;die tomorrow you'll still be able to use AV for years to come.
  387. ;
  388. ;Here's an example of an ARC listing (5.12mpl, command "ARC l"):
  389. ;
  390. ;----------------cut here----------------------
  391. ;Name          Length    Date
  392. ;============  ========  =========    <--this line is start-of-list
  393. ;MAKEFILE           374  28 Nov 89
  394. ;QSORT.C          14279  29 Nov 89
  395. ;QSORT.EXE        24629  29 Nov 89
  396. ;STUFF.H            371  29 Nov 89
  397. ;        ====  ========               <--this line is end-of-list
  398. ;Total      4     39653
  399. ;----------------cut here----------------------
  400. ;
  401. ;Note the filename is in position 0, old length in position 1, and the
  402. ;date starts in position 2, with 3 parts, and there's no new length
  403. ;field (so it'd be -1).  Compare that to the archiver entry for
  404. ;ARC 5.12mpl above and you should get a feel for what all those fields
  405. ;mean.  Here's a diagram of how a file line breaks down:
  406. ;
  407. ;STUFF.H            371  29 Nov 89
  408. ;  ^                 ^   ^
  409. ;  |                 |   |
  410. ;  |                 |   +--Date starts in field 2, 3 parts (29, Nov, and 89)
  411. ;  |                 |
  412. ;  |                 +--Old file length, field 1
  413. ;  |
  414. ;  +--Filename, field 0 (count from 0, not 1)
  415. ;
  416. ;
  417. ;If you're adding an entirely new archive format, note that you can
  418. ;use 'C'-style \x<hexnumber> on the signature line in this file.
  419. ;For example, the \x1a in ARC 5.12mpl's signature line means AV will
  420. ;look for an ASCII 26 (text EOF marker) in position 0 (first byte, as
  421. ;indicated by ARC's line 3, the offset into a file for the signature)
  422. ;of a file to determine if it's an archive.  If line 3's offset is
  423. ;negative, AV looks from the end of the file instead of the beginning.
  424. ;You can usually figure out what an archiver's signature is by looking
  425. ;at a few archives with a file viewing program like Vernon Buerg's 
  426. ;LIST.  By all means send me anything new you figure out for inclusion
  427. ;in future releases.
  428. ;
  429. ;
  430. ;You can have several entries for one type of archive in this file.  AV
  431. ;tries entries sequentially to list the file until it finds one that works.
  432. ;If the first entry for a signature doesn't work, and AV finds one that
  433. ;does, it moves that entry to the top of the list and rewrites ARCHIVER.BB2
  434. ;to make future accesses faster.  This allows me to list everything I can
  435. ;get entries for and let AV sort out what the user actually has that works.
  436. ;It also lets you, the user, create archives with more than one archiver that
  437. ;produces the same sort of archive (or with different switches, like one with
  438. ;LHArc producing -lh5- compression and one with it producing old, compatible
  439. ;-lh1- compression).
  440. ;
  441. ;
  442. ;always end file with blank line or comment
  443.