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