home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 354.lha / MSH_v1.5 / doc / msh.man < prev    next >
Text File  |  1990-03-12  |  18KB  |  397 lines
  1.  
  2.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  3.  
  4.  
  5.  
  6.      ›1mSYNOPSYS 
  7.           ›0mMount MSH: 
  8.  
  9.           MSH:<any valid file specification>, or just 
  10.           <any  valid file specification> if your current directory is
  11.           somewhere on MSH:.  
  12.  
  13.      ›1mUSAGE 
  14.           ›0mMSH: is a real Amiga-style File System handler that  handles
  15.           messydos formatted  diskettes.    You  can use files on such
  16.           messydos disks in almost exactly the same  way  as  you  use
  17.           files on normal Amiga disks.  
  18.  
  19.           Supported  are  40  or  80  tracks,  double-sided 8, 9 or 10
  20.           sector floppy disks, and harddisks with a 12 or  16-bit  FAT
  21.           of any   dimension   the  FAT  allows.    (Due  to  lack  of
  22.           availability, I have not been able  to  test  MSH:  on  hard
  23.           disks; proceed with extreme caution).  
  24.  
  25.      ›1mMOUNTLIST 
  26.           ›0mA  sample Mountlist entry, that works with the Arp 1.3 Mount
  27.           command: 
  28.  
  29.           /*
  30.            *  Messy file system on messy blocks:
  31.            */
  32.           MSH:    FileSystem = MessyFileSystem
  33.                   Device = messydisk.device
  34.                   Unit = 1
  35.                   Flags = 0
  36.           /*
  37.            *  HighCyl is ignored, LowCyl, Surfaces and BlocksPerTrack
  38.            *  are used once to find the bootblock. Further parameters
  39.            *  are found there.
  40.            */
  41.                   LowCyl = 0 ; HighCyl = 79
  42.                   Surfaces = 2
  43.                   BlocksPerTrack = 9
  44.                   Buffers = 5
  45.           /*
  46.            *  Use BufMemType = 3 [for MEMF_CHIP | MEMF_PUBLIC] if you
  47.            *  use MSH: on the trackdisk.device.
  48.            */
  49.                   BufMemType = 1
  50.                   BootPri = 0
  51.                   Stacksize = 4096
  52.                   Priority = 5
  53.                   GlobVec  = -1
  54.           #
  55.  
  56.           This Mountlist entry instructs MSH: to use  floppy  unit  1,
  57.           i.e.  DF1:  and  the  messydisk.device.   You may choose any
  58.           name instead of MSH: that you like.   For  this  case,  MS1:
  59.           would also  be a sensible choice.  You can read the separate
  60.           manual page about messydisk.device.  It is  supposed  to  be
  61.           possible  to  use MSH: on a harddisk by supplying the proper
  62.           device name and unit number.  If you wish  to  use  floppies
  63.  
  64.  
  65.      KosmoSoft                        -1-                      Version 34.4
  66.  
  67.  
  68.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  69.  
  70.  
  71.           truly  compatible  with those messy machines, you should use
  72.           the messydisk.device.  You  cannot  change  this  name  into
  73.           something else.  
  74.  
  75.           The  Mountlist  entries LowCyl, Surfaces, and BlocksPerTrack
  76.           are used once to determine  the  location  of  the  messydos
  77.           bootblock.   Disk  blocks  of  512 bytes are assumed in this
  78.           calculation.  Further information is then obtained from  the
  79.           bootblock (see below).  
  80.  
  81.      ›1mCOMPATIBILITY 
  82.           ›0mEven  though  MSH:  uses  one of your floppy drives, you may
  83.           still use that drive for  normal  Amiga  disks.    You  will
  84.           notice  that  when  you  insert  a disk in the drive used by
  85.           MSH:, both MSH: and the regular Amiga  file  system  handler
  86.           will attempt  to identify the disk.  The result will be that
  87.           one of the two will be unable to read it, and then leave  it
  88.           alone so that the other may use it.  
  89.  
  90.           This  is  what happens when you insert a messydos disk: Both
  91.           file systems will try to read the boot block  of  the  disk.
  92.           The regular Amiga file system gets a read error, and retries
  93.           a few  times,  while recalibrating the disk read head.  This
  94.           is the short noise you may hear from the drive.    At  about
  95.           the  same  time, MSH: will seize control over the disk unit,
  96.           read the disk, and see  that  all  is  well.    It  is  then
  97.           prepared to actually use the disk.  
  98.  
  99.           This  is  what happens when you insert an Amiga disk: Again,
  100.           both file systems will try to read the  boot  block  of  the
  101.           disk.  But this time MSH: will desperately try to understand
  102.           the  disk, but it will give up when it is convinced that the
  103.           disk is really not meant for it.  
  104.  
  105.           It is recommended that you don't attempt to  refer  to  MSH:
  106.           while other filesystems are trying to read the disk.  
  107.  
  108.           In  some  situations  where there are multiple errors at the
  109.           same time (such as trying to delete a non-existent file from
  110.           a write-protected disk), the error reported may be different
  111.           than the regular file system.  
  112.  
  113.      ›1mEXTENSIONS 
  114.           ACTION›0m_›1mDIE 
  115.  
  116.           ›0mThe packet ›3mACTION_DIE ›0mis supported, and even has the  result
  117.           of stopping  MSH:  and unloading the file system code.  This
  118.           is convenient when you don't need to use MSH:  for  a  while
  119.           and helps  you  to conserve memory.  A program called ›3mdie ›0mis
  120.           supplied that sends the ACTION_DIE packet to any handler you
  121.           wish.  If there is any program running that expects MSH:  to
  122.           remain  present even while there are no open or locked files
  123.           on MSH:, it may be dangerous to remove MSH:.  
  124.  
  125.           ›1mACTION›0m_›1mMORECACHE 
  126.  
  127.           ›0mMSH:  handles  the  packet  ›3mACTION_MORECACHE  ›0m(used  by  the
  128.           AddBuffers  command)  and  cache buffers more intelligently.
  129.  
  130.  
  131.      KosmoSoft                        -2-                      Version 34.4
  132.  
  133.  
  134.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  135.  
  136.  
  137.           When you add buffers, the required memory is  not  allocated
  138.           immediately,  but  gradually  as there becomes a use for it.
  139.           When you remove a disk its buffers are no longer of use  and
  140.           therefore are  all  freed.  And, what is more important, you
  141.           can decrease the maximum number of buffers.  By specifying a
  142.           negative number you reduce the number of buffers.   If  your
  143.           AddBuffers  does not like negative buffer counts, simply add
  144.           65536 to the (negative) number you  actually  intend.    So,
  145.           instead  of  -1 you can also specify 65535, -2 is 65534. You
  146.           wouldn't want  to  add  more  than  32767  buffers  at  once
  147.           anyway.  
  148.  
  149.      ›1mLIMITATIONS 
  150.           ›0mDue  to  the  difference  between messydos and AmigaDOS file
  151.           systems, not all operations that  are  available  for  Amiga
  152.           files can be applied to messydos files.  
  153.  
  154.           ›1mFile names 
  155.  
  156.           ›0mThe   most  eye-catching  difference  are  the  file  names:
  157.           messydos file names can be at most "8 + 3" characters  long.
  158.           This  means  that  the  "base"  part of the file name may be
  159.           eight characters long, maybe followed by  a  three-character
  160.           "extension",  which  is  separated from the base name with a
  161.           period ('.'). Also, you cannot use  all  characters  in  the
  162.           file  names  you  wish, but the charater choice is basically
  163.           limited to the uppercase letters A-Z, digits 0-9,  and  most
  164.           "punctuation" characters  except  space * ?  . < > / = | , :
  165.           and \.  
  166.  
  167.           MSH: will try to map  file  names  that  you  or  a  program
  168.           attempts to use to names that are actually allowed.  But for
  169.           utmost  flexibility,  only  the  most  basic limitations are
  170.           enforced:  the  length  of   the   name   (8+3),   uppercase
  171.           alphabetics,  and  the  presence  of  only one period in the
  172.           name.  This means that you might create file  names  that  a
  173.           messydos  computer  does  not  correctly know how to handle.
  174.           But care has been taken that in no case it would be possible
  175.           to create a file name that, once created, cannot be  handled
  176.           anymore  by MSH:. You can always refer to that file with the
  177.           same name you used before, even if MSH: changed it for you.  
  178.  
  179.           ›1mSpecial directories ›0m. ›1mand ›0m.. 
  180.  
  181.           On messydos floppies, every  subdirectory  has  two  special
  182.           entries called  "."    and "..". They refer to the directory
  183.           itself and its "parent" directory, respectively.    Programs
  184.           that  traverse directory trees on messydos systems take care
  185.           to skip these "subdirectories", since they  really  are  not
  186.           "sub" direcories and recursively entering them would lead to
  187.           nothing but  trouble.    (Their  presence  prevents the file
  188.           system from have a tree structure.) But  with  AmigaDOS  1.3
  189.           and  before,  no  such  "hard  links"  exist,  and directory
  190.           traversing  programs  would  not  hesitate  to  enter  them.
  191.           Therefore, they  are  ›3mcompletely  ›0mhidden  from  sight.   You
  192.           cannot see them in directory listings nor refer to  them  by
  193.           any name.  
  194.  
  195.  
  196.  
  197.      KosmoSoft                        -3-                      Version 34.4
  198.  
  199.  
  200.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  201.  
  202.  
  203.           But  even  while  it  is hidden, the ".." entry is of course
  204.           still updated to reflect the new  parent  directory  when  a
  205.           directory is  renamed  and  moved.    Note, by the way, that
  206.           moving directories is an operation that is not supported  by
  207.           messydos itself.  
  208.  
  209.           Of  course,  the  usual  methods  of  accessing  the current
  210.           directory (the empty name "") and the parent directory ("/")
  211.           do work.  
  212.  
  213.           It may be  that  in  the  future,  when  softlinks  will  be
  214.           included in AmigaDOS, these "." and ".." directories will be
  215.           made visible  again, but in the disguise of a soft link.  In
  216.           that case, programs which don't  know  how  to  handle  them
  217.           should   either  not  exist  anymore  or  ignore  the  links
  218.           themselves.  
  219.  
  220.           ›1mFilenotes 
  221.  
  222.           ›0mMessydos has no provision for file notes and therefore  they
  223.           cannot be supported.  
  224.  
  225.           ›1mFile protection bits vs›0m.  ›1mfile attributes 
  226.  
  227.           ›0mCurrently,  the  following  interpretation  of messydos file
  228.           attributes is performed.    The  Directory  and  Volumelabel
  229.           attributes  are  honored  to  make  these  directory entries
  230.           different from plain files.  
  231.           The HIDDEN and SYSTEM attributes are mapped to the  H(idden)
  232.           bit.   The  H  bit  is  mapped  to the HIDDEN attribute; the
  233.           SYSTEM attribute cannot be changed.  
  234.           The  READ-ONLY  attribute  is  mapped  to  the  W(rite)  and
  235.           D(elete) bits.   Inversely, if a file is set to either Write
  236.           or Delete protected, the READ-ONLY attribute is set.  
  237.           The ARCHIVE bit, when clear, sets the A(rchived)  bit.    On
  238.           messydos  the  ARCHIVE  attribute  means (when set) that the
  239.           file MUST be backed up (by a backup program).  A write to  a
  240.           file sets  the  ARCHIVE attribute.  On AmigaDOS the Archived
  241.           bit means  (when  set)  that  the  file  has  been  archived
  242.           already.   A  write to a file clears the Archived protection
  243.           bit.  
  244.  
  245.           ›1mBoot block format 
  246.  
  247.           ›0mMSH: relies on the information in the boot  block  regarding
  248.           the  number of bytes per block, blocks per track, tracks per
  249.           cylinder, blocks per cluster, etc.  The physical information
  250.           is not actually used to access  the  disk,  except  for  the
  251.           number  of  tracks  which is derived from other information.
  252.           It is used to decide if a 40 track disk is inserted in a  80
  253.           track drive.   Single  sided  disks  are not supported.  The
  254.           number of sectors may  be  whatever  the  underlying  device
  255.           driver supports.  (With messydisk.device this is 8, 9 or 10;
  256.           with  trackdisk.device  it  is  11). Only the logical layout
  257.           information is used: Size of a  block,  number  of  reserved
  258.           blocks,  number of FATs, number of blocks per FAT, number of
  259.           root directory entries, number of blocks per cluster.    The
  260.           total  number of blocks is used to determine the usable part
  261.  
  262.  
  263.      KosmoSoft                        -4-                      Version 34.4
  264.  
  265.  
  266.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  267.  
  268.  
  269.           of the disk.  But if the FAT says "use a  block  beyond  the
  270.           limit", this error is not detected.  
  271.  
  272.           If  you format a disk on a messydos computer and wish to use
  273.           it with MSH:, be sure to use a messydos version  new  enough
  274.           to write  this  information in the boot block.  (Version 3.2
  275.           works nicely for me.) If you wish to format such a  disk  on
  276.           your  Amiga,  you  can  use  PCF720  by  Werner Günther with
  277.           pcFormat on the Extras disk, or use  the  supplied  messyfmt
  278.           program.  
  279.  
  280.           ›1mFAT 
  281.  
  282.           ›0mThe   FAT   is  currently  not  checked  for  integrity  and
  283.           consistency.  The FAT is assumed to have 12-bit  entries  if
  284.           the disk  has at most 4086 ($FF6) clusters.  If the disk has
  285.           more clusters than that, 16 bit  FAT  entries  are  assumed.
  286.           This is the method that seems to be used by messy dos 3.0.  
  287.  
  288.           ›1mWorkbench 
  289.  
  290.           ›0mThe  Workbench wants to use filenames that are impossible on
  291.           messydos floppies.  (.info extension) It  is  therefore  not
  292.           very effective to try to use Workbench on MSH:.  
  293.  
  294.           ›1mVolume label 
  295.  
  296.           ›0mNormal  AmigaDOS  floppies  have a part of the disk reserved
  297.           for their name.  With messydos floppies a name is  optional,
  298.           and  should be in the directory in an entry with the special
  299.           flag  (attribute)  Volumelabel.  MSH:  looks  in  the  first
  300.           directory block  only  to  locate  such  a volume label.  If
  301.           found, it decides the name of the disk; if  not  found,  the
  302.           name will become "Unnamed" and the creation date will become
  303.           1-Jan-80.  Note that AmigaDOS (and MSH:) keep disks apart by
  304.           their name and creation date.  As a  result,  all  unlabeled
  305.           disks will look the same and cannot be distinguished.  It is
  306.           therefore  strongly  recommended that you provide every disk
  307.           with a unique volume label; the  standard  AmigaDOS  command
  308.           Relabel can  be used for this.  If you label a disk that had
  309.           no label (in the first directory sector) before,  MSH:  will
  310.           try  to  move  a  file  from  the  first  directory block to
  311.           somewhere else in the  root  directory.    If  this  is  not
  312.           possible,  for  instance because the root directory is full,
  313.           then the labeling will fail as well.  
  314.  
  315.           ›1mMultiple file systems 
  316.  
  317.           ›0mThe MessyFileSystem  is  unfortunately  not  ``pure''.  This
  318.           means that if you wish to mount multiple messy file systems,
  319.           you  must  make a copy of MessyFileSystem for each of these,
  320.           and mount each one from one of the separate copies.  Running
  321.           two file systems from the same disk file  will  cause  great
  322.           troubles.   (Oh  well, maybe AmigaDOS is not so smart to see
  323.           that two file systems share the same FileSystem name in  the
  324.           Mountlist,  so  maybe you don't need to have multiple copies
  325.           of MessyFileSystem on your disk.  Try at your own risk.) 
  326.  
  327.  
  328.  
  329.      KosmoSoft                        -5-                      Version 34.4
  330.  
  331.  
  332.      MSH:(FileSystems)     Amiga Programmer's Manual      MSH:(FileSystems)
  333.  
  334.  
  335.      ›1mUTILITIES 
  336.           ›0mA program called ›3mmessyfmt ›0mallows  you  to  format  disks  in
  337.           messydos format.  
  338.  
  339.           Usage: Messyfmt <unitnr> <device> 
  340.  
  341.           The    <device>   name   is   optional   and   defaults   to
  342.           "messydisk.device". The program asks for all  parameters  to
  343.           put in the bootblock, like 
  344.  
  345.           Bytes per sector?  [512] 
  346.  
  347.           If  you  just  hit  return  you  accept  the  default value,
  348.           otherwise you can enter a new value in the  usual  notation:
  349.           0x  =  hexadecimal,  0  =  octal,  and  everything  else  is
  350.           decimal.  A  few  suffixes  are  allowed  as  multiplication
  351.           factor:  m  =  mega  (1048576), k = kilo (1024), s = sectors
  352.           (512) and b = byte (1). (Not all terms make sense  with  all
  353.           questions.)  You  may  create  8,  9  or  10 sector disks by
  354.           answering the question "Sectors per track" appropriately.  
  355.           You are also asked if you wish to format the whole  disk  or
  356.           only  the  first part with the bootblock, FAT and directory.
  357.           Finally, to see if you are still awake, you must enter 42 if
  358.           you are sure to do it.  
  359.           After formatting has completed, you  must  remove  the  disk
  360.           from  the  drive,  in  order to let all involved filesystems
  361.           know that the disk just died and reincarnated.  
  362.  
  363.           ›3mDiskCopy ›0mcan be used to copy messydos  disks,  provided  you
  364.           have one  or more file systems mounted.  Note, however, that
  365.           DiskCopy looks at the disk size information as it is present
  366.           in the Mountlist.  Therefore  DiskCopy  will  not  copy  the
  367.           entire disk if it is 10-sector while the Mountlist claims it
  368.           is  9-sector. In the opposite situation, it will try to copy
  369.           too much which will result in read errors, which  may  cause
  370.           the last  track not to be copied.  You can construct special
  371.           Mountlist entries for 8 or 10 sector disks if  you  plan  to
  372.           DiskCopy them; there is no need to really mount these.  
  373.  
  374.      ›1mTRADEMARKS 
  375.           ›0mAmiga,     AmigaDOS,    Workbench    are    trademarks    of
  376.           Commodore-Amiga, Inc. Messydos is presumably a trademark  of
  377.           MessySoft, Inc.  
  378.  
  379.      ›1mAUTHOR 
  380.           ›0mThe  messy  file system handler is written by ›3mSourcerer ›0mOlaf
  381.           ›3mRhialto ›0mSeibert.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.      KosmoSoft                        -6-                      Version 34.4
  396.  
  397.