home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Tips & Tricks for Windows 95 / Chip Wintips.iso / sharewar / tools / ztw / archiver.bb2 next >
Encoding:
Text File  |  1996-08-23  |  11.0 KB  |  433 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 PKZIP 1.01
  64. ;
  65. PKZip 2.04g
  66. ZIP
  67. 0
  68. PKZIP.EXE -v
  69. PKUNZIP.EXE -o
  70. PKUNZIP.EXE -o -d
  71. PKUNZIP.EXE -t
  72. PKZIP.EXE -a
  73. PKZIP.EXE -a -P
  74. PKZIP.EXE -a -p -r
  75. PKZIP.EXE -m
  76. PKZIP.EXE -m -P
  77. PKZIP.EXE -d
  78. PK\x3\x4
  79.  ------  ------   ----- -----   ----    ----   -------- ----  ----
  80.  ------          ------  ---                                  -------
  81. 0
  82. 2
  83. 4
  84. 2
  85. 8
  86. ;
  87. ;
  88. ;This entry is for PKZIP 1.01 named PK(Un)Zip2
  89. ;
  90. PK(Un)Zip2 1.01
  91. ZIP
  92. 0
  93. PKZIP2.EXE -v
  94. PKUNZIP2.EXE -o
  95. PKUNZIP2.EXE -o -d
  96. PKUNZIP2.EXE -t
  97. PKZIP2.EXE -a
  98. PKZIP2.EXE -a -P
  99. PKZIP2.EXE -a -p -r
  100. PKZIP2.EXE -m
  101. PKZIP2.EXE -m -P
  102. PKZIP2.EXE -d
  103. PK\x3\x4\xa
  104.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  105.  ------          ------  ---                                 -------
  106. 0
  107. 2
  108. 4
  109. 2
  110. 8
  111. ;
  112. ;This entry is for PKZIP self-extractors type 1
  113. ;
  114. PK(Un)Zip SE #1
  115.  
  116. 2934
  117. PKZIP.EXE -v
  118. PKUNZIP.EXE -o
  119. PKUNZIP.EXE -o -d
  120. PKUNZIP.EXE -t
  121.  
  122.  
  123.  
  124.  
  125.  
  126. PKZIP.EXE -d
  127. PK\x3\x4
  128.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  129.  ------          ------  ---                                 -------
  130. 0
  131. 2
  132. 4
  133. 2
  134. 8
  135. ;
  136. ;This entry is for PKZIP self-extractors type 2
  137. ;
  138. PK(Un)Zip SE #2
  139.  
  140. 12784
  141. PKZIP.EXE -v
  142. PKUNZIP.EXE -o
  143. PKUNZIP.EXE -o -d
  144. PKUNZIP.EXE -t
  145.  
  146.  
  147.  
  148.  
  149.  
  150. PKZIP.EXE -d
  151. PK\x3\x4
  152.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  153.  ------          ------  ---                                 -------
  154. 0
  155. 2
  156. 4
  157. 2
  158. 8
  159. ;
  160. ;
  161. ;
  162. ;This entry is for PKZIP self-extractors type 3
  163. ;
  164. PK(Un)Zip SE #2
  165.  
  166. 30948
  167. PKZIP.EXE -v
  168. PKUNZIP.EXE -o
  169. PKUNZIP.EXE -o -d
  170. PKUNZIP.EXE -t
  171.  
  172.  
  173.  
  174.  
  175.  
  176. PKZIP.EXE -d
  177. PK\x3\x4
  178.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  179.  ------          ------  ---                                 -------
  180. 0
  181. 2
  182. 4
  183. 2
  184. 8
  185. ;
  186. ; This entry is for LHA 2.55
  187. ;
  188. LH 2.55
  189. LZH
  190. 2
  191. LHA.EXE V /o
  192. LHA.EXE x /o
  193. LHA.EXE x /o /s
  194. LHA.EXE t
  195. LHA.EXE a /o
  196.  
  197. LHA.EXE a /o /s 
  198. LHA.EXE m /o 
  199.  
  200. LHA.EXE d /o 
  201. -lh
  202.   --------  --------  --- -------  -------- ------ ----- ----  ----------------
  203.   --------  --------  ---                                      ----------------
  204. 0
  205. 1
  206. 3
  207. 1
  208. 8
  209. ;
  210. ;
  211. ;This entry is for Arj 2.8 by ARJ software
  212. ;
  213. Arj 2.8
  214. ARJ
  215. 0
  216. ARJ.EXE l
  217. ARJ.EXE e
  218. ARJ.EXE x
  219. ARJ.EXE t
  220. ARJ.EXE a -e -jm
  221. ARJ.EXE a -jm
  222. ARJ.EXE a -r
  223. ARJ.EXE m -e
  224. ARJ.EXE m 
  225. ARJ.EXE d
  226. \x60\xea
  227. ------------ ---------- ---------- ----- ----------------- -------- -----------
  228. ------------ ---------- ---------- -----
  229. 1
  230. 2
  231. 4
  232. 1
  233. 0
  234. ;
  235. ;This entry is for ARC 5.12mpl
  236. ;
  237. Arc 5.12mpl
  238. ARC
  239. 0
  240. ARC.EXE lwn
  241. ARC.EXE ewn
  242.  
  243. ARC.EXE t
  244. ARC.EXE awn
  245.  
  246.  
  247. ARC.EXE mwn
  248.  
  249. ARC.EXE dwn
  250. \x1a
  251. ============  ========  =========
  252.         ====  ========
  253. 1
  254. -1
  255. 2
  256. 3
  257. 0
  258. ;
  259. ;This entry is for ARC2 (6.0)
  260. ;Note that I don't actually have a copy of this...
  261. ;
  262. Arc2 6.0
  263. ARC
  264. 0
  265. ARC.EXE l
  266. ARC.EXE ewn
  267.  
  268. ARC.EXE t
  269. ARC.EXE awn
  270.  
  271.  
  272. ARC.EXE mwn
  273.  
  274. ARC.EXE dwn
  275. \x1a
  276. =================  ========  =========
  277.              ====  ========
  278. 1
  279. -1
  280. 2
  281. 3
  282. 0
  283. ;This entry is for Zoo 2.1
  284. ;
  285. ;NOTE:  Bug in Zoo 2.1 seems to cause files stored with paths to
  286. ;be extracted w/ paths even when you don't ask it to do so...
  287. ;
  288. ;
  289. Zoo 2.1
  290. ZOO
  291. 20
  292. ZOO.EXE v
  293. ZOO.EXE xO
  294. ZOO.EXE xO/
  295. ZOO.EXE -test
  296. ZOO.Exe ah:
  297. ZOO.EXE ah
  298.  
  299. ZOO.EXE aM:h
  300. ZOO.EXE aMh
  301. ZOO.EXE -delete
  302. \xdc\xa7\xc4\xfd
  303. --------  --- --------  --------- --------
  304. --------  --- --------  --------- --------
  305. 0
  306. 2
  307. 3
  308. 3
  309. 5
  310. ;
  311. ;
  312. ;This entry is for RAR2 1.55
  313. ;
  314. ;Doesn't currently support Alt_F5
  315. ;
  316. RAR 1.55
  317. RAR
  318. 0
  319. RAR2.EXE l -std
  320. RAR2.EXE o
  321. RAR2.EXE o -std -d
  322. RAR2.EXE t -std
  323. RAR2.EXE a -std
  324. RAR2.EXE a -std 
  325. RAR2.EXE a -std -r
  326. RAR2.EXE m -std
  327. RAR2.EXE m -std 
  328. RAR2.EXE d -std
  329. Rar!
  330. -------------- ------- -------- ------ -------- ----- ------ -------- ---- ---
  331. -------------- ------- -------- ------ -------- ----- ------ -------- ---- ---
  332. 1
  333. 2
  334. 4
  335. 3
  336. 0
  337. ;
  338. ;-----------------Archiver data ends-----------------------
  339. ;
  340. ;
  341. ; For possible future use:
  342. ;
  343. ; Squeeze-it signature:  (Offset 0)     \x48\x4C\x53\x51\x5Ah
  344. ; HA signature:          (Offset 0)     HA
  345. ; HAP signature:         (Offset 0)     \x913HF
  346. ; HPK signature:         (Offset 0)     HPAK
  347. ; SQZ signature:         (Offset 0)     HLSQZ
  348. ; DWZ signature:         (Offset -3)    DWC
  349. ;
  350. ; No OS/2 versions available yet to my knowledge...
  351. ;
  352. ;
  353. ;
  354. ;Notes on modifying/updating this file:
  355. ;=====================================
  356. ;
  357. ;You can add as many archivers as you like to this file.
  358. ;here are some suggestions on how to go about it:
  359. ;
  360. ;list an archive with the archiver, redirecting to a disk
  361. ;file (ex. "ARC l AFILE.ARC > TEMP.").  Load the resultant
  362. ;file into a text editor.  Clip out the startlist and endlist
  363. ;strings and paste directly into this file on the appropriate
  364. ;lines; prevents errors due to typos when copying manually.
  365. ;Count the positions of filename, date, etc. and place on the
  366. ;appropriate line.  Now run the archiver redirected to a file
  367. ;to get its help screen (ex. "ARC > TEMP." or "ZOO h > TEMP.").
  368. ;Look for the various command options (extract, list, etc.) and
  369. ;put them into the file on the appropriate lines -- remember to
  370. ;add the modifiers to prevent the archiver from stopping to ask
  371. ;questions!  You could be in deep doo-doo if it's a detached
  372. ;process.  While it may seem a pain in the arse to have to
  373. ;edit this file when an archiver changes its command structure
  374. ;or list format, at least it's something within your control;
  375. ;you don't have to wait for an update to AV.  That means if I
  376. ;die tomorrow you'll still be able to use AV for years to come.
  377. ;
  378. ;Here's an example of an ARC listing (5.12mpl, command "ARC l"):
  379. ;
  380. ;----------------cut here----------------------
  381. ;Name          Length    Date
  382. ;============  ========  =========    <--this line is start-of-list
  383. ;MAKEFILE           374  28 Nov 89
  384. ;QSORT.C          14279  29 Nov 89
  385. ;QSORT.EXE        24629  29 Nov 89
  386. ;STUFF.H            371  29 Nov 89
  387. ;        ====  ========               <--this line is end-of-list
  388. ;Total      4     39653
  389. ;----------------cut here----------------------
  390. ;
  391. ;Note the filename is in position 0, old length in position 1, and the
  392. ;date starts in position 2, with 3 parts, and there's no new length
  393. ;field (so it'd be -1).  Compare that to the archiver entry for
  394. ;ARC 5.12mpl above and you should get a feel for what all those fields
  395. ;mean.  Here's a diagram of how a file line breaks down:
  396. ;
  397. ;STUFF.H            371  29 Nov 89
  398. ;  ^                 ^   ^
  399. ;  |                 |   |
  400. ;  |                 |   +--Date starts in field 2, 3 parts (29, Nov, and 89)
  401. ;  |                 |
  402. ;  |                 +--Old file length, field 1
  403. ;  |
  404. ;  +--Filename, field 0 (count from 0, not 1)
  405. ;
  406. ;
  407. ;If you're adding an entirely new archive format, note that you can
  408. ;use 'C'-style \x<hexnumber> on the signature line in this file.
  409. ;For example, the \x1a in ARC 5.12mpl's signature line means AV will
  410. ;look for an ASCII 26 (text EOF marker) in position 0 (first byte, as
  411. ;indicated by ARC's line 3, the offset into a file for the signature)
  412. ;of a file to determine if it's an archive.  If line 3's offset is
  413. ;negative, AV looks from the end of the file instead of the beginning.
  414. ;You can usually figure out what an archiver's signature is by looking
  415. ;at a few archives with a file viewing program like Vernon Buerg's 
  416. ;LIST.  By all means send me anything new you figure out for inclusion
  417. ;in future releases.
  418. ;
  419. ;
  420. ;You can have several entries for one type of archive in this file.  AV
  421. ;tries entries sequentially to list the file until it finds one that works.
  422. ;If the first entry for a signature doesn't work, and AV finds one that
  423. ;does, it moves that entry to the top of the list and rewrites ARCHIVER.BB2
  424. ;to make future accesses faster.  This allows me to list everything I can
  425. ;get entries for and let AV sort out what the user actually has that works.
  426. ;It also lets you, the user, create archives with more than one archiver that
  427. ;produces the same sort of archive (or with different switches, like one with
  428. ;LHArc producing -lh5- compression and one with it producing old, compatible
  429. ;-lh1- compression).
  430. ;
  431. ;
  432. ;always end file with blank line or comment
  433.