home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 620.lha / mountshare / mountshare.man.pp / mountshare.man
Text File  |  1992-03-03  |  6KB  |  199 lines
  1.  
  2.      MountShare(1l)        Amiga Programmer's Manual         MountShare(1l)
  3.  
  4.  
  5.  
  6.      ›1mUSAGE 
  7.           ›0musage: MountShare {{[+-][lchdf]} {<devicename>}}
  8.            +l: load Handler/FileSystem file
  9.            +c: create FileSysEntry
  10.            -h: don't compare Handler/FileSystem filenames
  11.            -d: don't compare DosType values
  12.            +f: search FileSysEntries
  13.           The option opposite to default is shown.
  14.  
  15.           The use  of MountShare is as follows.  Suppose you have some
  16.           filesystem or other handler that you wish to mount  multiple
  17.           times.   For  example,  you might have the following in your
  18.           mountlist: 
  19.  
  20.           PIP:  Handler = L:ConHandler
  21.                 StackSize = 600
  22.                 Priority = 5
  23.                 GlobVec = 0
  24.           #
  25.           CNC:  Handler = L:ConHandler
  26.                 StackSize = 600
  27.                 Priority = 5
  28.                 GlobVec = 0
  29.           #
  30.  
  31.           If you mount and use both of PIP: and CNC:, the result  will
  32.           be that  the  handler L:ConHandler is loaded twice.  This is
  33.           clearly a waste of memory,  since  many  handlers  are  PURE
  34.           code.  
  35.  
  36.           ›4mNote›0m:  ›4mMountShare›0m  ›4mshould›0m  ›4mONLY›0m ›4mbe›0m ›4mused›0m ›4mwith›0m ›4mrespect›0m ›4mto›0m ›4mPURE›0m
  37.           ›4mhandlers›0m.   Examples  of  pure  handlers  are:  L:ConHandler
  38.           (ConMan),     L:FastFileSystem,     newer     versions    of
  39.           MessyFileSystem (1.51  and  higher),  L:Port-Handler  (PRT:,
  40.           SER: and PAR:).  
  41.  
  42.           MountShare will allow you to re-use the loaded code from one
  43.           device for   other  devices  that  are  applicable.    Using
  44.           MountShare you specify a "master" device whose handler  will
  45.           be re-used  by  other  devices.   (The word "device" in this
  46.           document is used for an AmigaDOS device,  not  for  an  Exec
  47.           .device.) 
  48.  
  49.           This is done in the following way: 
  50.  
  51.           - Optionally,  the  master  handler  is loaded if necessary.
  52.           Otherwise sharing it would not have any effect.  
  53.  
  54.           - Optionally,  the  handler  is  made   available   on   the
  55.           FileSystem.resource list.    This  can  only  be done if the
  56.           master has a proper DosType value.  
  57.  
  58.           - If the other device specifies the same  filename  for  the
  59.           handler, the master code is shared.  Otherwise, 
  60.  
  61.           - if  the  other device has the same DosType value specified
  62.           in the Mountlist information, the  master  code  is  shared.
  63.  
  64.  
  65.      Rhialto, KosmoSoft               -1-
  66.  
  67.  
  68.      MountShare(1l)        Amiga Programmer's Manual         MountShare(1l)
  69.  
  70.  
  71.           Otherwise, 
  72.  
  73.           - optionally,  if the other device has a DosType for which a
  74.           FileSystem.resource  handler  is  available,  that  code  is
  75.           shared.  
  76.  
  77.           Another  application  of  MountShare  is  when  you  have  a
  78.           harddisk with the FastFileSystem,  and  later  you  want  to
  79.           mount more partitions (or floppies) using the FFS. Since all
  80.           FFS devices are identified by the line 
  81.  
  82.               DosType = 0x444F5301
  83.  
  84.           you  can  mount  all  these  devices, then use MountShare to
  85.           share the FFS code between all of them.   If  your  harddisk
  86.           does not automount you may want to specify the +l option.  
  87.  
  88.      ›1mEXAMPLES 
  89.           ›0mThe  second  example  assumes  you  installed ConMan. ConMan
  90.           changes the CON: device as if it had the same  mountlist  as
  91.           given for PIP: and CNC: above.  
  92.  
  93.           1> MountShare +l ser
  94.           L:PORT-HANDLER loaded.
  95.           SER and PRT share handler L:PORT-HANDLER: SegList copied.
  96.           SER and PAR share handler L:PORT-HANDLER: SegList copied.
  97.  
  98.           1> Mount PIP: CNC:
  99.           1> MountShare CON
  100.           CON and CNC share handler L:ConHandler: SegList copied.
  101.           CON and PIP share handler L:ConHandler: SegList copied.
  102.  
  103.      ›1mCAVEATS 
  104.           ›0m›4mMountShare›0m   ›4mshould›0m  ›4mONLY›0m  ›4mbe›0m  ›4mused›0m  ›4mwith›0m  ›4mrespect›0m  ›4mto›0m  ›4mPURE›0m
  105.           ›4mhandlers›0m.  
  106.  
  107.           Of course,  you  should  use  MountShare  before  using  the
  108.           device,  because  otherwise  the  handler  will be loaded by
  109.           AmigaDOS and there won't be much to share.  
  110.  
  111.           Similarly, you should not have the line 
  112.  
  113.               Mount = 1
  114.  
  115.           in your mountlist entry, since the Mount command  will  load
  116.           the handler unconditionally in this case.  
  117.  
  118.           If  you  decide to share a file system handler, or add it to
  119.           the  FileSystem.resource,  the  handler  should   never   be
  120.           unloaded again.    If  the handler has the ability to unload
  121.           itself, this should not be used.  
  122.  
  123.      ›1mFUTURE COMPATIBILITY 
  124.           ›0mEverything that MountShare does should be done  by  a  smart
  125.           Mount command.      Perhaps  this  will  be  implemented  by
  126.           Commodore in a future version.  
  127.  
  128.  
  129.  
  130.  
  131.      Rhialto, KosmoSoft               -2-
  132.  
  133.  
  134.      MountShare(1l)        Amiga Programmer's Manual         MountShare(1l)
  135.  
  136.  
  137.      ›1mBUGS 
  138.           ›0mOther  processes  should  not  change  the  device  list  or
  139.           FileSystem.resource list while we are running.  
  140.  
  141.      ›1mAUTHOR 
  142.           ›0mCopyright   1992   by   Olaf  ›3mRhialto  ›0mSeibert.  All  rights
  143.           reserved.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.      Rhialto, KosmoSoft               -3-
  198.  
  199.