CDFS(4)                                                   CDFS(4)

     NAME
          cdfs - CD reader and writer file system

     SYNOPSIS
          cdfs [ -d sddev ] [ -m mtpt ]

     DESCRIPTION
          Cdfs serves a one and a half level directory mounted at mtpt
          (default /mnt/cd) that provides access to the tracks on CDs
          placed in the CD reader or writer named by sddev (default
          /dev/sdD0, see sd(3)).

          The top level directory contains one file per CD track.  The
          files are named cNNN, where c is a type character (a for
          audio tracks and d for data tracks) and NNN is the track
          number.

          If the device is capable of writing CDs and contains a writ-
          able CD, the top level directory also contains two empty
          directories wa and wd.  Files created in these directories
          appear in the top level directory as new audio or data
          tracks, regardless of name.

          At any time, any number of tracks may be open for reading or
          a single track may be open for writing.  Writing a CD track
          is a real-time operation: the CD writer must be kept satu-
          rated with new data to avoid buffer underruns.  To ensure
          this, copying from a file system stored on local disk is
          recommended.

          To fixate a CD (close a writable CD by writing its permanent
          table of contents), simply remove the wa or wd directory.
          The directory removed selects whether the CD is fixated as
          an audio or data CD; since each track carries its own type
          information, very few readers care which fixation type was
          used.

          The top level directory also contains a ctl file, into which
          control messages may be echoed.  The current control mes-
          sages are:

          blank        Blank the entire rewritable CD in the drive.
          quickblank   Blank only the table of contents on the rewrit-
                       able CD in the drive.
          eject        Eject the CD in the drive.
          ingest       Ingest a CD into the drive.

          Only MMC-compliant CD readers and writers are supported, but
          it would be easy to add support for early CD writers if
          desired.

     Page 1                       Plan 9            (printed 11/26/24)

     CDFS(4)                                                   CDFS(4)

     EXAMPLE
          Copy the audio tracks from a CD:

               cdfs -d /dev/sd05
               mkdir /tmp/songs
               cp /mnt/cd/a* /tmp/songs

          Copy the tracks onto a blank CD inserted in the drive, and
          then fixate the disk as an audio CD.

               cp /tmp/songs/* /mnt/cd/wa
               rm /mnt/cd/wa

          Cut your own 9660 CD-ROM, without spooling the CD image to a
          temporary file.

               disk/mk9660 -9cj -n notice cdproto >/mnt/cd/wd/foo
               rm /mnt/cd/wd

     SOURCE
          /sys/src/cmd/cdfs

     SEE ALSO
          sd(3), 9660srv (in dossrv(4)), mk9660(8)

     BUGS
          There should be support for DVDs.

     Page 2                       Plan 9            (printed 11/26/24)