Commit 5040a0ac authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Jonathan Corbet

docs: filesystems: convert hfs.txt to ReST

- Add a SPDX header;
- Adjust document and section titles;
- Use notes markups;
- Add lists markups;
- Add it to filesystems/index.rst.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/8a625d6652d88809730020048d26c3b9333ddbdf.1581955849.git.mchehab+huawei@kernel.orgSigned-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent cdded7db
Note: This filesystem doesn't have a maintainer. .. SPDX-License-Identifier: GPL-2.0
==================================
Macintosh HFS Filesystem for Linux Macintosh HFS Filesystem for Linux
================================== ==================================
HFS stands for ``Hierarchical File System'' and is the filesystem used
.. Note:: This filesystem doesn't have a maintainer.
HFS stands for ``Hierarchical File System`` and is the filesystem used
by the Mac Plus and all later Macintosh models. Earlier Macintosh by the Mac Plus and all later Macintosh models. Earlier Macintosh
models used MFS (``Macintosh File System''), which is not supported, models used MFS (``Macintosh File System``), which is not supported,
MacOS 8.1 and newer support a filesystem called HFS+ that's similar to MacOS 8.1 and newer support a filesystem called HFS+ that's similar to
HFS but is extended in various areas. Use the hfsplus filesystem driver HFS but is extended in various areas. Use the hfsplus filesystem driver
to access such filesystems from Linux. to access such filesystems from Linux.
...@@ -49,25 +54,25 @@ Writing to HFS Filesystems ...@@ -49,25 +54,25 @@ Writing to HFS Filesystems
HFS is not a UNIX filesystem, thus it does not have the usual features you'd HFS is not a UNIX filesystem, thus it does not have the usual features you'd
expect: expect:
o You can't modify the set-uid, set-gid, sticky or executable bits or the uid * You can't modify the set-uid, set-gid, sticky or executable bits or the uid
and gid of files. and gid of files.
o You can't create hard- or symlinks, device files, sockets or FIFOs. * You can't create hard- or symlinks, device files, sockets or FIFOs.
HFS does on the other have the concepts of multiple forks per file. These HFS does on the other have the concepts of multiple forks per file. These
non-standard forks are represented as hidden additional files in the normal non-standard forks are represented as hidden additional files in the normal
filesystems namespace which is kind of a cludge and makes the semantics for filesystems namespace which is kind of a cludge and makes the semantics for
the a little strange: the a little strange:
o You can't create, delete or rename resource forks of files or the * You can't create, delete or rename resource forks of files or the
Finder's metadata. Finder's metadata.
o They are however created (with default values), deleted and renamed * They are however created (with default values), deleted and renamed
along with the corresponding data fork or directory. along with the corresponding data fork or directory.
o Copying files to a different filesystem will loose those attributes * Copying files to a different filesystem will loose those attributes
that are essential for MacOS to work. that are essential for MacOS to work.
Creating HFS filesystems Creating HFS filesystems
=================================== ========================
The hfsutils package from Robert Leslie contains a program called The hfsutils package from Robert Leslie contains a program called
hformat that can be used to create HFS filesystem. See hformat that can be used to create HFS filesystem. See
......
...@@ -67,6 +67,7 @@ Documentation for filesystem implementations. ...@@ -67,6 +67,7 @@ Documentation for filesystem implementations.
f2fs f2fs
gfs2 gfs2
gfs2-uevents gfs2-uevents
hfs
hfsplus hfsplus
fuse fuse
overlayfs overlayfs
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment