home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / HPFSDFRG.ZIP / README.1ST < prev   
Text File  |  1994-03-05  |  4KB  |  110 lines
  1. HPFSDFRG.EXE - Defragment files on an OS/2 HPFS drive.
  2.  
  3. Author: Jack Grey: Compuserve [76040,342], jackgrey@iglou.com
  4.  
  5. Written: December 1993.
  6.  
  7. Compiled February 1994 with the GNU C Compiler version 2.5.8 for EMX 0.8H
  8. with EMX libraries at patch level 5. The EMX .DLL files are not required.
  9.  
  10. ----------------------------------------------------------------------------
  11.  
  12. DISCLAIMER:
  13. -----------
  14.  
  15. In consideration of the use of this program, all USERS ACKNOWLEDGE
  16. THAT THERE ARE NO WARRANTIES AS TO MERCHANTABILITY OR FITNESS FOR
  17. A PARTICULAR PURPOSE AND USERS ACCEPT THE RESPONSIBILITY TO TAKE
  18. SUCH STEPS AS THEY DEEM NECESSARY TO PROTECT THEIR SYSTEMS AND DATA.
  19. THE AUTHOR CANNOT BE LIABLE FOR ANY LOSSES OCCURRING AS A RESULT OF
  20. THE USE OF THIS PROGRAM.
  21.  
  22. YOU USE THIS PROGRAM ENTIRELY AT YOUR OWN RISK.
  23.  
  24. ----------------------------------------------------------------------------
  25.  
  26. Usage: hpfsdfrg <directory name with terminating slash> [-s]
  27.  
  28. -s parm will do all directories below as well
  29.  
  30. Examples:
  31.  
  32. Dir \temp1\ only:                       hpfsdfrg \temp1\
  33.  
  34. Dir \temp1\ and its subdirectories:     hpfsdfrg \temp1\ -s
  35.  
  36. Entire current drive:                   hpfsdfrg \ -s
  37.  
  38. ----------------------------------------------------------------------------
  39.  
  40. IMPORTANT USAGE INSTRUCTIONS! READ PRIOR TO USING HPFSDFRG!
  41. -----------------------------------------------------------
  42.  
  43. As with any utility that makes major changes to files, it is recommended that
  44. DATA BE BACKED UP PRIOR TO THE USE OF HPFSDFRG.
  45.  
  46. This program is to be used only when files are not opened or locked by system
  47. processes. As such, in order to fully defragment a partition, it is recommended
  48. that the system be booted from another partition or floppy disk and the program
  49. itself be loaded from a source other than the target drive. If an open or locked
  50. file is encountered, the program will terminate.
  51.  
  52. The program has been tested under OS/2 2.1 GA and OS/2 2.11 with both HPFS.IFS
  53. and HPFS386.IFS on 80386 and 80486 systems with HPFS partitions as large as
  54. 2 gigabytes.
  55.  
  56. However, IT HAS NOT been tested on IBM Lan Server/Microsoft Lan Manager drives
  57. containing ACL information. As such, please proceed with caution in these
  58. environments. The author would be interested in feedback regarding the use of
  59. hpfsdfrg in these environments.
  60.  
  61. The program sets write verify on during execution. It is recommended that a
  62. minimum-sized HPFS cache be allocated and that the Lazy Write option be set to
  63. OFF ( CACHE /LAZY:OFF or CACHE386 /LAZY:OFF ) prior to running hpfsdfrg.
  64.  
  65. Files flagged System, Hidden, or ReadOnly are not processed.
  66.  
  67. There must be free space available on the drive greater than the size of
  68. the largest file processed by hpfsdfrg.
  69.  
  70. Finally, DO NOT INTERRUPT THE PROGRAM BY PRESSING CTRL-BREAK OR CTRL-C!
  71. DOING SO MAY RESULT IN CORRUPTION OF THE FILE BEING PROCESSED AT THE TIME.
  72. Pressing the ESCAPE key will cause the program to terminate after completing
  73. processing of the current file.
  74.  
  75.  
  76. HOW IT WORKS:
  77. -------------
  78.  
  79. Each file processed is copied to a temporary file named '~~~~~~~~.$$$' in the
  80. current directory. If the copy is successful, the original file is deleted and
  81. the temporary file is renamed to the original file's name. Date stamps and
  82. extended attributes are preserved.
  83.  
  84. The program takes advantage of the HPFS property of attempting to create a file
  85. in a contiguous area of free space on the drive. However, a file may not be
  86. fully defragmented if there is not a contiguous space greater than or equal to
  87. the size of the file. In any case, a minimal number of fragments will be used.
  88.  
  89.  
  90. RECOVERY:
  91. ---------
  92.  
  93. Every effort has been taken to avoid data loss. The program will terminate
  94. if it is able to detect an error condition during execution. However, in the
  95. event the renaming of the temporary file fails, the program will terminate
  96. and the temporary file will remain in the directory being processed at the
  97. time of failure. The name of the file being processed will be displayed and
  98. the user may attempt to recover by manually renaming the temporary file to
  99. the original file name. ONCE AGAIN, PLEASE BACK UP YOUR DATA PRIOR TO USING
  100. HPFSDFRG.
  101.  
  102.  
  103. DISTRIBUTION:
  104. ------------
  105.  
  106. The author offers this program to the public domain for distribution in
  107. unmodified form with all files contained in the archive HPFSDFRG.ZIP. This
  108. documentation file must be included.
  109.  
  110.