home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / kill2.zip / read.me < prev   
Text File  |  1993-06-17  |  4KB  |  92 lines
  1. KILL2 is a file maintenance utility that can be used, for example, to
  2. get rid of old files from BBS download directories.  Type KILL2 with no
  3. arguments (or KILL2 -?) to get help.  It's simple to use, and I've tried
  4. to make it relatively safe (a command line switch is required to cause
  5. file deletion to occur; otherwise KILL2 will only list the files it
  6. would have deleted).  KILL2 runs under both OS/2 and MS-DOS.
  7.  
  8.  
  9. The basic format of a KILL2 command line is:
  10.   KILL2 -<switches> <file>
  11.  
  12. There may be many -<switches> and many <files> given.  Anything not a
  13. -<switch> (i.e. not prefaced by a hyphen) is considered a <file>.  If
  14. any invalid switches are encountered, KILL2 stops.  Killing files is
  15. serious business, and KILL2 won't proceed if it thinks you've goofed.
  16.  
  17. A <file> argument is the name of a file.  It may contain wildcards and
  18. paths.  "C:\STUFF\*.*", "*", "?C?D?S?A.*" and "AFILEN.AME" are all valid
  19. <file> arguments.  A <file> can begin with the '@' character to indicate
  20. that it is a file containing a list of files.  If you need to use a file
  21. that actually begins with '@', double it:  @@AFILEN.AME results in the
  22. filespec @AFILEN.AME being used.
  23.  
  24. A switch begins with the hyphen character and is followed by a letter.
  25. The following switches are valid:
  26.  
  27. A  Must be followed immediately by a <number>.  This <number> is used to
  28.    affect all but the <number> of newest files.  For instance,
  29.    KILL2 -A1 *.* kills all but the newest file in the default directory.
  30.    KILL2 -A2 \NODELIST\NODEDIFF.* kills all but the two newest files
  31.    matching the pattern NODEDIFF.* in the directory \NODELIST on the
  32.    default drive.  It's probably not useful to use the -R and -D
  33.    switches with the -A switch.  Warning:  arbitrarily chooses files if
  34.    several files with the same date exist at the "border."  In other
  35.    words, if there are three files with the same date and two must be
  36.    deleted to pare the directory to the correct number, KILL2 will
  37.    usually whack them off in directory order.  The usual use of -A is to
  38.    kill all but one or two newest matching files; perhaps nodelists or
  39.    newsletters.
  40.  
  41. D  Days of age to kill files at.  -D30 kills files older than 30 days.
  42.    The default is 0, meaning all files are fair game.
  43.  
  44. E  Prefaces an excluded file pattern.  Wildcards are allowed.  Paths
  45.    won't work as you might expect; don't use them.  You can give many -E
  46.    arguments.  -E*.DAT would exclude all files matching *.DAT, for
  47.    example.  Exclude file patterns may also use @list files.
  48.  
  49. K  Kill files.  If this switch isn't present, KILL2 will only list
  50.    files.  This lets you test a command line to see what the results
  51.    would be before actually deleting files.
  52.  
  53. L  List only.  This is the default action.  Lists can be redirected to a
  54.    file on the command line.  This can be useful for creating bulletins
  55.    showing which files will be deleted ahead of time.  It's also useful
  56.    for verifying the action of a command line before actually deleting
  57.    files.
  58.  
  59. R  Recurse.  KILL2 will recurse into subdirectories working on files.
  60.  
  61. T  Touch.  KILL2 will touch files instead of deleting them.  "Touching"
  62.    means setting their time stamp to the current date.
  63.  
  64. -  Since the hyphen is a legal filename character under MS-DOS and OS/2,
  65.    use a second hyphen to preface filenames beginning with a hyphen.
  66.    --AFILEN.AME would produce the filespec -AFILEN.AME.
  67.  
  68. ?  Gets you brief help on KILL2.  Nothing else is done.
  69.  
  70.  
  71. KILL2 is copyright (c) 1992 by Mark Kimes, who can be reached at the
  72. address at the end of this file.  KILL2 is free for use in
  73. non-commercial environments (i.e. non-business, non-government,
  74. non-religious).  Commercial users must pay $10.00 US.
  75.  
  76. There is no (nil, none, nada) warranty whatsoever for KILL2.  If it eats
  77. your hard drive (no, it shouldn't do that), tough luck.  If it breaks,
  78. you got both pieces.
  79.  
  80. Touching didn't work under MSDOS (boo hoo :-). I've got an old FDEL.LZH
  81. lying around, a QuickBASIC program I wrote years ago that does much of
  82. what KILL2 does, if you need it.  But I hacked KILL2's source a bit and
  83. think I have it working now (thanks to Dan Updike for pointing it out).
  84.  
  85.  
  86.  
  87. Mark Kimes
  88. 1:380/16.0@Fidonet
  89. 542 Merrick
  90. Shreveport, LA  USA  71104
  91. (318)222-3455 data
  92.