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