home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / disk / flat-1.3.lha / Flat-1.3 / Flat.doc < prev    next >
Encoding:
Text File  |  1991-07-26  |  5.9 KB  |  118 lines
  1. ========================== Flat-Handler 1.3 ==========================
  2. ======================================================================
  3. A  zany  disk  filing  system, written by Olaf 'Olsen' Barthel of MXM.
  4. Copyright,  ©  1990  by  MXM.   Shareware,  all  rights  reserved.  No
  5. guarantee  of  any  kind is made that the program(s) described in this
  6. document are 100% reliable.  You use this material on your own risk.
  7.  
  8. ============================== Purpose ===============================
  9. ======================================================================
  10. The  university  I  am  studying  at  has  just got rid of its old IBM
  11. mainframe  monster  which  has  been replaced by set of Sun4 Sparc IPC
  12. workstations.  Each station has its own disk drive built into the main
  13. unit.   Transfer  of data to and from the disk is easy if you know how
  14. to  accomplish  it.   Standard  3½"  disks can be formatted in vanilla
  15. MS-DOS format (double sided, 9 sectors, 512 bytes each) and read using
  16. MessyDOS/CrossDOS.   Unfortunately,  `pcfs'  is  not  available on the
  17. machines  I am working at, still using `tar' makes it easy to exchange
  18. files between both computers.
  19.    The  Amiga does not support block mapped files in the same way Un*x
  20. does.   My  first  attempt  to read tar archives written to disk would
  21. therefore  consist  of creating a disk-like file on my harddisk (using
  22. Matt Dillon's fmsdisk.device) and reading the disk-file with tar.
  23.    This  being  not the ideal solution I immediately started writing a
  24. custom  filing  system  to  map  all  block-oriented filing devices to
  25. virtual files.
  26.  
  27. =============================== Usage ================================
  28. ======================================================================
  29. Copy  `Flat-Handler' to  your L:  directory (copy Flat-Handler L:) and
  30. add  the  supplied  `MountList'  file  to  your  DEVS:MountList  (type
  31. >>DEVS:MountList MountList).  After that, the FLAT:-device is ready to
  32. be mounted (mount FLAT:).
  33.    Listing `FLAT:' will display something like the following:
  34.  
  35.                  MSH   737280 ----r--- Today 16:42:01 
  36.                  DF0   901120 ----rw-- Today 16:42:01 
  37.                  DF1        0 -------- Today 16:42:01 
  38.                  DH0 10948608 ----rw-- Today 16:42:01
  39.                  DH1 10616832 ----rw-- Today 16:42:01
  40.  
  41.    Each  one  of  these  `files' represents a disk-like block-oriented
  42. filing  device  (which has the same name, only the colon is left out).
  43. You  can  copy, type, read and write each device just like an ordinary
  44. file.   Each  read/write  call is mapped to a disk access which allows
  45. archiving  whole  disks  with  LhArc  or  diskcopy'ing  with  the  CLI
  46. copy-command.   The  protection  bits  refer  to the state of the disk
  47. drive and the data media within:
  48.  
  49.                 r - There is a disk in the disk drive.
  50.                 w - The disk is write-enabled.
  51.  
  52.    All  the other protection bits are by default cleared (you won't be
  53. able  to  delete a disk drive, set the `archived' bit or other foolish
  54. bits).   The  file  creations  dates are fake, and the file sizes will
  55. never  change (never say never:  if there is no disk in the approriate
  56. drive  the  size  of  a  file  will drop to zero).  The handler itself
  57. supports  only  the  basic command set a simple filing system needs to
  58. supply (read, write, open, close, lock, unlock, duplock, die).
  59.  
  60. ================ Transferring files from/to the Sun4 =================
  61. ======================================================================
  62. To  transfer files from/to the Sun4 workstation you will need MessyDOS
  63. or CrossDOS and the Amiga implementation of the `tar' program.
  64.    The  disk  format  on  the  Amiga  (MSH:,  DI0:, etc.) side must be
  65. configured  for a double-sided, 80-track disk with 9 blocks per track.
  66. These   settings   represent   the   `factory   settings' with   which
  67. MessyDOS/CrossDOS  are shipped, so there is probably no need to change
  68. them.
  69.    Now  it's time to initialize a disk, this can either be done on the
  70. Amiga  (using  "format  drive msh:  name Blank noicons") or on the Sun
  71. (using "fdformat -l").
  72.    Here  are  the basic commands to get tar to create and extract disk
  73. archives  (tar  offers a lot more options which you will probably want
  74. to study later):
  75.  
  76.                         To create an archive:
  77.  
  78.                   Sun4:  tar -cf /dev/fd0 <Files...>
  79.                   Amiga: tar -cf flat:msh <Files...>
  80.  
  81.                   To extract files from an archive:
  82.  
  83.                   Sun4:  tar -xf /dev/fd0 <Files...>
  84.                   Amiga: tar -xf flat:msh <Files...>
  85.  
  86.       To eject the disk from the Sun4 disk drive enter `eject'.
  87.  
  88. =============================== Author ===============================
  89. ======================================================================
  90. This  program was written by Olaf Barthel of MXM.  All files have been
  91. placed in the public domain.  You may freely distribute this material,
  92. even  a  small  copy  fee  is  okay  but  everything  which looks like
  93. commercial distribution is forbidden.  Still you may use this material
  94. for software development without giving credit to the original author.
  95.  
  96. Send   new   program  revisions,  comments,  bug  reports,  donations,
  97. unmarried   sisters,   non-poisoned   candy,  home-grown  palm  trees,
  98. horoscopes, promising capital investments, etc.  to:
  99.  
  100.                           Olaf Barthel, MXM
  101.                           Brabeckstrasse 35
  102.                           D-3000 Hannover 71
  103.  
  104.                      Federal Republic of Germany
  105.  
  106. ============ Revision history (most recent change first) =============
  107. ======================================================================
  108. V1.3    Added support for ACTION_COPY_DIR packet.
  109.  
  110. V1.2    You  couldn't  change  the  current  directory  to `FLAT:' and
  111.         examine  the  virtual  files  without having to specify a full
  112.         path name (such as `flat:df0'), this has been fixed.
  113.  
  114. V1.1    Extended   release  supporting  all  available  block-oriented
  115.         filing devices.
  116.  
  117. V1.0    First simple release supporting only a single disk drive.
  118.