rom/filesys/ram/Notes

   1 TO DO:
   2
   3  - Make into resident module? [AmigaOS]
   4  - Allow deletion of hard-linked objects while they are locked?
   5  - Sort out problems relating to ACTION_WRITE result (prevents "disk full"
   6    requester being displayed) (DOS bug?). [AmigaOS].
   7  - Implement record locking.
   8  - Fix rollback problems in ACTION_RENAME_DISK.
   9  - Implement soft links?
  10  - Respect R and W flags for directories?
  11  - Should opening with MODE_READWRITE succeed when disk is locked?
  12
  13
  14 DESIGN NOTES:
  15
  16 File blocks:
  17
  18  - The first block is a dummy zero-length one in order to make some
  19    operations easier. For example, it allows the file handle for an empty
  20    file to have a current block.
  21  - All of a file's blocks must be full except perhaps the last one.
  22  - The file's 'end_length' field keeps track of how much of the last block
  23    is used.
  24  - A file handle must never be located at the beginning of a block; it
  25    must be at the end of the previous block instead. The only exception to
  26    this rule is the empty start block: the handle can be positioned at the
  27    beginning of this block because it's also the end.
  28
  29 Hard links implementation:
  30
  31 If a real object is linked, the object and its links are linked, via their
  32 "hard_link" node, into the "elements" list of one of the links. The link
  33 whose list is used is called the master link. The linked object is always
  34 first in the list and the master link is always second. An object without
  35 links has both fields of "hard_link" set to NULL.
  36
  37