home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 16 / 16.iso / t / t277 / 1.img / WIPEOUT.DOC < prev    next >
Encoding:
Text File  |  1993-10-28  |  11.6 KB  |  252 lines
  1. =============================================================================
  2.                      USER INSTRUCTIONS FOR "WIPEOUT.EXE"
  3.                           (freeware by Steve Dunn)
  4.                            V1.2 Released 10/28/93
  5. =============================================================================
  6.  
  7.  
  8.     Thanks for trying my freeware program, "WIPEOUT.EXE".  You should have
  9. received three files as part and parcel of this software program -
  10.  
  11.     [1] WIPEOUT.EXE - the main program executable file
  12.  
  13.     [2] WIPEOUT.INI - the configuration list of files to be excluded from
  14.                       processing by WIPEOUT.EXE (can be overridden at run
  15.                       time by use of the "/I" command line parm).
  16.  
  17.     [3] WIPEOUT.DOC - this file, containing program documentation.
  18.  
  19.  
  20.  
  21.     =====================================================================
  22.     *** PLEASE READ THIS DOCUMENTATION FULLY BEFORE USING WIPEOUT.EXE ***
  23.     =====================================================================
  24.  
  25.  
  26.  
  27.     This program may be copied and distributed freely for any not-for-profit
  28. use by anyone and/or any organization.  You are under no obligation to send
  29. me (or anyone else!) any money for using this utility.
  30.  
  31.  
  32.     However, please be aware that this software is provided "as-is", and by
  33. the act of using it, YOU AGREE TO ACCEPT FULL RESPONSIBILITY FOR ANY AND ALL
  34. CONSEQUENCES.
  35.  
  36.  
  37.     I welcome your feedback, input, etc on this utility.  The best way to
  38. reach me is via CompuServe - 70034,2454
  39.  
  40.  
  41.     WIPEOUT.EXE was written primarily in Microsoft BASIC V7.1 and includes a
  42. few "home-grown" assembly language routines.  If you'd like the source code,
  43. please feel free to contact me via CompuServe.
  44.  
  45.  
  46.     WIPEOUT.EXE should function on any 100% MS-DOS compatible machine, using
  47. DOS V2.0 or higher.
  48.  
  49. -----------------------------------------------------------------------------
  50.                             WHAT IS WIPEOUT.EXE?
  51. -----------------------------------------------------------------------------
  52.  
  53.     WIPEOUT.EXE is an improved file-deletion utility which provides a measure
  54. of security against the various "file un-deletion" utilities currently on the
  55. market.  Since WIPEOUT will delete ANY file (including READ-ONLY, HIDDEN, and
  56. SYSTEM files) beyond recovery, BE *CAREFUL* WHEN USING WIPEOUT!!
  57.  
  58.  
  59.     WIPEOUT.EXE is invoked from the DOS command line by simply typing:
  60.  
  61.                    WIPEOUT [d:][\path\] filespec.ext [/I] [/?]
  62.  
  63.     where
  64.  
  65.             [d:]    - is an optional drive specification.  The default here
  66.                     will be the current DOS default drive.
  67.  
  68.         [\path\]    - is an optional DOS path specification.  The default
  69.                     here will be the current DOS path.
  70.  
  71.     filespec.ext    - is a NON-OPTIONAL DOS file name specification.
  72.                     Note that DOS wildcard characters ("*" and "?") are
  73.                     recognized.
  74.                     - If you omit this parameter, WIPEOUT.EXE will only 
  75.                     display a summary usage info screen.
  76.  
  77.             [/I]    - is an OPTIONAL parm which instructs WIPEOUT to ignore
  78.                     the WIPEOUT.INI file (which includes the names of files
  79.                     which should NEVER be wiped out, such as COMMAND.COM for
  80.                     example).
  81.                     - See the section below named "USING WIPEOUT.INI" for
  82.                     more detailed info.
  83.                     - IF YOU USE THIS PARAMETER, the "/I" MUST BE THE
  84.                     FINAL 2 CHARACTERS ON THE COMMAND LINE.  This is
  85.                     (hopefully) for your added safety...
  86.  
  87.             [/?]    - causes WIPEOUT.EXE to display summary usage
  88.                     instructions.  Note that simply typing WIPEOUT alone,
  89.                     with NO other parms, also brings up this summary usage
  90.                     info.
  91.                     - If the "/?" characters appear ANYWHERE on the
  92.                     command line, you will get this summary usage info.
  93.  
  94.  
  95.     NOTE:   - WIPEOUT.EXE will never take action without giving you at least
  96.             one chance to back out - see "USING WIPEOUT.EXE - Secure File
  97.             Deleter", below.
  98.  
  99.             - In other words, you can type "WIPEOUT *.*" without fear!
  100.             You'll get a chance to confirm all, some, or none of the files at
  101.             the next step in the process!
  102.  
  103.             - WIPEOUT.EXE can handle up to a maximum of 5,000 files per
  104.             directory.
  105.  
  106.                    USING WIPEOUT.EXE - Secure File Deleter
  107.                    ---------------------------------------
  108.  
  109.     When you have invoked WIPEOUT.EXE, you will be presented with a screen
  110. which tells you how many matching files have been found, and how 
  111. many "protected" file names have been found in WIPEOUT.INI (if any) and 
  112. asking you to select one of the following four options:
  113.  
  114.  
  115.     [1]     Press F1 to display a sorted listing of all files WIPEOUT.EXE is
  116.     preparing to process.  Note that any files which match names in the
  117.     WIPEOUT.INI file (see below, and assuming you have not used the "/I"
  118.     command line parm when invoking WIPEOUT.EXE) will appear in a dimmer
  119.     color than those which do not match any file name in WIPEOUT.INI.
  120.     WIPEOUT.EXE will NOT wipe these files during this session, no matter
  121.     what.   Note that WIPEOUT.EXE can handle a maximum of 5,000 file
  122.     names per DOS directory.
  123.  
  124.  
  125.     [2]     Press F2 to begin wiping out the matching files on a one-by-one
  126.     basis.  Note that protected files (file names which appear in
  127.     WIPEOUT.INI) are automatically (and unavoidably) skipped (unless
  128.     the "/I" command line option was used when invoking WIPEOUT.EXE).
  129.  
  130.             As each file is displayed, you are asked to select a one-letter
  131.     option, from the choices which follow:
  132.  
  133.         Y   = yes, go ahead and wipeout this one file
  134.         N   = no, skip this one file
  135.         A   = yes, wipe out this file AND ALL THE REST OF THE MATCHING FILES
  136.             WITHOUT ASKING FOR ANY FURTHER CONFIRMATION.
  137.         Q   = exit WIPEOUT immediately without wiping the current file.
  138.         ESC = same as Q
  139.       ENTER = causes WIPEOUT.EXE to attempt to shell to a program named
  140.             "LIST" and passes the currently hilited file name to this
  141.             program as a command line parameter.  This is intended to
  142.             allow you to examine the contents of a file BEFORE you wipe
  143.             it out, but it works ONLY if you have a program named
  144.             "LIST.COM", "LIST.BAT", or "LIST.EXE" readily available on
  145.             your DOS PATH= ENVIRONment string.  WIPEOUT.EXE itself 
  146.             contains no code to enable file browsing.
  147.  
  148.  
  149.     [3] Press F3 to immediately wipe out all the matching files WITHOUT
  150.     ASKING FOR ANY FURTHER CONFIRMATION.
  151.  
  152.     [4] Press ESC to exit WIPEOUT.EXE and return to DOS without
  153.     processing any files.
  154.  
  155.  
  156.     Note that with F2 and F3, WIPEOUT.EXE provides a one-line status display
  157. of the progress it is making as the file is wiped.  If this list exceeds to
  158. the number of screen rows in the display area, it will scroll as needed.
  159.  
  160.                           WHAT DOES WIPEOUT.EXE DO?
  161.                           ------------------------
  162.  
  163.     When WIPEOUT.EXE processes a file, three separate things occur:
  164.  
  165.  
  166.     [1] Firstly, the entire file (every single byte) is overwritten with a
  167.     HEX 0 character (for you BASIC programmers, this is a CHR$(0) character).
  168.  
  169.  
  170.     [2] Next, the file is renamed to a new, randomly-generated file name.
  171.     (Note for techies - this does NOT require DOS 3.3;  the new file name is
  172.     generated from numerical values and the tilde character.  Then the new
  173.     name is checked against the existing contents of the directory to be sure
  174.     no file already exists with that name).
  175.  
  176.  
  177.     [3] Finally, the file is deleted using an equivalent to the DOS DEL
  178.     command.
  179.  
  180.  
  181.     The end result is an erased file which cannot be viewed (it's contents
  182. are all "0") and which cannot be identified by its pre-WIPEOUT file name.
  183. You *CAN* unerase this if you have a mind to (and if you have suitable
  184. file-unerasing utility) but you will get only a useless, unidentifiable
  185. directory entry and file full of zeros.  (Try it with an expendable file and
  186. see for yourself)
  187.  
  188.                               USING WIPEOUT.INI
  189.                               -----------------
  190.  
  191.     WIPEOUT.EXE allows you to specify certain files which will normally never
  192. be WIPEd OUT by placing the names of those files in a file named
  193. "WIPEOUT.INI".  See the included WIPEOUT.INI file for examples.
  194.  
  195.     Note that WIPEOUT.EXE always respects what you put into WIPEOUT.INI
  196. EXCEPT in 3 cases:
  197.  
  198. [1] WIPEOUT.INI is not located on the current DOS PATH= ENVIRONment parm
  199.     string (the current default directory is NOT the same thing!)
  200.  
  201.     NOTE:   WIPEOUT.EXE will examine up to the first 40 DOS PATHs in
  202.             your "PATH=" ENVIRONment string when attempting to locate
  203.             WIPEOUT.INI.  If more than 40 paths are found, you will be
  204.             given a warning and asked whether you want to continue,
  205.             since it is possible that WIPEOUT.INI may NOT BE FOUND).
  206.     NOTE:   If WIPEOUT.EXE finds NO DOS PATHs in the "PATH="
  207.             ENVIRONment string (or no DOS "PATH=" string at all), you 
  208.             will be warned that WIPEOUT.INI will NOT be used, and will 
  209.             be given the chance to exit.
  210.  
  211. [2] You have (for whatever reason) renamed WIPEOUT.INI to any other name;
  212.  
  213. [3] You have used the optional "/I" parameter on the WIPEOUT.EXE command line.
  214.  
  215.  
  216. NOTE:   -   Do NOT use DOS WILDCARD characters in the WIPEOUT.INI file.  Use
  217.         ONLY unique DOS file names.  And you should NOT enter any PATH
  218.         specifications with these file names - just the plain old name (file
  219.         name and extension, if any).
  220.  
  221.         -   You can edit this WIPEOUT.INI file with any text file editor (each
  222.         line in the WIPEOUT.INI file MUST end with a carriage return/line
  223.         feed - hex 0D0A for you techies out there).
  224.  
  225.         -   You can enter comments on each file name line if you wish
  226.         (see the examples in the sample WIPEOUT.INI file provided) ONLY
  227.         if you make certain that the comments start AFTER column 13.
  228.  
  229.         -   WIPEOUT.INI will handle up to 50 different file names.  If
  230.         more than 50 names are entered, you will be given a warning and
  231.         the chance to terminate WIPEOUT.EXE, since any file name(s)
  232.         beyond the 50th will NOT be protected.
  233.  
  234.         -   The WIPEOUT.INI should *NOT* be renamed (although you can rename
  235.         WIPEOUT.EXE, if you want) and *MUST* reside somewhere on the DOS PATH
  236.         as defined (most commonly) in your system's AUTOEXEC.BAT file.  (If
  237.         you want to know which DOS directories are currently on your DOS
  238.         PATH, type "PATH <enter>" at the DOS prompt).
  239.             Note that merely having WIPEOUT.INI in the current default DOS
  240.         path is NOT the same thing as being in the DOS PATH= ENVIRONment
  241.         parameter.
  242.  
  243.         - If the WIPEOUT.INI file cannot be found (or if it contains NO file
  244.         names), then the opening WIPEOUT.EXE screen will display the legend
  245.         "0 files in WIPEOUT.INI";  otherwise, this legend will tell you how
  246.         many different file names are being protected. (If you have used the
  247.         "/I" command line parm, then this legend will read "WIPEOUT.INI is
  248.         IGNORED".)
  249. =============================================================================
  250.                    END OF WIPEOUT.EXE V 1.2 DOCUMENTATION
  251. =============================================================================
  252.