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 / ENTERPRS / CPM / UTILS / S / XLINK10.LBR / XLINK.DZC / XLINK.DOC
Text File  |  2000-06-30  |  4KB  |  109 lines
  1. XLINK -   Displays filename and cluster number for cross-linked 
  2.           files.
  3.  
  4.  
  5.  
  6. IN THIS COLLECTION
  7.  
  8. XLINK.DOC      This documentation file.
  9. XLINK.COM      A ready-to-run assembled version.
  10. XLINK.180      Assembler source, written for SLR Systems SLR180+.
  11.  
  12.  
  13. OPERATION
  14.  
  15.      Reasonably simple, just issue the command XLINK and answer 
  16. the two questions the programs asks.
  17.  
  18.      First, you need to specify a drive to hold a temporary file.  
  19. The program will give you an estimate of how much space this file 
  20. will need.  The estimate is based on a worst-case situation, so 
  21. if you don't have a drive with quite than much space available, 
  22. you may be able to use it anyway.
  23.  
  24.      Second, you are asked if you want the list of crosslinked 
  25. files (if any) sent to your printer.
  26.  
  27.      The program will then go through the directory of the disk 
  28. under test and display each cluster number as it is found.  This 
  29. mainly just indicates the program is running, if you would like 
  30. to turn off this display, patch the byte at 0104H to 0FFH.
  31.  
  32.  
  33. WHAT IS A CROSSLINK?
  34.  
  35.      The space on a disk is divided up into areas known as 
  36. 'clusters' (or sometimes 'blocks').  Even if only one byte is 
  37. written to a file, the file will occupy a certain minimum of 
  38. space - for a 'standard' 8-inch disk, the area is 1Kbyte.  For 
  39. disks capable of storing more than 256K the minimum size is 2K, 
  40. and can range up to a maximum of 16K.  Each of these areas is 
  41. given an address or cluster-number.  The first few clusters get 
  42. reserved for the directory, and the rest are used for files.
  43.  
  44.      If you look at a typical directory entry, you will find the 
  45. first 16 bytes used for user area, filename, extension, extent 
  46. number, a couple of mystery bytes, and record count.  The next 16 
  47. bytes are the cluster numbers 'claimed' by that directory entry.
  48.  
  49.      Sometimes, more than one file will 'claim' the same cluster, 
  50. when this happens, you have a cross-link.  If you write to a file 
  51. that is cross-linked you may change the contents of some other 
  52. file on that disk (possibly in some other user area).
  53.  
  54.      What this program does, is to create a map of all of the 
  55. cluster numbers in use on a particular disk, and match them up 
  56. with the files that claim them.  If more than one file claims a 
  57. particular cluster, the names of the two conflicting files is 
  58. displayed.  You will find one of the files appears to be fine, 
  59. and the other one is damaged.
  60.  
  61.      About the only remedy for the situation is to make a copy of 
  62. the 'good' file, make a copy of the corrupted file, and erase the 
  63. originals.  You can then try to salvage what you can of the 
  64. corrupted file without risk to the good file.
  65.  
  66.  
  67. OPERATING SYSTEM NOTES
  68.  
  69.      This program was written to deal with a problem I had on a 
  70. TurboDOS system, but has been tested and works fine on a ZRDOS 
  71. computer.  It should work fine under vanilla CP/M, I haven't used 
  72. any special TurboDOS system calls.  Un-enhanced CP/M systems are 
  73. getting hard to find!
  74.  
  75.      The program makes use of SYSLIB (version-4) subroutines, 
  76. because of that, and the instructions I used for my own code, the 
  77. program will run -only- on Z-80 processors or their successors.
  78.  
  79.  
  80. THE USUAL DISCLAIMERS AND STUFF
  81.  
  82.      This program should be fairly safe, the only disk-writes are 
  83. to the temporary file, all references to the directory of the 
  84. disk being tested are reads - and those are standard 'Search for 
  85. File' BDOS calls.
  86.  
  87.      However, (there is always an 'however') in the event your 
  88. directory gets trashed, your system fails, or your cat turns 
  89. lime-green --- I will not be held liable.
  90.  
  91.      This program is released for public distribution and 
  92. modification in the hope that others may benefit from it and 
  93. improve upon it.
  94.  
  95.      I would like to thank the authors of SYSLIB - without their 
  96. routines, this would have been much more work.
  97.  
  98.  
  99.  
  100.      Tony Newman
  101.  
  102.  
  103. Genie address: T.NEWMAN2
  104.  
  105.           BBS: The Machine
  106.                (503) 747-8758
  107.                24Hr.
  108.                300, 1200, 2400 bps
  109.