Merge tag 'for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mst/vhost
[platform/kernel/linux-rpi.git] / Documentation / filesystems / isofs.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ==================
4 ISO9660 Filesystem
5 ==================
6
7 Mount options that are the same as for msdos and vfat partitions.
8
9   =========     ========================================================
10   gid=nnn       All files in the partition will be in group nnn.
11   uid=nnn       All files in the partition will be owned by user id nnn.
12   umask=nnn     The permission mask (see umask(1)) for the partition.
13   =========     ========================================================
14
15 Mount options that are the same as vfat partitions. These are only useful
16 when using discs encoded using Microsoft's Joliet extensions.
17
18  ============== =============================================================
19  iocharset=name Character set to use for converting from Unicode to
20                 ASCII.  Joliet filenames are stored in Unicode format, but
21                 Unix for the most part doesn't know how to deal with Unicode.
22                 There is also an option of doing UTF-8 translations with the
23                 utf8 option.
24   utf8          Encode Unicode names in UTF-8 format. Default is no.
25  ============== =============================================================
26
27 Mount options unique to the isofs filesystem.
28
29  ================= ============================================================
30   block=512        Set the block size for the disk to 512 bytes
31   block=1024       Set the block size for the disk to 1024 bytes
32   block=2048       Set the block size for the disk to 2048 bytes
33   check=relaxed    Matches filenames with different cases
34   check=strict     Matches only filenames with the exact same case
35   cruft            Try to handle badly formatted CDs.
36   map=off          Do not map non-Rock Ridge filenames to lower case
37   map=normal       Map non-Rock Ridge filenames to lower case
38   map=acorn        As map=normal but also apply Acorn extensions if present
39   mode=xxx         Sets the permissions on files to xxx unless Rock Ridge
40                    extensions set the permissions otherwise
41   dmode=xxx        Sets the permissions on directories to xxx unless Rock Ridge
42                    extensions set the permissions otherwise
43   overriderockperm Set permissions on files and directories according to
44                    'mode' and 'dmode' even though Rock Ridge extensions are
45                    present.
46   nojoliet         Ignore Joliet extensions if they are present.
47   norock           Ignore Rock Ridge extensions if they are present.
48   hide             Completely strip hidden files from the file system.
49   showassoc        Show files marked with the 'associated' bit
50   unhide           Deprecated; showing hidden files is now default;
51                    If given, it is a synonym for 'showassoc' which will
52                    recreate previous unhide behavior
53   session=x        Select number of session on multisession CD
54   sbsector=xxx     Session begins from sector xxx
55  ================= ============================================================
56
57 Recommended documents about ISO 9660 standard are located at:
58
59 - http://www.y-adagio.com/
60 - ftp://ftp.ecma.ch/ecma-st/Ecma-119.pdf
61
62 Quoting from the PDF "This 2nd Edition of Standard ECMA-119 is technically
63 identical with ISO 9660.", so it is a valid and gratis substitute of the
64 official ISO specification.