88 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3==================================4Macintosh HFS Filesystem for Linux5==================================6 7 8.. Note:: This filesystem doesn't have a maintainer.9 10 11HFS stands for ``Hierarchical File System`` and is the filesystem used12by the Mac Plus and all later Macintosh models. Earlier Macintosh13models used MFS (``Macintosh File System``), which is not supported,14MacOS 8.1 and newer support a filesystem called HFS+ that's similar to15HFS but is extended in various areas. Use the hfsplus filesystem driver16to access such filesystems from Linux.17 18 19Mount options20=============21 22When mounting an HFS filesystem, the following options are accepted:23 24 creator=cccc, type=cccc25 Specifies the creator/type values as shown by the MacOS finder26 used for creating new files. Default values: '????'.27 28 uid=n, gid=n29 Specifies the user/group that owns all files on the filesystems.30 Default: user/group id of the mounting process.31 32 dir_umask=n, file_umask=n, umask=n33 Specifies the umask used for all files , all directories or all34 files and directories. Defaults to the umask of the mounting process.35 36 session=n37 Select the CDROM session to mount as HFS filesystem. Defaults to38 leaving that decision to the CDROM driver. This option will fail39 with anything but a CDROM as underlying devices.40 41 part=n42 Select partition number n from the devices. Does only makes43 sense for CDROMS because they can't be partitioned under Linux.44 For disk devices the generic partition parsing code does this45 for us. Defaults to not parsing the partition table at all.46 47 quiet48 Ignore invalid mount options instead of complaining.49 50 51Writing to HFS Filesystems52==========================53 54HFS is not a UNIX filesystem, thus it does not have the usual features you'd55expect:56 57 * You can't modify the set-uid, set-gid, sticky or executable bits or the uid58 and gid of files.59 * You can't create hard- or symlinks, device files, sockets or FIFOs.60 61HFS does on the other have the concepts of multiple forks per file. These62non-standard forks are represented as hidden additional files in the normal63filesystems namespace which is kind of a cludge and makes the semantics for64the a little strange:65 66 * You can't create, delete or rename resource forks of files or the67 Finder's metadata.68 * They are however created (with default values), deleted and renamed69 along with the corresponding data fork or directory.70 * Copying files to a different filesystem will loose those attributes71 that are essential for MacOS to work.72 73 74Creating HFS filesystems75========================76 77The hfsutils package from Robert Leslie contains a program called78hformat that can be used to create HFS filesystem. See79<https://www.mars.org/home/rob/proj/hfs/> for details.80 81 82Credits83=======84 85The HFS drivers was written by Paul H. Hargrovea (hargrove@sccm.Stanford.EDU).86Roman Zippel (roman@ardistech.com) rewrote large parts of the code and brought87in btree routines derived from Brad Boyer's hfsplus driver.88