ODFileSystem for AmigaOS 4
==========================

ODFileSystem is a read-only optical-disc filesystem handler for
AmigaOS.  It mounts CD-ROM, DVD, Blu-ray, and image-backed optical
media through the normal AmigaDOS filesystem interface.

This archive contains the PowerPC AmigaOS 4 build.  It is separate
from the m68k AmigaOS 3 archive.


Archive Contents
----------------

- ODFileSystem-amigaos4
  Disk-loadable filesystem handler.  Copy or rename this to
  L:ODFileSystem when installing it for use with a DOSDriver or
  mountlist entry.

- CDFileSystem
  Relocatable Kickstart resident module.  Use this to replace the
  AmigaOS 4 Kickstart CDFileSystem module.

- ODFileSystem-amigaos4-test
  Test build of the disk-loadable handler with serial debug output
  enabled.

- CDFileSystem-test
  Test build of the Kickstart resident module with serial debug output
  enabled.

- Env-Archive/Sys/def_cdda.info
  Default Workbench disk icon for pure audio CDs.

- README.md
  This file.


Features
--------

- ISO 9660 directory and file access
- Rock Ridge long names and metadata
- Joliet Unicode names
- UDF bridge-disc support
- HFS and HFS+ data-fork access
- Multisession media support
- CDDA tracks exposed as virtual audio files
- Read-only operation for safe use with optical media

For ISO-family hybrid discs, ODFileSystem prefers Rock Ridge, then
Joliet, then plain ISO 9660.  For bridge discs it prefers the ISO view
by default; UDF and HFS can be selected explicitly through mount
options.


Disk-Loaded Installation
------------------------

Use this method if you want ODFileSystem to behave like a normal
filesystem handler loaded from disk.

1. Copy the handler to:

       L:ODFileSystem

2. Install or edit a DOSDriver entry, for example:

       DEVS:DOSDrivers/CD0

3. Set the filesystem in the DOSDriver or Mountlist to:

       FileSystem = L:ODFileSystem

4. Set Device and Unit for your CD/DVD device.

Mount the device from Workbench by double-clicking the DOSDriver icon,
or from Shell with:

       Mount CD0:

To use the supplied audio-CD icon, copy it to both the persistent and
current default-icon directories:

       Copy Env-Archive/Sys/def_cdda.info ENVARC:Sys/
       Copy Env-Archive/Sys/def_cdda.info ENV:Sys/

For pure audio CDs, ODFileSystem presents this default icon as the
volume's Disk.info. If it is unavailable, Workbench falls back to its
normal default CD icon. Data and mixed-mode discs continue to use
their normal disk icons.


Kickstart Installation
----------------------

Use this method if you want ODFileSystem to replace the Kickstart
CDFileSystem module used during early boot.

1. Back up your existing Kickstart CD filesystem module:

       Kickstart/CDFileSystem

2. Copy the supplied module to:

       Kickstart/CDFileSystem

   The file name should remain CDFileSystem.  Do not rename it to
   ODFileSystem.kmod unless you also edit Kicklayout.

3. Check that Kicklayout contains this module entry:

       MODULE Kickstart/CDFileSystem

4. Rebuild or update your Kickstart.zip if your machine or emulator
   boots from a zipped Kickstart directory.

5. Reboot.

The supplied CDFileSystem file is an AmigaOS 4 Kickstart resident
module.  It is intentionally different from the disk-loadable
ODFileSystem handler.


Mount Options
-------------

Options can be supplied with the DOSDriver Control string:

       Control = "LOWERCASE UDF"

Supported options include:

- LOWERCASE
  Lowercase plain ISO 9660 names.

- NOROCKRIDGE or NORR
  Disable Rock Ridge.

- NOJOLIET or NOJ
  Disable Joliet.

- UDF
  Prefer UDF on bridge discs.

- HFSFIRST or HF
  Prefer HFS on hybrid HFS/ISO discs.

- FILEBUFFERS=n or FB=n
  Set the block-cache size in sectors (default 1024, 2 MiB).

- METACACHE=n or MC=n
  Set the parsed-directory cache size in KiB (default 1024, 0 turns
  it off).

- AIFF
  Expose CDDA audio tracks as AIFF files instead of WAV files.


Limitations
-----------

ODFileSystem is read-only.

HFS and HFS+ support exposes data forks only.  Resource forks and
Finder metadata are not presented through the AmigaDOS view, so some
classic Mac media may not appear exactly as they would on Mac OS.

Project source and current documentation are available from the
ODFileSystem repository:

       https://github.com/reinauer/ODFileSystem

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
-rw-r--r--     0/0       68512  138472  49.5% -lh5- 9863 Oct 25 15:55 CDFileSystem
-rw-r--r--     0/0       81847  170944  47.9% -lh5- eb0e Oct 25 15:55 CDFileSystem-test
-rw-r--r--     0/0        1806    2620  68.9% -lh5- ce6b Oct 25 15:55 Env-Archive/Sys/def_cdda.info
-rwxr-xr-x     0/0       69052  134240  51.4% -lh5- e53e Oct 25 15:55 ODFileSystem-amigaos4
-rwxr-xr-x     0/0       83262  168808  49.3% -lh5- d4ed Oct 25 15:55 ODFileSystem-amigaos4-test
-rw-r--r--     0/0        1962    4604  42.6% -lh5- f296 Oct 25 15:55 README.md
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         6 files  306441  619688  49.5%            Oct 26 00:49