fs-udf.so

Universal Disk Format and ISO-9960 filesystem support

Syntax:

driver ... udf udf_options ... &

Runs on:

Neutrino

Options:

Where driver is one of the devb-* drivers, and udf_options is one or more of the following, separated by commas:

case=asis|lower|upper

Control the case used to display ISO-9660 filenames (to a readdir() request; all pathname matching is always performed case-insensitively on such names):

• asis — don't convert the filename in any way; if the CD was mastered with strict ISO-9660 compliance, the name will be in uppercase, but more lenient utilities could produce mixed-case filenames.
• lower — convert to lowercase (the default).
• upper — convert to uppercase.

RRIP and Joliet store case-preserving names and ignore this option.

fileset=num

The File Set number to mount; the default is 0.

format=list

Set both the list of disk formats to support, as well as the order in which they should be probed (for media with multiple formats, such as UDF-Bridge/DVD-Video or ISO/Joliet). Separate the formats with colons (:) You can use this option to:

• set a specific order in which to probe (e.g. format=joliet:rrip:udf)
• remove a format (e.g. format=-rrip)
• add a format, making it the first preference (e.g. format=+udf)

The valid formats are:

• udf — OSTA/UDF, all v1.x and 2.x variants as supported.
• rrip — Rock Ridge extensions to ISO-9660; adds permissions and long names.
• joliet — Joliet extensions to ISO-9660; adds Unicode long names.
• iso9660e — the 1999 version of the ISO-9660 spec; adds mixed-case filenames.
• iso9660 — the base 1988 version of the ISO-9660 spec.
• audio — create a dummy mountpoint for an audio-only/CDDA disk.

The first matching, valid format in order from the specified list is mounted.

---

Since the audio format matches any disk with audio tracks, you should usually make it the last in the list. In addition, since many formats are extensions to a base ISO-9660 format, which is also present on the media, you should specify iso9660 itself after those formats.

---

The default is format=udf:rrip:joliet:iso9660e:iso9660:audio. For backward compatibility, set the format to format=udf to disable the CD/ISO formats.

gid=group

The group ID to use for files with no specified group. The default is 0.

hidden=hidden_mode

Specify what to do with “hidden” files. The hidden_mode can be one of:

• ignore — ignore the hidden files; they don't appear in the filesystem.
• show — (the default) show hidden files in the filesystem as normal files.
• dot — show hidden files in the filesystem with a dot (.) prefixed to their names.

info=path

The name of the filesystem metadata directory. The first character can be + or -, and this controls whether empty entries (metadata descriptors not given a value) are shown in the directory or not, respectively. For example, if a CD doesn't have a abstract or bibliography, those pseudo-files can be hidden, or left with a empty string in them.

The default is -.info..

perms=[file_permissions][:directory_permissions]

The permissions to use for ISO9660 files, directories, or both. The argument to this option consists of the permissions for files, followed by a colon (:), and then the permissions for directories. Either set of permissions is optional.

You can specify the permissions either as a simple numeric value, or in chmod-style format. For example, to make files executable, specify perms=+x, which is the equivalent to the exe option to fs-cd.so. Like the uid and gid options, this option is used only when the filesystem itself doesn't have explicit permissions (udf and rrip do; all others don't).

The default is a=r:a=rx.

uid=user

The user ID to use for files with no specified owner. The default is 0 (root).

vcd=num

Set the number of raw VCD 2352-byte deblocking buffers (default 0):

• When enabled, this option supports the transparent reading of Mode2 Form2 VCD files. For such files, a 44-byte RIFF header is constructed and prepended to the file data, and then data from the files' raw 2352-byte sectors are supplied.
• When disabled, such files are unreadable to POSIX read() and fail with EINVAL.

You can use the chattr command to identify Mode2 Form2 files.

verify=level

How much of the UDF tag content (tag version, tag location, header checksum, and/or data CRC) to verify; one of the following:

• none
• tag — all except the data CRC
• all
• ?tag
• ?all (the default)

Some UDF authoring utilities write incorrect tags, so it might be necessary to relax the verification if problems are observed. If you specify an option with a leading question mark (?), fs-udf.so consults an internal blacklist of known bad utilities and automatically skips all checks in the list; otherwise it operates at the level given after the question mark.

volume=num

The Primary Volume number to mount; the default is 0.

In addition, you can specify any of the filesystem options described for io-blk.so.

Description:

The fs-udf.so shared object provides support for UDF (OSTA-UDF/ECMA-167) and ISO-9660 (base 1998 spec, 1999 spec, Joliet extensions, Rock Ridge extensions) filesystems. It's automatically loaded by the devb-* drivers when mounting a UDF filesystem.

---

This filesystem uses UTF-8 encoding for presentation of its filenames; attempts to specify a filename not using UTF-8 encoding will fail (with an error of EILSEQ).

---

See also:

chattr, devb-*, fs-cd.so, fs-dos.so, fs-ext2.so, fs-mac.so, fs-nt.so, fs-qnx4.so, fs-qnx6.so, io-blk.so, mount, umount

Filesystems chapter of System Architecture

in the Working With Filesystems chapter, “Filesystems and block I/O (devb-*) drivers” in the Fine-Tuning Your System chapter, and “Filesystem limits” in the Understanding System Limits chapter of the QNX Neutrino User's Guide

QNX Neutrino User's Guide:

• “Universal Disk Format (UDF) filesystem” in the Working With Filesystems chapter
• “CD-ROMs and DVDs” in the Connecting Hardware chapter
• “Filesystems and block I/O (devb-*) drivers” in the Fine-Tuning Your System chapter
• “Filesystem limits” in the Understanding System Limits chapter