home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / hva2001.zip / HVA.DOC next >
Text File  |  1996-02-06  |  4KB  |  102 lines
  1.  
  2.     HVA - the HPFS Volume Analyzer - Version 3.07 (06-Feb-1996)
  3.  
  4.     WARNING: This program may NOT be distributed without written permission
  5.              from the author.  If you received this program from anyone
  6.              other than the author, or OS/2 Support staff, DO NOT USE IT!
  7.  
  8.     WARNING: This program CAN MODIFY YOUR DATA!  If you are unsure of what
  9.              you are doing, DO NOT USE THIS PROGRAM.  If you do use it,
  10.              YOU DO SO AT YOUR OWN RISK!
  11.  
  12.     (C) 1992, 1996 IBM Corp.  All Rights Reserved.
  13.  
  14.     Description:
  15.  
  16.     This program is designed to assist OS/2 support personnel in diagnosing
  17.     errors with HPFS filesystems.  Its main purpose is to scan HPFS file
  18.     allocation information, and report any errors.
  19.  
  20.     Syntax:
  21.  
  22.     HVA [-E] [-D{+|-}] [-N] [-{p|P}nnn] [-R] [-S] [-Vx.y] [-3] filespec
  23.  
  24.        filespec should be a fully-qualified drive\path specification.
  25.        wildcards (? and *) are allowed in the last component of the path.
  26.        Do not use relative paths (paths containing "." or "..").
  27.  
  28.        Switch meanings:
  29.  
  30.          -E       Only display information for files with errors
  31.          -D-      Clear the DIRTY VOLUME flag
  32.          -D+      Set the DIRTY VOLUME flag
  33.          -N       Don't consider FNODE/DIRENT name mismatches as errors
  34.          -pnnn    Search for matching filenames with codepage other than nnn
  35.          -Pnnn    Change codepage to nnn for all matching filenames
  36.          -R       Recurse into subdirectories
  37.          -S       Display more volume information
  38.          -Vx.y    Set HPFS version ID to x.y
  39.          -3       Consider HPFS386 ACL information as errors
  40.  
  41.     Examples of use:
  42.  
  43.     1) If you suspect some kind of error on HPFS drive C:, use the command:
  44.  
  45.           HVA -E -R -S C:\* > A:HVA.LOG
  46.  
  47.        This command process ALL files on C:, but only displays file
  48.        information if it finds an error.  The information is written to the
  49.        log file, "A:HVA.LOG."  This file can be sent to OS/2 support for
  50.        analysis.
  51.  
  52.     2) If you suspect an error on a specific HPFS file, use the command:
  53.  
  54.          HVA -S C:\path\bad_file_name > A:HVA.LOG
  55.  
  56.        This command dumps all HPFS allocation information pertaining to the
  57.        file, "C:\path\bad_file_name" and writes that dump to A:HVA.LOG.
  58.  
  59.     3) If you had to turn off your computer without flushing the filesystem,
  60.        and need to access the drive WITHOUT running CHKDSK, use the command:
  61.  
  62.          HVA -D- C:
  63.  
  64.        This command clears the "dirty" flag on drive C:, which will allow
  65.        HPFS to mount the drive without running an auto-CHKDSK.
  66.  
  67.     4) To find all filenames using codepage other than 437, use the command:
  68.  
  69.          HVA -R -E -p437 C:\*
  70.  
  71.        This command will display an error message if any filename (or
  72.        directory name) is using a codepage other than 437.  Only filenames
  73.        with characters > 0x7F are actually "using" a codepage.
  74.  
  75.     5) To switch codepages on a group of filenames, use the command:
  76.  
  77.          HVA -R -E -P437 C:\*
  78.  
  79.        This will find all filenames using codepages other than 437, and
  80.        change those filenames to 437.
  81.  
  82.        WARNING: This command makes changes to HPFS directory entries.  There
  83.        is no "are you sure" warnings.  You should always redirect the output
  84.        of this command to a logfile, so you can reverse the change if you
  85.        find it wasn't what you expected.  You should also use the -p switch
  86.        first, to see what filenames the -P switch will change.
  87.  
  88.        While the -P switch will change codepages, which will allow you
  89.        to access files with characters that aren't represented in your
  90.        native code page, such a switch can often cause files to fall out
  91.        of lexical order (strict order is required by HPFS).  Once you use
  92.        the -P switch, you should use the same command with -p to see if
  93.        you have created any ordering problems.  Such problems can usually
  94.        be corrected by running CHKDSK, or moving files from one directory
  95.        to another.
  96.  
  97.        NOTE: If the target code page in the -P switch is not already
  98.        recorded on the drive, the -P switch will be ignored, an error
  99.        message will be displayed, and HVA will continue as if the -p switch
  100.        were supplied instead.
  101.  
  102.