Macintosh HFS Filesystem for Linux

HFS 계보와 mount option

이 Linux HFS filesystem에는 현재 maintainer가 없습니다.

HFS는 `Hierarchical File System`의 약자이며 Mac Plus와 그 이후의 모든 Macintosh model이 사용한 filesystem입니다.

더 이른 Macintosh model은 MFS(`Macintosh File System`)를 사용했으며 Linux HFS driver는 MFS를 지원하지 않습니다.

MacOS 8.1 이후에는 HFS와 비슷하지만 여러 영역이 확장된 HFS+도 지원합니다. Linux에서 HFS+ filesystem에 접근할 때는 별도의 `hfsplus` filesystem driver를 사용해야 합니다.

HFS mount 시에는 새 파일의 Finder 속성, Linux에서 보이는 소유권·권한, CD-ROM session·partition 선택, 잘못된 option 처리 방식을 지정할 수 있습니다.

`creator=cccc`와 `type=cccc`는 새 파일을 만들 때 MacOS Finder가 표시할 네 문자 creator/type 값을 지정합니다. 두 값의 default는 `'????'`입니다.

`uid=n`과 `gid=n`은 filesystem의 모든 파일을 소유하는 user와 group을 지정합니다. default는 mount를 수행한 process의 user ID와 group ID입니다.

`dir_umask=n`은 모든 directory, `file_umask=n`은 모든 file, `umask=n`은 file과 directory 모두에 적용할 umask를 지정합니다. default는 mount process의 umask입니다.

`session=n`은 HFS로 mount할 CD-ROM session을 선택합니다. default는 CD-ROM driver가 결정하게 두는 것이며, 기반 device가 CD-ROM이 아니면 이 option은 실패합니다.

`part=n`은 device에서 partition number `n`을 선택합니다. Linux에서 CD-ROM을 일반 disk처럼 partition할 수 없기 때문에 CD-ROM에서만 의미가 있습니다.

disk device는 generic partition parsing code가 partition 선택을 대신 처리합니다. `part`의 default 동작은 partition table을 전혀 해석하지 않는 것입니다.

`quiet`는 유효하지 않은 mount option을 오류로 보고하지 않고 무시하게 합니다.

.. SPDX-License-Identifier: GPL-2.0

==================================
Macintosh HFS Filesystem for Linux
==================================


.. 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
models used MFS (``Macintosh File System``), which is not supported,
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
to access such filesystems from Linux.


Mount options
=============

When mounting an HFS filesystem, the following options are accepted:

  creator=cccc, type=cccc
        Specifies the creator/type values as shown by the MacOS finder
        used for creating new files.  Default values: '????'.

  uid=n, gid=n
          Specifies the user/group that owns all files on the filesystems.
        Default:  user/group id of the mounting process.

  dir_umask=n, file_umask=n, umask=n
        Specifies the umask used for all files , all directories or all
        files and directories.  Defaults to the umask of the mounting process.

  session=n
          Select the CDROM session to mount as HFS filesystem.  Defaults to
        leaving that decision to the CDROM driver.  This option will fail
        with anything but a CDROM as underlying devices.

  part=n
          Select partition number n from the devices.  Does only makes
        sense for CDROMS because they can't be partitioned under Linux.
        For disk devices the generic partition parsing code does this
        for us.  Defaults to not parsing the partition table at all.

  quiet
          Ignore invalid mount options instead of complaining.

쓰기 제약과 resource fork semantics

HFS는 UNIX filesystem이 아니므로 일반적인 UNIX filesystem 기능을 모두 제공하지 않습니다.

파일의 set-uid, set-gid, sticky, executable bit를 변경할 수 없으며 file의 `uid`와 `gid`도 개별적으로 변경할 수 없습니다. mount option으로 정한 공통 소유권과 권한 표현을 사용합니다.

hard link와 symbolic link를 만들 수 없고 device file, socket, FIFO도 생성할 수 없습니다.

반면 HFS에는 파일 하나가 여러 fork를 갖는 개념이 있습니다. Linux HFS driver는 표준 data fork가 아닌 추가 fork를 일반 filesystem namespace의 숨김 추가 파일로 나타냅니다.

원문은 이 mapping을 다소 임시방편적인 구조라고 설명합니다. HFS의 fork model을 UNIX namespace에 투영하기 때문에 일부 operation의 semantics가 낯설게 보입니다.

resource fork와 Finder metadata를 개별적으로 생성·삭제·rename할 수는 없습니다.

대신 대응하는 data fork 또는 directory를 생성하면 default 값을 가진 resource fork와 Finder metadata도 함께 생성됩니다. data fork나 directory를 삭제하거나 rename할 때도 함께 삭제·rename됩니다.

파일을 다른 filesystem으로 복사하면 이 추가 속성이 사라질 수 있습니다. 이 속성은 MacOS가 해당 파일을 올바르게 사용하는 데 필수적일 수 있으므로 단순 data copy만으로는 의미가 온전히 보존되지 않습니다.

Writing to HFS Filesystems
==========================

HFS is not a UNIX filesystem, thus it does not have the usual features you'd
expect:

 * You can't modify the set-uid, set-gid, sticky or executable bits or the uid
   and gid of files.
 * 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
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
the a little strange:

 * You can't create, delete or rename resource forks of files or the
   Finder's metadata.
 * They are however created (with default values), deleted and renamed
   along with the corresponding data fork or directory.
 * Copying files to a different filesystem will loose those attributes
   that are essential for MacOS to work.

HFS 생성 도구와 driver credits

Robert Leslie의 `hfsutils` package에는 HFS filesystem을 생성하는 `hformat` program이 포함되어 있습니다.

`hformat`과 `hfsutils`의 자세한 내용은 `https://www.mars.org/home/rob/proj/hfs/`에서 확인할 수 있다고 원문은 안내합니다.

HFS driver는 Paul H. Hargrove가 작성했습니다. 원문의 이름 표기는 `Paul H. Hargrovea`이고 연락처는 `[email protected]`입니다.

Roman Zippel(`[email protected]`)은 code의 큰 부분을 다시 작성하고 Brad Boyer의 `hfsplus` driver에서 유래한 btree routine을 도입했습니다.

Creating HFS filesystems
========================

The hfsutils package from Robert Leslie contains a program called
hformat that can be used to create HFS filesystem. See
<https://www.mars.org/home/rob/proj/hfs/> for details.


Credits
=======

The HFS drivers was written by Paul H. Hargrovea ([email protected]).
Roman Zippel ([email protected]) rewrote large parts of the code and brought
in btree routines derived from Brad Boyer's hfsplus driver.