home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / UTILS / DIRUTL / SRTDIR31.LBR / SRTDIR31.DQC / SRTDIR31.DOC
Text File  |  2000-06-30  |  5KB  |  98 lines
  1.                             SRTDIR31
  2.                 Alpha One Micro-Consulting, Ltd.
  3.  
  4. Modified by:   Don A. Williams  November 24,1984
  5.                Arizona Kaypro Users' Group (AKUG)
  6.  
  7.  
  8.  
  9. SRTDIR  was  originally SORTDIR included in the NEWARC.LBR  file.  
  10. It  appears to be another program by Dave Rand although his  name 
  11. does not appear anywhere in the program.  The only identification 
  12. in the program is the "Alpha One Micro-Consulting,  Ltd." byline.  
  13. The program,  like all of those in NEWARC.LBR, does not appear to 
  14. be  copyrighted  since  there is no copyright  statement  in  the 
  15. object  code.   The  name  was changed to  SRTDIR  to  allow  for 
  16. inclusion of a version and release code;  the original version in 
  17. NEWARC was Version 3.0 so I called this minor revision 3.1.
  18.  
  19. SRTDIR is a functional replacement for SAP and performs the  same 
  20. basic functions; i.e. it sorts a directory in to alphabetic order 
  21. and writes it back out to the disk.   This sorting not only makes 
  22. the  directory  easier to handle with facilities such as  DU  and 
  23. DIR,  but,  since  it collects all of the extents of large  files 
  24. into a contiguous area in the directory,  makes handling of these 
  25. larger files by almost any facility considerably faster.
  26.  
  27. SRTDIR  also provides some useful statistics on disk  utilization 
  28. that I like.
  29.  
  30. The  original  SORTDIR required specification of the disk  to  be 
  31. processed and did nothing more than sort the directory.  SRTDIR31 
  32. will  process the current disk if none is specified and  provides 
  33. the  option  of eliminating erased files from the  directory  for 
  34. security.  I frequently make copies of disks for other people and 
  35. these   copies  might  contain  erased  versions  of  proprietary 
  36. programs or other programs that I do not want to put into general 
  37. circulation.   Purging  the  directory entries for  erased  files 
  38. (filling the entry with E5Hs) makes recovery of these erased file 
  39. difficult for even the most persistent 'hacker'.
  40.  
  41. Use  of SRTDIR is simple.   If you wish to sort the directory  of 
  42. the current disk:
  43.  
  44.      A>SRTDIR
  45.  
  46. will  do the job ('A>' stands for CP/M's normal  prompt  and,  in 
  47. this example, indicates that disk A is the current disk.)
  48.  
  49. If  you  wish to sort the directory of some disk other  than  the 
  50. current  disk,  simply indicate the disk that you wish to sort on 
  51. the SRTDIR command line in the usual CP/M fashion as follows:
  52.  
  53.      A>SRTDIR B:
  54.  
  55. This example would sort the directory of the disk on drive B even 
  56. though  the current disk is A.   SRTDIR will NOT reset  the  disk 
  57. drives  so be sure to do a Control-C before using it if you  have 
  58. changed  disks.   It does return to CP/M with a Warm Boot so that 
  59. the disks will not be Read Only when it is through.
  60.  
  61. The distributed version of SRTDIR3.1 is set to purge erased files 
  62. by  default.   This  operation can be modified in either  of  two 
  63. ways.   At  location 103H in SRTDIR is a byte that  controls  the 
  64. action  to be taken for erased files.   If this byte is zero,  no 
  65. action will be taken; i.e. the files will remain in the directory 
  66. as erased.   If this byte is non-zero (usually 0FFH,) the entries 
  67. for  all  erased files will be purged (filled  with  0E5Hs.)   To 
  68. change the default action of SRTDIR, uses DDT, SID, ZSID, etc. to 
  69. change the contents of the byte at 103H.
  70.  
  71. To  override  the  default action of SRTDIR for  occasional  use, 
  72. SRTDIR provides a Command Line option as follows:
  73.  
  74.      A>SRTDIR B:$E
  75.  
  76. The  $E switch on the command line will REVERSE the operation  of 
  77. the default setting.  In the distributed version of SRTDIR31, the 
  78. previous  command will NOT purge the erased files.   If you  have 
  79. changed  the  byte  at 103H in SRTDIR to a zero  (default  to  no 
  80. purge,)  the previous command would cause the erased files to  be 
  81. purged.
  82.  
  83. Since Dave Rand did not release the source for SORTDIR,  I do not 
  84. feel that I can release the source for SRTDIR.  However, since it 
  85. is  a small,  clean program,  it can be disassembled using any of 
  86. the Christensen disassemblers (RESOURCE, ZSOURCE, ZDASM, etc.) in 
  87. relatively  short time.   My source for SRTDIR was obtained  this 
  88. way using a very old version of RESOURCE.
  89.  
  90. Possible  future  revisions  of this  program  would  include  an 
  91. optional  facility to purge zero length files (with the  optional 
  92. exception of those beginning with a '-';  the usual indication of 
  93. a volume label for the cataloging systems.)
  94.  
  95.  
  96. Don A. Williams
  97. Arizona Kaypro Users' Group (AKUG)
  98.