home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / testzip.zip / readme.txt < prev    next >
Text File  |  1997-04-30  |  5KB  |  126 lines
  1. TestZip Version 1.13 for OS/2 and Unix.
  2.  
  3. Programmed by MadMan with suggestions from Pantera: 12/6/96
  4. Modified by Jeff Hamilton, hjeffrey@wam.umd.edu
  5.  
  6. Tests all archives of the specified type and optionally deletes
  7. any bad files.  It can also log the results with 3 levels of
  8. logging.
  9.  
  10. Command Line Options:
  11.  
  12. -? or -h  Display this help text.
  13. -v        Display version information.
  14. -p        Print testzip's configuration to screen.
  15. -D        Delete any bad zip files.
  16. -d        Do Not delete bad files.
  17. -E        Test all defined archive types.
  18. -e        Test only archive type specified by -c.
  19. -t dir    Test all zip files in 'dir' (Default: ./)
  20. -f name   Use 'name' as the log file. (Default: testzip.log)
  21. -o        Overwrite the log file if it already exists.
  22. -a        Append to the log file if it already exists.
  23. -l 0      Log Level 0:  No logging.
  24. -l 1      Log Level 1:  Only bad files logged.
  25. -l 2      Log Level 2:  All files logged.
  26. -c z      Test files compressed using Zip.
  27.  
  28. System Requirements:
  29.   OS/2:
  30.     1.  EMX 0.9c or newer installed and in the path.
  31.     2.  Unzip and other archivers installed and in the path.
  32.  
  33.   Unix:
  34.     1.  CC or GCC installed and in your path.
  35.     2.  Unzip and other archivers installed and in your path.
  36.  
  37.   DOS/Windows:
  38.     Testzip can not be run in DOS at this time.  If I can get it to
  39.     work in DOS, I will release a DOS version at a later time.
  40.  
  41. See Note 1.
  42.  
  43. Installation Instructions:
  44.   OS/2:
  45.     1.  Unzip testzip.zip to a temporary directory.
  46.     2.  Copy testzip.exe and testzip.cfg to any directory in your path.
  47.     3.  Delete the temporary directory.
  48.     4.  Edit your config.sys file and add the following line:
  49.         SET TESTZIP=C:\TESTZIP\
  50.         (change the path to fit your system)
  51.     5.  (optional) Edit testzip.cfg and change preferences.
  52.  
  53.   Unix:
  54.     1.  Unzip testzip.zip to a temporary directory.
  55.     2.  Compile testzip (See Compiling below.)
  56.     3.  Copy testzip and testzip.cfg to your home directory.
  57.     4.  Delete the temporary directory.
  58.     5.  Rename testzip.cfg to .testzipcfg
  59.     6.  (optional) Edit testzip.cfg and change preferences.
  60.  
  61. Compiling:
  62.  
  63.     Testzip has been tested using gcc.  Use this whenever possible.  To compile
  64.     testzip, edit testzip.h and change the settings to match your system.  Once
  65.     you have done this, type:
  66.  
  67.     For OS/2:
  68.        copy Makefile.OS2 Makefile
  69.        make
  70.  
  71.     For Unix:
  72.        cp Makefile.Unix Makefile
  73.        make
  74.  
  75. Version History:
  76.  
  77. Version 1.01: Added prompting for badfiles.txt delete, and
  78.                     support for appending to existing badfiles.txt
  79.               Added prompting for delete verification.
  80. Version 1.02: Added command line options: a,o,D,f,l,h,?
  81.               Removed prompting.
  82.               Added help screen.
  83. Version 1.03: Added command line options: c,v
  84.               Added support for gzip files. (*.gz)
  85.               Added support for tar files. (*.tar)
  86. Version 1.04: Added command line option: d
  87.               Added testing of directory other than current.
  88.               Added conditional compilation for OS/2, Unix,
  89.                     and archivers installed.
  90.               Added support for rar files. (*.rar)
  91.               Fixed status codes if command wasn't found.
  92. Version 1.1:  Added testzip.h to make changing of compile options easier.
  93.               Added testzip.cfg to allow you to set your own default settings.
  94. Version 1.11: Fixed minor bug in configfile parsing.
  95.               Added -e to check all defined archive types.
  96. Version 1.12: Added file permission / in use check.
  97.               Changed command line options. (-D delete, -d no delete, -E do all,
  98.                                              -e not do all, -t test directory)
  99. Version 1.13: Added recursive checking.
  100.               Added command line options.  (-R recursive check, -r No recursive check.)
  101.               Added Makefile for OS/2 and Unix.
  102.  
  103. Known Bugs:   With recursive checking under OS/2, you cannot specify a directory
  104.               using -t that is not on the current drive.  This is due to getwd()
  105.               returning a Unix style path without a drive letter.
  106.  
  107. To Be Added:  File byte check to identify archives instead of using extension.
  108.               Multi-volume archive support.
  109.  
  110. Note 1:
  111.  
  112. OS/2:
  113.  
  114. If you need EMX or any of the archivers, you can get them from the
  115. following locations:
  116.  
  117. EMX 0.9c:          ftp://hobbes.nmsu.edu/os2/unix/emx09c/emxrt.zip
  118. InfoZip's unzip:   http://quest.jpl.nasa.gov/Info-ZIP/
  119. GNU Tar:           ftp://hobbes.nmsu.edu/os2/unix/gnutar.zip
  120. GNU Gzip:          ftp://hobbes.nmsu.edu/os2/unix/gzip124.zip
  121. Rar:               ftp://hobbes.nmsu.edu/os2/archiver/rar200p.exe
  122.  
  123. Unix:
  124.  
  125. InfoZip's unzip:   http://quest.jpl.nasa.gov/Info-ZIP/
  126.