home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / zipbr101.zip / ZIPBRAND.DOC < prev    next >
Text File  |  1994-03-08  |  9KB  |  236 lines
  1. +---------------------------------------------------------------------+
  2. |                                                                     |
  3. | ╓-+  -╥- ╥--+    ╥-+  ╥--+ ╓--+ ╓--+ ╥--+    ╥--+ ╓--+  ╓-+ ╓-╥-+ ╥ |
  4. | ╓-+   ║  ╟--+    ╟-┴+ ╟-┬+ ╟--┤ ║  | ║  |    ╟-   ╟--┤  ╙-+   ║   ║ |
  5. | ╙--+ -╨- ╨       ╨--+ ╨ ┴  ╨  ┴ ╨  ┴ ╨--+    ╨    ╨  ┴ ╙--+   ╨   o |
  6. |                         (ZIP Brand FAST!)                           |
  7. |                                                                     |
  8. |                  v1.01.  Released on March 8. 1994                  |
  9. |                  Copyright 1993-1994  Ketil Kintel                  |
  10. |                                                                     |
  11. +---------------------------------------------------------------------+
  12.  
  13. If you run a BBS or ever used the -z switch with your ZIP utility, you
  14. will know what to use this utility for.
  15.  
  16. This is a small program (it) to safely and quickly brand your ZIP files
  17. with a comment of your choice. The typical speed is 10-30 files a
  18. second. This is more than 10 times faster than PKZIP v2, and about 100
  19. times faster than Info Zip. The comment is obtained from a arbitary
  20. text file. The program will search for unmarked zip files in the
  21. current directory, and all directories below.
  22.  
  23. As a file is marked, the file time is set to 00:00:00. This is to avoid
  24. processing an already branded file when the program is run again later.
  25.  
  26. If it encounters any problem with your file, nothing will be done.  It
  27. will not write to any file if it isn't 100% shure of what it is doing.
  28. I have used the engine for this program in almost a year now.
  29. Thousands and thousands of file have been marked with it, and it has
  30. NEVER damaged any file. HOWEVER THIS PROGRAM IS PROVIDED "AS IS", AND
  31. NO WARRANTIES AT ALL ARE GRANTED!
  32.  
  33.  
  34.  
  35.                             +------------+
  36.                             |Installation|
  37.                             +------------+
  38.  
  39. Copy the file ZIPBRAND.EXE to a directory of your choice. If you
  40. haven't got a comment file, create one now. Use the file ZIPBRAND.CMT
  41. included in this archive as an example. The prefered location of this
  42. file is in the same directory as ZIPBRAND.EXE, but anywhere will do.
  43.  
  44. But if this comment isn't in the same directory as ZIPBRAND.EXE, or in
  45. the current directory when the program is run, you will have to specify
  46. the path with the parameter [CommentFile].
  47.  
  48.  
  49.  
  50.              +------------------------------------------+
  51.              |Protecting against tampering, viruses etc.|
  52.              +------------------------------------------+
  53.  
  54. If you want to make shure that the program is not tampered with in any
  55. way, the PGP (Pretty Good Privacy) 2.3a Signature is enclosed in the
  56. file ZIPBRAND.SIG. If you don't have my Public Key, drop me a line, and
  57. I will send it to you.
  58.  
  59. If you use PGP, you will know how to verify this program.
  60. For those who don't: There are no other secure way of detecting
  61. tampering with this file than by using PGP. All other methods can be
  62. forged. PGP is one of the most secure and easiest way to communicate
  63. with encryped or signed messages. It is free and can be obtained from
  64. almost anywhere. Definitely worth a look!
  65.  
  66.  
  67.  
  68.                        +----------------------+
  69.                        |Command line arguments|
  70.                        +----------------------+
  71.  
  72. ZipBrand [StartPath] [CommentFile] [/V] [[/R] | [/T]] [/Bxxxxx] [/?]
  73.  
  74. All arguments are optional. Please note that they MUST be separated by
  75. a space.  The order is arbitary.
  76.  
  77. StartPath
  78. ---------
  79. Any directory specified on the command line will indicate the path
  80. where th program  will start branding files. Files in all sub
  81. directories will also be branded.
  82.  
  83. The default is the current directory.
  84.  
  85. CommentFile
  86. -----------
  87. Any filename specified on the command line will indicate what file the
  88. comment is to be taken from. This file can be of any type, but a text
  89. file is naturally perfered.
  90.  
  91. The default is ZIPBRAND.CMT in the current directory. If it doesn't exist,
  92. the file in the program directory is used.
  93.  
  94. /R (Reprocess)
  95. --------------
  96. This switch indicates that all ZIP files, regardless of what the file
  97. time is set to, will be reprocessed. This is useful if you want to
  98. brand the ZIPs with a different comment.
  99.  
  100. /T (No Time Stamp)
  101. ------------------
  102. This switch stops the program from marking the files by altering the
  103. file time. Previous markings are ignored, so all files will be
  104. reprocessed. (Big waste of time.)
  105.  
  106. /V (Verbose)
  107. ------------
  108. Makes the program show some output. Both the comment and the files
  109. processed will be listed. This switch slows down program execution.
  110.  
  111. The default is that only error messages will be displayed.
  112.  
  113. /B (Block Read Size)
  114. --------------------
  115. This switch tells the program what block size to use for read
  116. operations. This is to fine tune the performance on individual systems.
  117. This value also reflects the minimum file size to be processed. All
  118. files wich are smaller than this size will be skipped.
  119.  
  120. The optimal value depends on your HD and cache configuration, but a
  121. suggestion will be a value right above the size of the orginal or the
  122. new comment (wichever is the greater.)
  123.  
  124. The default is 2048 bytes.
  125.  
  126. /? or /H (Help)
  127. ---------------
  128. Displays the adress of the author, licence information and how to use
  129. the program, including all command line arguments.
  130.  
  131.  
  132.  
  133.                            +--------------+
  134.                            |Error Messages|
  135.                            +--------------+
  136.  
  137. Acess Denied: <FileName>
  138. ------------------------
  139. Meaning:        The file could not be opened for reading and writing.
  140.                 This is probably because some other process has opened
  141.                 the file.
  142.  
  143. Solution:       Try running the program again at a later time or close
  144.                 the process witch is holding the file to brand it.
  145.  
  146. Not a .ZIP File: <FileName>
  147. ---------------------------
  148. Meaning:        The file has a .ZIP extension, but was not recogniced
  149.                 as a valid zip file.
  150.  
  151. Inconsistence in <FileName>
  152. ---------------------------
  153. Meaning:        The file was recogniced as a zip file, but the program
  154.                 could not find the comment header. This is probably
  155.                 because the file has been damaged by some other zip
  156.                 file utility.
  157.  
  158.                 This error also occures if the old comment is VERY
  159.                 huge. (Larger than 16kb or 10-15 pages.) Mail me if
  160.                 this is is a problem!
  161.  
  162. Solution:       Run PKZIPFIX (or Info Zip with the switch -F) on the file to
  163.                 reconstruct the file.
  164.                 If the error still occures, run your zip utility with
  165.                 the parameter -z on the file.
  166.  
  167. Could not read <FileName>
  168. -------------------------
  169. Meaning:        The file was successfully opened and recogniced as a
  170.                 zip file, but the program was not able to read from
  171.                 it. This is a very, very rare situation and will
  172.                 probably only happen if your operating system is at an
  173.                 unstable state.
  174.  
  175. Solution:       Reboot the operating system. Please mail the author if
  176.                 you get this error message.
  177.  
  178.  
  179.  
  180.                                +-------+
  181.                                |Licence|
  182.                                +-------+
  183.  
  184. This program is NOT freeware. You have permission to evaluate this
  185. program for a period of 21 days. If you continue using this program
  186. after this period, you have to register with the author.
  187.  
  188. This is done by dropping me a line, by electronic or ordinary mail, for
  189. instace: "Hi! My name is ... I use your great program at ..."
  190.  
  191. A licence to continue using this program will then be granted to you
  192. at no cost at all! (This is the deal of a lifetime...)
  193.  
  194. THIS PROGRAM IS PROVIDED "AS IS", AND NO WARRANTIES AT ALL ARE GRANTED!
  195.  
  196.  
  197.  
  198.                              +----------+
  199.                              |The Future|
  200.                              +----------+
  201.  
  202. A 32 bit OS/2 version of this program is also developed, but will not
  203. be released unless at least a few of you requests so.
  204. It has the same features as the DOS version, but also includes the
  205. setting of priority and a option to be reactivated with a given
  206. interval.
  207.  
  208. A Windows version is also under development. It is present at the alpa
  209. stadium, and will probably never be finished. This is because the DOS
  210. version runs a LOT faster.
  211.  
  212. The support for other archive types (e.g. ARJ) might also be included
  213. in future releases if the interest is big enough.
  214.  
  215. But anyway: If you have any comments or suggestions of improvements,
  216. please drop me a line, and I will see what I can do about it.
  217.  
  218.  
  219.  
  220.                         +---------------------+
  221.                         |Contacting the Author|
  222.                         +---------------------+
  223.  
  224. Ketil Kintel
  225. Computer Science, Rogaland University Centre, Norway.
  226.  
  227. E-MAIL     : Internet   : kintel@hsr.no
  228.              X.400      : S=kintel; O=hsr; P=uninett; A=uninett; C=no;
  229.  
  230.              My PGP 2.3 Public Key is available on request, from me or
  231.              from any Public Keys Server.
  232.  
  233. SNAIL-MAIL : Ugleveien 8-105, N-4042 Hafrsfjord, Norway.
  234.  
  235. VOICE      : +47 51 554485
  236.