1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 ================================== 3 ==================================
4 Macintosh HFS Filesystem for Linux 4 Macintosh HFS Filesystem for Linux
5 ================================== 5 ==================================
6 6
7 7
8 .. Note:: This filesystem doesn't have a maint 8 .. Note:: This filesystem doesn't have a maintainer.
9 9
10 10
11 HFS stands for ``Hierarchical File System`` an 11 HFS stands for ``Hierarchical File System`` and is the filesystem used
12 by the Mac Plus and all later Macintosh models 12 by the Mac Plus and all later Macintosh models. Earlier Macintosh
13 models used MFS (``Macintosh File System``), w 13 models used MFS (``Macintosh File System``), which is not supported,
14 MacOS 8.1 and newer support a filesystem calle 14 MacOS 8.1 and newer support a filesystem called HFS+ that's similar to
15 HFS but is extended in various areas. Use the 15 HFS but is extended in various areas. Use the hfsplus filesystem driver
16 to access such filesystems from Linux. 16 to access such filesystems from Linux.
17 17
18 18
19 Mount options 19 Mount options
20 ============= 20 =============
21 21
22 When mounting an HFS filesystem, the following 22 When mounting an HFS filesystem, the following options are accepted:
23 23
24 creator=cccc, type=cccc 24 creator=cccc, type=cccc
25 Specifies the creator/type values as s 25 Specifies the creator/type values as shown by the MacOS finder
26 used for creating new files. Default 26 used for creating new files. Default values: '????'.
27 27
28 uid=n, gid=n 28 uid=n, gid=n
29 Specifies the user/group that owns all 29 Specifies the user/group that owns all files on the filesystems.
30 Default: user/group id of the mountin 30 Default: user/group id of the mounting process.
31 31
32 dir_umask=n, file_umask=n, umask=n 32 dir_umask=n, file_umask=n, umask=n
33 Specifies the umask used for all files 33 Specifies the umask used for all files , all directories or all
34 files and directories. Defaults to th 34 files and directories. Defaults to the umask of the mounting process.
35 35
36 session=n 36 session=n
37 Select the CDROM session to mount as H 37 Select the CDROM session to mount as HFS filesystem. Defaults to
38 leaving that decision to the CDROM dri 38 leaving that decision to the CDROM driver. This option will fail
39 with anything but a CDROM as underlyin 39 with anything but a CDROM as underlying devices.
40 40
41 part=n 41 part=n
42 Select partition number n from the dev 42 Select partition number n from the devices. Does only makes
43 sense for CDROMS because they can't be 43 sense for CDROMS because they can't be partitioned under Linux.
44 For disk devices the generic partition 44 For disk devices the generic partition parsing code does this
45 for us. Defaults to not parsing the p 45 for us. Defaults to not parsing the partition table at all.
46 46
47 quiet 47 quiet
48 Ignore invalid mount options instead o 48 Ignore invalid mount options instead of complaining.
49 49
50 50
51 Writing to HFS Filesystems 51 Writing to HFS Filesystems
52 ========================== 52 ==========================
53 53
54 HFS is not a UNIX filesystem, thus it does not 54 HFS is not a UNIX filesystem, thus it does not have the usual features you'd
55 expect: 55 expect:
56 56
57 * You can't modify the set-uid, set-gid, stic 57 * You can't modify the set-uid, set-gid, sticky or executable bits or the uid
58 and gid of files. 58 and gid of files.
59 * You can't create hard- or symlinks, device 59 * You can't create hard- or symlinks, device files, sockets or FIFOs.
60 60
61 HFS does on the other have the concepts of mul 61 HFS does on the other have the concepts of multiple forks per file. These
62 non-standard forks are represented as hidden a 62 non-standard forks are represented as hidden additional files in the normal
63 filesystems namespace which is kind of a cludg 63 filesystems namespace which is kind of a cludge and makes the semantics for
64 the a little strange: 64 the a little strange:
65 65
66 * You can't create, delete or rename resource 66 * You can't create, delete or rename resource forks of files or the
67 Finder's metadata. 67 Finder's metadata.
68 * They are however created (with default valu 68 * They are however created (with default values), deleted and renamed
69 along with the corresponding data fork or d 69 along with the corresponding data fork or directory.
70 * Copying files to a different filesystem wil 70 * Copying files to a different filesystem will loose those attributes
71 that are essential for MacOS to work. 71 that are essential for MacOS to work.
72 72
73 73
74 Creating HFS filesystems 74 Creating HFS filesystems
75 ======================== 75 ========================
76 76
77 The hfsutils package from Robert Leslie contai 77 The hfsutils package from Robert Leslie contains a program called
78 hformat that can be used to create HFS filesys 78 hformat that can be used to create HFS filesystem. See
79 <https://www.mars.org/home/rob/proj/hfs/> for 79 <https://www.mars.org/home/rob/proj/hfs/> for details.
80 80
81 81
82 Credits 82 Credits
83 ======= 83 =======
84 84
85 The HFS drivers was written by Paul H. Hargrov 85 The HFS drivers was written by Paul H. Hargrovea (hargrove@sccm.Stanford.EDU).
86 Roman Zippel (roman@ardistech.com) rewrote lar 86 Roman Zippel (roman@ardistech.com) rewrote large parts of the code and brought
87 in btree routines derived from Brad Boyer's hf 87 in btree routines derived from Brad Boyer's hfsplus driver.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.