home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 274.lha / DiskHandler / filehand.doc < prev    next >
Encoding:
Text File  |  1989-07-25  |  6.5 KB  |  173 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *\
  2. * |_o_o|\\ Copyright © 1989 The Software Distillery.                      *
  3. * |. o.| ||        All Rights Reserved.                                   *
  4. * | .  | ||        Written by John Toebes, Dave Baker, John Mainwaring    *
  5. * | o  | ||        Jim Cooper, Bruce Drake, Doug Walker and Gordon Keener *
  6. * |  . |//         The Software Distillery                                *
  7. * ======           235 Trillingham Lane                                   *
  8. *                    Cary, NC 27513                                       *
  9. *                    BBS:(919)-471-6436                                   *
  10. *      BIX: JTOEBES, DWALKER                                              *
  11. *    PLINK: JTOEBES, DWALKER                                              *
  12. *   Usenet: ...mcnc!rti!sas!(toebes|walker)                               *
  13. *      CI$: sorry, charlie...                                             *
  14. \* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  15.  
  16. ------------------------------DISK HANDLER
  17. This contains a sample implementation of a file system that reads and writes
  18. 1.2 format diskettes.  At this point in time, the following issues are under
  19. investigation:
  20.  
  21. Existing bugs as of 15-May-89
  22. 1. There is no validator
  23. 2. Disks without a bitmap are not handled correctly
  24. 3. The system time is not set if it is currently unset
  25. 4. Some situations with no disk present or a popped disk still may crash the
  26.    handler.
  27.  
  28. ------------------------------COPYRIGHT NOTICE
  29.  
  30. DiskHandler is Copyright © 1989 The Software Distillery.
  31. Permission is granted to distribute programs and data in this distribution
  32. provided the following conditions are met:
  33.  
  34.    1.  All files present in the distribution package must be redistributed
  35.        with the package, including this documentation file.  If you 
  36.        distribute on diskette, all files must be on a single diskette.
  37.  
  38.    2.  The distributor may charge a fee to recover distribution costs.
  39.        The fee for diskette distribution should not be more than the cost 
  40.        to obtain the same diskette from Fred Fish or The Software Distillery,
  41.        whichever is greater.  Current charge from The Software Distillery
  42.        is $6 per disk, including all postage and handling charges.
  43.  
  44.    3.  The distributor agrees to cease distributing the programs and data
  45.        involved if requested to do so by authors or any member of The 
  46.        Software Distillery.
  47.  
  48. Permission is granted to use the enclose code in a file system for the Amiga
  49. provided that:
  50.   1) Credit is given to The Software Distillery for the original 
  51.      implementation
  52.           and
  53.   2) A sample of the modified software executable is made available to The
  54.      Software Distillery.
  55.  
  56. ------------------------------DISCLAIMER
  57.  
  58. Neither The Software Distillery nor any of its members will be liable for 
  59. any damage arising from the failure of this program to perform as described,
  60. or any destruction of other programs or data residing on a system 
  61. attempting to run the program.  While we expect no damaging errors, the 
  62. user of this program uses it at his or her own risk.
  63.  
  64. ------------------------------ACKNOWLEDGEMENTS
  65.  Written in Lattice C V5.02
  66.  Thanks to Steve Beats, Andy Finkel, Dan Baker, and Randel Jesup at Commodore
  67.    for enduring our incessant questions about file systems in general.
  68.  
  69.  
  70. ------------------------------INSTALLING
  71. Compile everything with LMK,
  72. Then create a mountlist entry like:
  73.  
  74. DSK1:      FileSystem = l:disk-handler
  75.            Device = trackdisk.device
  76.            Unit   = 1
  77.            Mount  = 1
  78.            Flags  = 0
  79.            Globvec = -1
  80.            Dostype = 0x444f5300
  81.            Surfaces  = 2
  82.            BlocksPerTrack = 1
  83.            Reserved = 2
  84.            Interleave = 0
  85.            LowCyl = 0  ;  HighCyl = 79
  86.            Buffers = 20
  87.            BufMemType = 3
  88.            Stacksize = 8000
  89.            Priority = 5
  90. #
  91.  
  92. Mount it and let it go.
  93.  
  94. If you want to kill it, you can send it an ACTION_DIE packet...
  95.  
  96. ------------------------------FILE LIST
  97.  
  98. The following files are part of this distribution.  Redistribution is
  99. permitted only if all the files are part of the redistribution (see above).
  100.  
  101. lmkfile.lmk
  102. filehand.doc
  103. handler.h
  104. bitmap.c
  105. buff.c
  106. databuff.c
  107. device.c
  108. dir.c
  109. disk.c
  110. diska.a
  111. dos1_2.c
  112. file.c
  113. io.c
  114. lock.c
  115. main.c
  116. mount.c
  117. process.c
  118. request.c
  119. sendpkt.c
  120. subs.c
  121. timer.c
  122. volume.c
  123.  
  124. +++++++++++++++++++++ Other Public Domain Software ++++++++++++++++++++++++
  125.  
  126.       Fred Fish
  127.       Amiga Library disks
  128.       1346 West 10th Place
  129.       Tempe, Arizona  85281
  130.       USA
  131.  
  132. Offers (now 210) disks of PD software for $6 each.  These are well organized
  133. and a MUST for any user group.
  134.  
  135.  
  136. ++++++++++++++++++++++ From the Software Distillery +++++++++++++++++++++++
  137. Other programs from the Software Distillery may be obtaining by calling our
  138. Bulletin board.  At present this consists of:
  139.  * C-Kermit (by Jack Rouse) - A telecommunications program that implements
  140.    the full Kermit protocol with many features such as remote commands and
  141.    batch file transfers.
  142.  * An advanced UN*X MAKE program with default rules and macro expansions
  143.  * POPCLI - a screen saver program and 'hot-key' extension for bringing up
  144.    a new cli at the touch of a key.  Current version is PopCLI IV.
  145.  * ICONEXEC - a program for making AmigaDOS programs run from workbench 
  146.    without any changes.
  147.  * SETALTERNATE a program for setting the alternate (selected) image on an 
  148.    icon to other than inverse.
  149.  * BLINK - an Amiga Linker that is FULLY ALINK compatible and up to 4 times
  150.    faster.  It supports many advanced linking features as well as an excellent
  151.    map facility.  A must for the serious programmer.
  152.  * TSIZE - a utility to list the amount of disk space taken up by the individual
  153.    directories on a disk
  154.  * WBRUN - A program for running workbench programs from CLI without having
  155.    to load workbench
  156.  * MEMWATCH - A background utility to watch for ramdom memory trashing
  157.  * HACK and HACK LITE - A UN*X dungeon game with customizable graphics
  158.  * LARN, another UN*X game ported to the Amiga by Edmund Burnette.
  159.          Similar to HACK but more strategy.
  160.  * PICKPACKET - A utility for 
  161.  
  162. ++++++++++++++++++++++ Coming Soon +++++++++++++++++++++++++++++++++++
  163.  
  164. Projects currently in the works from the Software Distillery:
  165.  
  166.  * A network file system that works with a variety of protocols, including
  167.    DNET for a two-Amiga serial-port-only hookup.
  168.  
  169.  * An MS-DOS file system that allows you to use all the normal CLI commands
  170.    on MS-DOS format diskettes.
  171.  
  172.  * HackLite Version 2 - Many more creatures and features.
  173.