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