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