home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / discutils / backup / tapefs / !TapeFS / !Help < prev    next >
Encoding:
Text File  |  1991-09-01  |  7.1 KB  |  182 lines
  1. TapeFS 1.09
  2. ===========
  3.  
  4. This is a filing system designed to drive a scsi Sequential access device - e.g.
  5. a cartridge tape drive. It has only been tested with the Acorn scsi interface,
  6. but I'm told that the Oak one is supposed to be compatible so this may work too.
  7. I'm not distributing source generally at the moment, but will look favorably on
  8. requests if you are having problems.
  9.  
  10. This provides only the ability to get data onto and off the tape. It does
  11. not of itself give any means of backing up a disc. I have been successful in
  12. using archimedes tar in conjunction with it, and have exchanged data with
  13. other systems using DC600 tapes.
  14.  
  15.  
  16. Brief notes about TapeFS
  17.  
  18. Please note that this software must be regarded as alpha test only, in that
  19. there is no checking on any of the configuration parameters, and silly values
  20. will almost certainly achieve silly results. A real product should probably
  21. not have so much config visible.
  22.  
  23. TapeFS provides several commands, and one pseudo file, "tape:", that may be
  24. read or written. It only supports sequential access, but does allow multiple
  25. files to be stored after one another on a tape, separating them with
  26. filemarks. Your tape drive may restrict further precisely what is allowed.
  27.  
  28. If it hasn't yet found or been told a drive number, TapeFS searches for a
  29. drive by looking for scsi devices that claim to be sequential access. When
  30. tape: is opened, it allocates a buffer from the RMA, and sends a MODE SELECT
  31. command to the drive to select fixed size 512 byte blocks, and the speed and
  32. density set in tapefs, which both default to 0, which should set the default
  33. or autoconfig values on the drive. During writing, if the early warning end
  34. of medium bit is set, and it still has a record of any sectors that the
  35. drive says didn't make it to tape, it prompts for a new tape to be inserted,
  36. otherwise returns an error. When tape: is closed, a filemark is written,
  37. which is taken as end of file when reading so multiple files can be saved
  38. one after another. If blank tape or end of medium is encountered while
  39. reading, you are prompted for another tape, but may press escape.
  40.  
  41. Use with tar
  42.  
  43. A typical command sequence might be
  44.         DIR :4.$
  45.         DIR :4.$
  46.         tar cvf tape: *
  47. to back up the whole of drive 4. The repeated *DIR is to avoid a bug in tar
  48. caused by the previous and current directories being on different drives.
  49. Note that it is not sensible to specifiy a large buffer for tar, as tapefs
  50. uses its own internal buffer, with size set by *tapebuffer. To improve
  51. streaming, increase this, though it must be possible to make space for it in
  52. the RMA.
  53.  
  54. TapeFS will not work with tar when tar tries to find out how much space
  55. there is by creating a file to fill it - it will just go on forever. Later
  56. tar versions will only do this if you specify multiple volume backups, which
  57. is not needed at all as TapeFS has its own scheme.
  58.  
  59. Commands
  60.  
  61. These are mostly explained by *help. Some drives may not support all of them.
  62. To find out what the speed and density settings mean to your drive, consult
  63. its documentation.
  64.  
  65.  
  66. Restrictions:
  67.  
  68. 512 byte blocks
  69. Fixed block mode
  70. Timeout on EOM prompt is 497 days - will assume cancelled after then!!
  71.  
  72. Hints:
  73.  
  74. If tape: refuses to open, try using *tapeerror to find out why.
  75. Streaming will work much better with large files than small ones.
  76.  
  77. Notes about ST/60
  78.  
  79. The controller seems quite good - it disconnects and has enough buffer that
  80. the tape will quite happily stream reasonably if you are archiving medium to
  81. large files. Rewind commands ignore the immediate bit in the command block
  82. and don't return a result until complete. tapefs allows you to continue
  83. using your arc while this occurs, but will stall any further command.
  84. *tapeerror may be used to inspect the command result when it arrives, and
  85. may also come in handy with programs that don't pass errors through to the
  86. user. (tar) It seems necessary to use *wind before being able to append to
  87. the end of a tape. Just reading to the end isn't enough.
  88.  
  89. Notes about Viper tape drives
  90.  
  91. These appear to provoke a bug in SCSIDriver 1.01, (not in 1.05) when
  92. disconnect is enabled - they cause scsidriver to crash with address errors.
  93. I have been able to make scsidriver crash before while developing an amiga
  94. scsi target implementation. So the tapedisconnect command is provided to
  95. disable it for the tape drive, but this will unfortunately restrict the
  96. discs use of the bus while the tape is writing. Tapefs defaults to writing a
  97. maximum of 4K at one time, but a Viper seems to stutter sometimes while
  98. writing, so I allow this limit to be increased by the maxtransfer command.
  99. If disconnect is off, this will further reduce disc access to the bus,
  100. however.
  101.  
  102. Version 1.00
  103.  
  104. * Automatically finds a direct access (tape) scsi device to use when it is
  105. loaded. If you have more than one, you can select which device to use by the
  106. *tapedevice command
  107.  
  108. * uses readahead and writebehind within a circular buffer. This defaults to
  109. 64K, and is claimed from the RMA when the tape: device is opened. use the
  110. *tapebuffer command to change the amount - too large will mean tape: refuses 
  111. to open. Note a large buffer will not really be of benefit if your tape is
  112. faster than your disc, since then it only acts to even out flucuations, when
  113. the tape has to stop to wait, and the disc doesn't get far ahead. :-(
  114.  
  115. * supports byte by byte access - *spool/ *dump etc.
  116.  
  117. * supports multiple files on one tape.
  118.  
  119. * now backgrounds during the operation of rewind, etc, so you can continue
  120. using system even if your tape drive doesn't support the immediate bit.
  121. (ST/60s don't) It will wait for the first command to complete if you start a
  122. second, though. Use *tapeerror to check result of the command if you want.
  123.  
  124. Version 1.05
  125.  
  126. * Now makes use of whole buffer with slow tape drives to lengthen runs.
  127.  
  128. Version 1.06
  129.  
  130. * Moved check/search for a device to when actually opened
  131. * Does a MODE SELECT to set block size because I suspect this may fix clever drives
  132.  
  133. Version 1.07
  134.  
  135. * Now prompts for a new tape at EOM, to give multi-tape archives.
  136. * Put check/search at open as well so can rewind before opening
  137. * Shrinks RMA when file is close and leaves space before
  138.   large buffer as suggested by Owen.
  139. * Added speed/density commands.
  140. * Added tapedisconnect command for viper support.
  141.  
  142. Version 1.08
  143.  
  144. * added maxtransfer
  145.  
  146. Version 1.09
  147.  
  148. * errors make it out of open (generic fs change)
  149. * Changed to return result from find for atar support
  150.  
  151. Distribution:
  152.  
  153. This software may be freely redistributed, so long as only a reasonable
  154. copying or media charge is made, and all files I distribute are included. I
  155. retain copyright to the code. Commercial (including magazine) distribution,
  156. or distributing modified versions of this please contact me - I am normally
  157. happy for it to be reused in other free software, but like to avoid deviant
  158. versions of mine causing trouble.
  159.  
  160. I am not asking for money, but if you like and use it I would be surprised
  161. and amazed by any contributions, and you will receive a disc with latest
  162. versions on. (>£2, say)
  163.  
  164. Me:
  165.  
  166. Brian.Brunswick@cl.cam.ac.uk
  167. +44 0223 334419
  168.  
  169. Brian Brunswick
  170. Trinity College
  171. Cambridge
  172. CB2 1TQ
  173. UK
  174.  
  175. Brian Brunswick
  176. Fairview
  177. Avenue des Hirondelles
  178. Pool-in-WharfeDale
  179. Leeds
  180. LS21 1EY
  181. UK
  182.