Merge tag 'kconfig-cleanups' of git://git.kernel.org/pub/scm/linux/kernel/git/robh...
[sfrench/cifs-2.6.git] / Documentation / filesystems / hfsplus.txt
1
2 Macintosh HFSPlus Filesystem for Linux
3 ======================================
4
5 HFSPlus is a filesystem first introduced in MacOS 8.1.
6 HFSPlus has several extensions to HFS, including 32-bit allocation
7 blocks, 255-character unicode filenames, and file sizes of 2^63 bytes.
8
9
10 Mount options
11 =============
12
13 When mounting an HFSPlus filesystem, the following options are accepted:
14
15   creator=cccc, type=cccc
16         Specifies the creator/type values as shown by the MacOS finder
17         used for creating new files.  Default values: '????'.
18
19   uid=n, gid=n
20         Specifies the user/group that owns all files on the filesystem
21         that have uninitialized permissions structures.
22         Default:  user/group id of the mounting process.
23
24   umask=n
25         Specifies the umask (in octal) used for files and directories
26         that have uninitialized permissions structures.
27         Default:  umask of the mounting process.
28
29   session=n
30         Select the CDROM session to mount as HFSPlus filesystem.  Defaults to
31         leaving that decision to the CDROM driver.  This option will fail
32         with anything but a CDROM as underlying devices.
33
34   part=n
35         Select partition number n from the devices.  This option only makes
36         sense for CDROMs because they can't be partitioned under Linux.
37         For disk devices the generic partition parsing code does this
38         for us.  Defaults to not parsing the partition table at all.
39
40   decompose
41         Decompose file name characters.
42
43   nodecompose
44         Do not decompose file name characters.
45
46   force
47         Used to force write access to volumes that are marked as journalled
48         or locked.  Use at your own risk.
49
50   nls=cccc
51         Encoding to use when presenting file names.
52
53
54 References
55 ==========
56
57 kernel source:          <file:fs/hfsplus>
58
59 Apple Technote 1150     https://developer.apple.com/legacy/library/technotes/tn/tn1150.html