arch/all-hosted/devs/hostdisk/hostdisk.txt

   1  Introduction.
   2  ==============================================
   3
   4  hostdisk.device is a hosted device driver which allows you to mount physical
   5 disk, partition, or image file located on your host operating systems. In
   6 particular, it can allow you to mount AmigaOS hard drives or native AROS
   7 partitions within hosted AROS.
   8
   9  On UNIX systems it is adviced to run AROS under root user if you want to use
  10 this driver. UNIXes often restrict (or totally disallow) access to disk devices
  11 for non-root users.
  12
  13  Mounting host-side physical disks.
  14  ==============================================
  15
  16  The driver behaves in the same manner as real device driver would do. It
  17 represents physical drives of your host operating system as units. E. g.
  18 unit 0 corresponds to the first physical drive, unit 1 - to the second, etc.
  19  An exact mapping between unit numbers and device names on currently supported
  20 operatins systems is (N stands for unit number):
  21
  22  Windows: \\.\PhysicalDrive<N>
  23  Darwin : /dev/disk<N>
  24
  25  This way you can even browse and edit partitions of your drives using
  26 HDToolBox. Please be extremely careful and know what you do and why when doing
  27 this on a drive that is currently in use by your host operating system!
  28
  29  Note that some operating systems (UNIXes) are known to block write access to
  30 the disk device if it is being used (e. g. has mounted partitions).
  31 hostdisk.device handles this correctly and allows to work in read-only mode
  32 under such a conditions.
  33
  34  Mounting host-side partitions and image files.
  35  ==============================================
  36
  37  In this mode you need to create a custom mount file with Unit= parameter
  38 specifying device or file name in string form. For example:
  39
  40 FileSystem      = sfs.handler
  41 Device          = hostdisk.device
  42 Unit            = /dev/disk0s3
  43 BlockSize       = 512
  44 Surfaces        = 1
  45 BlocksPerTrack  = 1
  46 LowCyl          = 0
  47 HighCyl         = 10559031
  48 Reserved        = 2
  49 Activate        = 1
  50 DosType         = 0x53465300
  51
  52  This is the file i use to mount DH0: partition for native AROS on my IntelMac.
  53 Please do not copy it 1:1, hard disk filesystems are not capable of detecting
  54 partition size by themselves and require to fill in HighCyl correctly. This
  55 example uses virtual geometry for LBA access (cylinder number = block number)
  56 for simplification. You can use your host's tools to determine total size of
  57 the partition you want to mount.
  58
  59  The same applies to image files, with the exception that you don't need to run
  60 AROS under root to gain access to them. You just need an access to the file.