NAME

mount_cdfs - mount a CD with the cdfs filesystem

SYNOPSIS

mount -F cdfs [ -o options ] card,unit directory

DESCRIPTION

cdfs is a read-only filesystem for CD and DVD media: ISO 9660 (with Rock Ridge and Joliet), UDF and HFS. The filesystem is a kernel module, from the package cdfs-k30 or cdfs-k46, whichever matches the running kernel; it loads at the first cdfs mount. This package installs the mount helper, /usr/lib/fs/cdfs/mount, which mount(1M) runs for -F cdfs, and the mount point /cdrom.

The drive is named by its SCSI controller and target, not by a /dev path: card is the controller's index and unit the drive's target id, joined by any character that is not a digit (0,2, 0.2 and 0:2 are the same drive). Give directory as an absolute path.

The helper always mounts read-only and ignores any -o options. It then adds the mount to /etc/mnttab, with the mount point in the special field as well as in the mount point field, as for /proc and /dev/fd. So mount and df show the CD as directory on directory, not by its drive, and umount directory unmounts it and removes the entry.

EXAMPLES

Mount the CD in the drive at target 2 of the first controller, list it and unmount it:

mount -F cdfs 0,2 /cdrom
ls /cdrom
umount /cdrom

FILES

/usr/lib/fs/cdfs/mount

the helper; this directory must hold no other file

/etc/mnttab

the table of mounted filesystems

/cdrom

the usual mount point

DIAGNOSTICS

Exit status 0: mounted. If the mount worked but /etc/mnttab could not be written, the helper prints a warning and still exits 0; the CD stays mounted. Exit status 1: the mount failed, with the errno printed:

ENXIO

no controller at that card.

ENOTTY

the target answers but is not a CD drive; check unit.

EINVAL

no filesystem cdfs reads on the disc, a disc of a shape it does not serve, or a spec that is not card,unit.

EIO

the drive delivered no readable data: cable, termination or media.

EBUSY

that drive or that directory is already mounted.

ENOMEM

a kernel allocation failed.

EPERM

not the superuser.

ENOTDIR

directory is not a directory.

Exit status 2: fewer than two operands.

mount reports unknown fstype or fails at once when the cdfs module is not installed or the kernel cannot load it.

NOTES

A file named umount in /usr/lib/fs/cdfs breaks umount(1M) for cdfs mounts (cannot execute, the CD stays mounted): remove it.

SEE ALSO

mount(1M), umount(1M), mnttab(4)