home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / fcfs / !FCFS / !Help < prev    next >
Encoding:
Text File  |  1997-02-28  |  15.3 KB  |  389 lines
  1.                   ============================================
  2.                   FCFS (1.10)  -  FileCore Image Filing System
  3.                   (C) Nick Craig-Wood and Sergio Monesi 1995-7
  4.                   ============================================
  5.  
  6. FCFS allows you to create, read and restore images of FileCore discs.
  7.  
  8. This means that you can copy a whole floppy or hard disc image to your hard
  9. disc and then access it as if it were a directory via the FCFS image filing
  10. system.  A desktop front end for the multitasking creation and restoration
  11. of these disc images is provided.  This is very useful for back up purposes.
  12.  
  13. FCFS requires RISC OS 3.10 or later (it has been fully tested on Risc PC and
  14. StrongARM) and supports interactive help.
  15.  
  16. FCFS is SHAREWARE.  If you use it for more than 30 days you must register;
  17. see 'Conditions of use' for more info.
  18.  
  19.  
  20. Index
  21. -----
  22.  
  23. - Introduction
  24. - FCFS images
  25. - Making images
  26. - Restoring images
  27. - Multitasking operations
  28. - Using images
  29. - Disclaimer
  30. - Bugs and Limitations
  31. - History
  32. - Credits
  33. - Conditions of use
  34. - Contacting the Authors
  35.  
  36.  
  37. Introduction
  38. ------------
  39.  
  40. Why would anyone want to copy a FileCore disc into an image file?  Well FCFS
  41. was conceived to do this for 2 main reasons.
  42.  
  43. Firstly when backing up a hard disc onto another hard disc, we noticed that
  44. FileCore took about 10 times longer to copy the contents of the disc as it
  45. did to read and write all the sectors at a low level.  This is because
  46. FileCore is creating files and directories, altering the directory images
  47. and generally having to do a lot of work.  FCFS allows you to copy an entire
  48. disc (floppy or hard) to a file, sector by sector, very quickly.
  49.  
  50. The second use of FCFS is to write these files back to a disc.  This might
  51. be used by the maintainer of a PD library, who keeps a lot of floppy disc
  52. images on hard disc, and when he wants to write them to floppy he just uses
  53. FCFS to do so.  This again is much quicker than copying the files directly.
  54.  
  55. We created an image filing to read the files out of these images (as if they
  56. were still attached as a disc drive).  The image filing system is read only
  57. for the time being though.
  58.  
  59. FCFS is used every day by one of the authors for backing up his 420 Mb disc
  60. onto an external SCSI disc.  This chore which used to take nearly an hour,
  61. is all over in 8 minutes!  The created image is then readable with the image
  62. filing system.
  63.  
  64.  
  65. FCFS images
  66. -----------
  67.  
  68. FCFS images are files of type FCD or FileCore.  This file type hasn't been
  69. allocated for us by Acorn, but it was allocated for FileCore and so our use
  70. is probably OK.  If you know otherwise then let us know!
  71.  
  72. FCFS images come in three types, standard, compacted and compressed.
  73.  
  74. The standard image has _all_ the sectors on the disc, used and unused, and
  75. if the FCFS image filing system ever becomes write as well as read then it
  76. will only be able to write to this type of disc.
  77.  
  78. The compacted image has had all the unused sectors removed from it, making
  79. it smaller.
  80.  
  81. The compressed image has had all the unused sectors removed from it and the
  82. remaining sectors compressed using a very fast compression routine.
  83.  
  84. For example, if you had a disc with (from Free space display)
  85.  
  86.     Free: 125 Mb
  87.     Used: 280 Mb
  88.     Size: 406 Mb
  89.  
  90. An un-compressed image would be 406 Mb in size, a compacted image would be
  91. 280 Mb in size and a compressed image would be smaller still, typically
  92. about 170 Mb but this varies with exactly what you have on the disc.
  93.  
  94.  
  95. Making images
  96. -------------
  97.  
  98. Clicking with Select on the iconbar icon will open the 'Make Image' window.
  99. To create a new FCFS image from a disc you need to select the source disc
  100. (using the pop-up menu), choose the Image type, the filename and drag the
  101. icon to a filer window.
  102.  
  103. If you choose a compressed image type then you may drag the slider from fast
  104. to slow.  Fast is speedy but gives worse compression than Slow.  The default
  105. setting is probably about right for most people.
  106.  
  107. You may adjust how FCFS multitasks with the Options box - see the
  108. Multitasking operations section.
  109.  
  110. FCFS will copy the disc sectors (only the used ones) to the image file 
  111. compressing if you asked for a compressed image and when the copying is
  112. finished the image is ready to be opened.
  113.  
  114. This is the only way to create FCFS images: there are floppy copy programs
  115. that can save the disc image to a file but FCFS can't access them (even if
  116. they are filetyped correctly) since they don't include some data that is
  117. essential for FCFS.  (It may be possible to write a converter though, ask
  118. the Authors!)
  119.  
  120. FCFS may tell you "the source disc map is corrupted".  In this case it will
  121. be impossible to create a valid image file.  Be warned - map errors may lead
  122. to data loss.  To fix this you will need a disc rescue package such as FSCK
  123. (written by Sergio Monesi and available from all good Acorn software
  124. archives).
  125.  
  126.  
  127. Restoring images
  128. ----------------
  129.  
  130. Once you have created an image, you can read the files from it just using
  131. the filer (ie drag the files from the image to the disc).
  132.  
  133. This is a rather slow process (especially on floppies), so if you want to
  134. restore all the files you can use the 'Restore Image' window (opened by
  135. clicking Adjust on the iconbar FCFS icon).
  136.  
  137. To use this, just drag an FCFS image to this window (its details will be
  138. shown), choose the destination disc using the pop-up menu and click on
  139. Restore.
  140.  
  141. You may adjust how FCFS multitasks with the Options box - see the
  142. Multitasking operations section.
  143.  
  144. FCFS will copy the image content (only the used 'sectors') decompressing if
  145. necessary to the destination disc and when the copying is finished the disc
  146. will be an exact copy of the disc that the image was generated from.
  147.  
  148. Be *careful* when you use this feature, since it will completely remove the
  149. content of the destination disc and will replace it with the content of the
  150. FCFS image.  If the destination disc is not empty, FCFS will prompt you for
  151. confirmation before performing this operation.
  152.  
  153. FCFS can restore an image only to a disc whose 'shape' is the same as disc
  154. which the image was generated from. In other words, you can't restore an
  155. image of a 40Mb hard disc to a 100Mb hard disc, nor you can restore a 800Kb
  156. floppy image to a 1.6Mb floppy or vice versa.
  157.  
  158. However, you can restore a 800Kb floppy image to a 800Kb RAM disc since
  159. their shape is similar (FCFS will tell you that the shape is different, but
  160. you can click on 'Continue' and restore it anyway), but you can't restore a
  161. 1.6Mb floppy image to a 1.6Mb RAM disc because of RAM disc limitations (it
  162. doesn't support the bootblock).
  163.  
  164.  
  165. Multitasking operations
  166. -----------------------
  167.  
  168. In both the Make and Restore window you can find a Multitask button.  If it
  169. is selected, the making or restoring of the FCFS image will be performed in
  170. a multitasking fashion, so you can get on with something else at the same
  171. time.
  172.  
  173. You can use the timeslice icon to change the time (in centi-seconds) that
  174. FCFS will use to read/write to the disc/image before it gives the control
  175. back to the other tasks (ie high value means faster image making/restoring
  176. but slow desktop operations).  Values between 5 and 25 are recommended.
  177.  
  178. While the image is being made or restored a window will appear which shows
  179. the progress so far and allows the options of pausing and aborting the
  180. operation.  When the operation has finished this window will display
  181. statistics about transfer rates, compression ratios etc.
  182.  
  183. If you selected a non-multitasking operation then Escape will abort it.
  184.  
  185. Before creating an image, if the Multitask option is set, FCFS will try to
  186. lock the disc to avoid changes being made to it during the copying process.
  187. If there are files open for writing, FCFS can't lock the disc and will ask
  188. you if you want to continue or abort the operation.  If you choose to
  189. continue, remember that you should avoid writing to or modifying the disc in
  190. any way, otherwise the image will probably be corrupted. If the locking
  191. operation succeeds you can read the disc as usual but you can't create,
  192. delete or modify any files.  The disc will be unlocked when FCFS has
  193. finished.
  194.  
  195.  
  196. Using images
  197. ------------
  198.  
  199. Once you have created an image then you can use this image exactly as if it
  200. were the original disc, the only limitation being that it will be read only.
  201.  
  202. The FCFS image file icon is suggestive of a directory icon.  This is
  203. deliberate since the image file has the attributes both of a directory and a
  204. file.  You may copy the file about just like a normal file, however you may
  205. double click on it to open it like a directory.  It works in exactly the
  206. same way as DOSFS, ArcFS or SparkFS.
  207.  
  208. If you drag an image file to the FCFS iconbar icon an information window
  209. will open which shows the type of the image, the size of the disc it was
  210. made from, the size of the image itself and the compression ratio if
  211. applicable.  You may also click on the open icon to open a filer window onto
  212. the image.
  213.  
  214. FCFS has two quit options leading off "Quit" on the iconbar menu.  "Filer
  215. only" and "Filer and FS".  The first quits just the desktop front end - you
  216. will still be able to use the FCFS image files.  The second quits the image
  217. filing system also and after that you will not be able to use the FCFS image
  218. files without reloading FCFS.  Clicking on the main "Quit" option is
  219. equivalent to "Filer only".
  220.  
  221.  
  222. Disclaimer
  223. ----------
  224.  
  225. In normal operations FCFS is not a dangerous program since it doesn't write
  226. anything to the disc.  However, when restoring an image, it completely
  227. removes the destination disc's contents, so if you use it on the wrong disc
  228. by accident, you will be sorry!
  229.  
  230. If for any reason (either your mistake or a bug in FCFS) it causes you a
  231. loss of data, we are sorry for you but WE WILL NOT BE HELD RESPONSIBLE.
  232.  
  233. Use FCFS at your own risk.
  234.  
  235.  
  236. Bugs and Limitations
  237. --------------------
  238.  
  239. FCFS can only read from image files, not write to them.  If the demand is
  240. there then we may consider adding this.
  241.  
  242.  
  243. History
  244. -------
  245.  
  246. 0.00 -- 24Mar94
  247. * The first version of the FCFS filing system:  itself a FileCore filing
  248.   system.  However a huge problem appeared: FileCore isn't re-entrant!  So it
  249.   would work over a network quite happily but not on a local FileCore disc.
  250.  
  251. 1.00 -- 20Sep95
  252. * First fully working version, with an image filing system (with its own
  253.   code to read from FileCore disc images), image creation and restoration.
  254.  
  255. 1.01 -- 26Sep95
  256. * Fixed a bug that prevented some files (especially fragmented ones) from
  257.   being correctly read from an image.
  258. * Now works with new FSes running with old FileCore.
  259.  
  260. 1.02 -- 23Feb96
  261. * Fixed problems with hidden files when used together with FilerPatch.
  262. * Objects that shared sectors with the root directory are now correctly read
  263.   from images.
  264. * Added support for compressed images. (The old 'compressed' images are now
  265.   known as compacted images.)
  266. * Fixed problems with RISCiX or RiscBSD partitioned hard discs (the partition
  267.   is no longer copied to the image).
  268.  
  269. 1.10 -- 28Feb97
  270. * Multitasking while compressing an image tidied up
  271. * Fixed a few typos in program text and redid manual
  272. * Fixed adjust clicking on MakeImage radios
  273. * Added images information window
  274. * You can now drop an untyped FCFS image onto the iconbar icon
  275. * Added a check for non sector aligned objects
  276.  
  277.  
  278. Credits
  279. -------
  280.  
  281. We'd like to thank the following people who contributed in some way to the
  282. development of FCFS:
  283. - Martin J Ebourne for his memory allocation functions, used in the desktop
  284.   frontend and his module code.
  285. - Jason Williams (and all the other collaborators) for DeskLib.
  286. - Dave Lawrence, Mike Brown and George Foot for being diligent beta testers.
  287.  
  288.  
  289. Conditions of use
  290. -----------------
  291.  
  292. FCFS (The Software) is Copyright (C) Nick Craig-Wood and Sergio Monesi 1995
  293. (the Authors) and may not be used or copied except as in accord with the
  294. terms and conditions below.
  295.  
  296. You may NOT Make the Software available to any third party EXCEPT with these
  297. terms and conditions imposed on said party.
  298.  
  299. You MUST make sure the Software is distributed whole, intact and unmodified,
  300. including all the files in the original distribution.
  301.  
  302. If you use the Software for more than 30 days then you MUST register the
  303. Software (see below).  You may NOT copy (except for personal use) the
  304. Software if it has been registered, and you may NOT give to any third party
  305. any registration keys you have been issued with.
  306.  
  307. You may NOT sell, hire or include the Software in a package which is sold or
  308. hired, modify, translate, disassemble, decompile, reverse engineer, or create
  309. derivative works based upon the Software or include whole or part of the
  310. Software into other works.  
  311.  
  312. The Software is supplied "as is", the Authors make no warranty, express or
  313. implied, as to the merchantability or its fitness for any particular
  314. purpose.   It may or may not perform in accordance with the documentation or
  315. your expectations.
  316.  
  317. In no circumstances will the Authors be liable for any damage, loss of data,
  318. profits, goodwill or for any indirect or consequential loss arising out of
  319. the use of the Software, or inability to use the Software, even if the
  320. Authors have been advised of the possibility of such loss.
  321.  
  322. These conditions supersede any prior agreement, oral or written, between you
  323. and the Authors relating to the Software.
  324.  
  325. You agree that except for written separate agreements between the Authors
  326. and you, this agreement is a complete and exclusive statement of the rights
  327. and liabilities of the parties.
  328.  
  329. You acknowledge that you have read this agreement, that you understand this
  330. agreement, and by loading, running or copying the Software you agree to be
  331. bound by this agreement's terms and conditions.
  332.  
  333.  
  334. Registering the Software:
  335.  
  336. To register you simply have to send one of the Authors a registration fee
  337. (in the form of bank notes or sterling cheques drawn on a UK bank) of not
  338. less than 10 pounds, 30.000 lire, 35 marks, 20 US dollars, 100 francs,
  339. 50 Nlg or equivalent.  If you want you can include a disc and, say, 2 pounds
  340. for mail costs, and you will be sent the latest version of the Software
  341. along with some other PD programs.
  342.  
  343. In return you will be given a registration key.  This is a number of 10
  344. digits or less and can be used to register the Software.
  345.  
  346. To register your Software select the register option from the main menu,
  347. type in your name as you specified it to us in the box that appears (Case,
  348. punctuation and spaces are important) and your registration number.  Press
  349. the Save button. This will register the software in your name.
  350.  
  351. This has two functions
  352.  
  353.   1) It removes the start up message
  354.   2) It burns your name into the program info box, so we will know if you
  355.      give away a registered copy of the program.
  356.  
  357. If you want to unregister the program (before you give it to a friend maybe)
  358. then make sure the registration key field is clear and press Save.
  359.  
  360. Registration keys will unlock future versions of the Software unless the
  361. Authors decide otherwise.
  362.  
  363.  
  364. Contacting the Authors
  365. ----------------------
  366.  
  367. Post:  Nick Craig-Wood              Sergio Monesi
  368.        26 Wodeland Avenue           Via Trento e Trieste 30
  369.        Guildford                    20046 Biassono (MI)
  370.        Surrey GU2 5JZ               Italy
  371.        UK
  372.  
  373. EMail: ncw@axis.demon.co.uk         msergio@mbox.vol.it
  374.        nick@craig-wood.com          pel0015@cdc8g5.cdc.polimi.it
  375.                                     sergio@freebsd.first.gmd.de
  376.  
  377. WWW:   http://www.axis.demon.co.uk  http://cdc8g5.cdc.polimi.it/~pel0015/
  378.  
  379.  
  380. If you want to send e-mail to the development team then do so at
  381.  
  382.        fcfs@axis.demon.co.uk
  383.  
  384. Also see the FCFS home page at
  385.  
  386.        http://www.axis.demon.co.uk/fcfs/
  387. and
  388.        http://cdc8g5.cdc.polimi.it/~pel0015/fcfs.html
  389.