added a lot of printk output to ease writing of emulator

[linux-2.4.21-pre4.git] / fs / hfs / FAQ.txt

  Frequently Asked Questions about the HFS filesystem for
  Linux
  Paul H. Hargrove, hargrove@sccm.Stanford.EDU
  version 1.0.3, 27 Apr 1997

  This document provides answers to some of the most frequently asked
  questions about the HFS filesystem for Linux.  It is currently pretty
  rough and totally unorganized.  Corrections, additions and clarifica-
  tions are appreciated.  The most current version of this document is
  kept on The HFS for Linux Page <http://www-sccm.Stanford.EDU/~har-
  grove/HFS/>.
  ______________________________________________________________________

  Table of Contents:

  1.      What is this FAQ about?

  2.      What is HFS?

  3.      How I mount AppleShare volumes?

  4.      What is the current version of the HFS filesystem.

  5.      How stable is the current version?

  6.      Is there a mailing list for discussion of the HFS filesystem?

  7.      What version of Linux do I need to be running?

  8.      Will it run on my (your processor type here)?

  9.      Will it run under (your non-Linux operating system here)?

  10.     Why can I mount some HFS CDROMs but not others?

  11.     What does ``only 1024-char blocks implemented (512)'' mean?

  12.     Why do I get a message about a bad or unknown partition table?

  13.     Can I mount multiple HFS partitions from the same Macintosh
  disk?

  14.     In what ways can I write to HFS filesystems?

  15.     Does the HFS filesystem work with 400 kB or 800 kB Macintosh
  diskettes?

  16.     How can I format an HFS filesystem?

  17.     How can I fsck an HFS filesystem?

  18.     Why do I get ``error -50'' messages from my Mac when using
  netatalk?

  19.     Why does my Macintosh show generic application and document
  icons?

  20.     How owns all the copyrights and trademarks? ;-)

  20.1.   This Document

  20.2.   The Software

  20.3.   Trademarks
  ______________________________________________________________________

  1\b1.\b.  W\bWh\bha\bat\bt i\bis\bs t\bth\bhi\bis\bs F\bFA\bAQ\bQ a\bab\bbo\bou\but\bt?\b?

  This FAQ is about the HFS filesystem for Linux, which is available in
  two forms.  The stand-alone version (called hfs_fs) is a Linux kernel
  loadable module implementing the Macintosh HFS filesystem.  The HFS
  filesystem is also included in some distributions of the Linux kernel
  source (in the directory linux/fs/hfs).  This version can be compiled
  as a loadable module or compiled into the kernel.

  Either version allows a machine running Linux to read and write disks
  from a Macintosh (almost) as though they were native Linux disks.

  2\b2.\b.  W\bWh\bha\bat\bt i\bis\bs H\bHF\bFS\bS?\b?

  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.

  3\b3.\b.  H\bHo\bow\bw I\bI m\bmo\bou\bun\bnt\bt A\bAp\bpp\bpl\ble\beS\bSh\bha\bar\bre\be v\bvo\bol\blu\bum\bme\bes\bs?\b?

  The HFS filesystem is for mounting local filesystems only.  There is
  an experimental afpfs by Ben Hekster heksterb@acm.org available from
  http://www.odyssey.co.il/~heksterb/Software/afpfs/.

  4\b4.\b.  W\bWh\bha\bat\bt i\bis\bs t\bth\bhe\be c\bcu\bur\brr\bre\ben\bnt\bt v\bve\ber\brs\bsi\bio\bon\bn o\bof\bf t\bth\bhe\be H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bm.\b.

  As of version 1.0.3 of this FAQ, version 0.95 is the most recent.  You
  can always find the most recent version on The HFS for Linux Page
  <http://www-sccm.Stanford.EDU/~hargrove/HFS/>.  Announcements of new
  versions are made to the comp.os.linux.announce newsgroup.

  5\b5.\b.  H\bHo\bow\bw s\bst\bta\bab\bbl\ble\be i\bis\bs t\bth\bhe\be c\bcu\bur\brr\bre\ben\bnt\bt v\bve\ber\brs\bsi\bio\bon\bn?\b?

  Version 0.95 is considered to be ``beta'' software, so I recommend
  making backups of anything important before you start playing.  It is
  relatively free of bugs due to lots of testing of the previous
  releases.

  After a suitable period without new bugs the I will consider the
  software to be ``stable'' and the version number will jump to 1.0.

  6\b6.\b.  I\bIs\bs t\bth\bhe\ber\bre\be a\ba m\bma\bai\bil\bli\bin\bng\bg l\bli\bis\bst\bt f\bfo\bor\br d\bdi\bis\bsc\bcu\bus\bss\bsi\bio\bon\bn o\bof\bf t\bth\bhe\be H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bm?\b?

  There is no mailing list devoted exclusively to the HFS filesystem.
  However, announcements of new versions are posted to the ``linux-
  atalk'' and ``hfs-interest'' lists.  I will see bug reports sent to
  those lists but e-mail is more reliable (hargrove@sccm.Stanford.EDU).

  To subscribe to hfs-interest send e-mail with a body of ``subscribe
  hfs-interest (your e-mail address)'' to majordomo@ccs.neu.edu.

  To subscribe to linux-atalk send e-mail with a body of ``SUBSCRIBE
  LINUX-ATALK (Your full name)'' to listserv@netspace.org.

  7\b7.\b.  W\bWh\bha\bat\bt v\bve\ber\brs\bsi\bio\bon\bn o\bof\bf L\bLi\bin\bnu\bux\bx d\bdo\bo I\bI n\bne\bee\bed\bd t\bto\bo b\bbe\be r\bru\bun\bnn\bni\bin\bng\bg?\b?

  To compile and use the stand-alone distribution of the HFS filesystem
  you will need Linux kernel version 2.0.1 or newer compiled with
  modules enabled (CONFIG_MODULES).  To compile you will need the kernel
  headers which match the kernel you are running.  This is covered in
  more detail in the installation instructions in INSTALL.txt.

  If your kernel came with HFS in the kernel source tree then HFS should
  work with your Linux version.  There may be small problems with a few
  of the development kernel releases.  For these releases check the HFS
  for Linux Page <http://www-sccm.Stanford.EDU/~hargrove/HFS/> for
  patches.

  8\b8.\b.  W\bWi\bil\bll\bl i\bit\bt r\bru\bun\bn o\bon\bn m\bmy\by (\b(y\byo\bou\bur\br p\bpr\bro\boc\bce\bes\bss\bso\bor\br t\bty\byp\bpe\be h\bhe\ber\bre\be)\b)?\b?

  The code is carefully written to be independent of your processor's
  word size and byte-order, so if your machine runs Linux it can run the
  HFS filesystem.  However some younger ports don't yet have support for
  loadable modules.

  Note that HFS is tested most extensively on Intel platforms.  So there
  could be subtle compilation problems on other platforms.  If you
  encounter any that are not addressed by the documentation then please
  let me know.

  9\b9.\b.  W\bWi\bil\bll\bl i\bit\bt r\bru\bun\bn u\bun\bnd\bde\ber\br (\b(y\byo\bou\bur\br n\bno\bon\bn-\b-L\bLi\bin\bnu\bux\bx o\bop\bpe\ber\bra\bat\bti\bin\bng\bg s\bsy\bys\bst\bte\bem\bm h\bhe\ber\bre\be)\b)?\b?

  No.  There is a port in progress to NetBSD.  I know of no other active
  porting attempts.  If you are interested in porting the HFS filesystem
  to another Unix-like operating system, I am interested in providing
  what guidance I can.

  1\b10\b0.\b.  W\bWh\bhy\by c\bca\ban\bn I\bI m\bmo\bou\bun\bnt\bt s\bso\bom\bme\be H\bHF\bFS\bS C\bCD\bDR\bRO\bOM\bMs\bs b\bbu\but\bt n\bno\bot\bt o\bot\bth\bhe\ber\brs\bs?\b?

  In the past there was a known incompatibility with some ``hybrid''
  CDROMs that appear as HFS disks on Macs and as ISO9660 disks on other
  systems.  I think I have fixed the problem.  So, if you encounter this
  particular problem or have problems with specific non-hybrid CDROMs
  please e-mail me with the title and manufacturer of the CD.

  1\b11\b1.\b.  W\bWh\bha\bat\bt d\bdo\boe\bes\bs `\b``\b`o\bon\bnl\bly\by 1\b10\b02\b24\b4-\b-c\bch\bha\bar\br b\bbl\blo\boc\bck\bks\bs i\bim\bmp\bpl\ble\bem\bme\ben\bnt\bte\bed\bd (\b(5\b51\b12\b2)\b)'\b''\b' m\bme\bea\ban\bn?\b?

  This message comes from the kernel and indicates that an attempt was
  made to read a 512-byte block from a device that doesn't support
  512-byte blocks.  The HFS filesystem only works with 512-byte blocks,
  and therefore doesn't function with these devices.  Eventually it may
  be able to use 1024-byte (or even 2048-byte) blocks when necessary.
  Ideally the device driver should be enhanced to support 512-byte
  blocks so that the various filesystems which need 512-byte blocks
  don't each need to work around it.

  1\b12\b2.\b.  W\bWh\bhy\by d\bdo\bo I\bI g\bge\bet\bt a\ba m\bme\bes\bss\bsa\bag\bge\be a\bab\bbo\bou\but\bt a\ba b\bba\bad\bd o\bor\br u\bun\bnk\bkn\bno\bow\bwn\bn p\bpa\bar\brt\bti\bit\bti\bio\bon\bn t\bta\bab\bbl\ble\be?\b?

  If your Linux kernel doesn't understand Macintosh partition tables it
  gives this warning when it can't find a partition table it recognizes.
  To support partitioned media with such kernels, decoding of Mac
  partition tables is done by the HFS filesystem so you should still be
  able to mount the disk.  However, to do so you will need to mount the
  raw device (such as /dev/sdb instead of /dev/sdb4) and use the part
  mount option to indicate which partition you want.

  1\b13\b3.\b.  C\bCa\ban\bn I\bI m\bmo\bou\bun\bnt\bt m\bmu\bul\blt\bti\bip\bpl\ble\be H\bHF\bFS\bS p\bpa\bar\brt\bti\bit\bti\bio\bon\bns\bs f\bfr\bro\bom\bm t\bth\bhe\be s\bsa\bam\bme\be M\bMa\bac\bci\bin\bnt\bto\bos\bsh\bh d\bdi\bis\bsk\bk?\b?

  Only if your kernel understands Macintosh partition tables.  It the
  kernel doesn't understand the Macintosh partition table, the HFS
  filesystem must access the raw device.  Therefore, the kernel thinks
  the entire drive is in use and prevents additional mounts on it.

  1\b14\b4.\b.  I\bIn\bn w\bwh\bha\bat\bt w\bwa\bay\bys\bs c\bca\ban\bn I\bI w\bwr\bri\bit\bte\be t\bto\bo H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bms\bs?\b?

  The HFS filesystem is as capable as the MS-DOS or VFAT filesystems,
  except that certain things can only be done with a file's data fork.

  You c\bca\ban\bn:

  +\bo  Create, delete and rename directories and data forks of files with
     the caveat that names are case insensitive (so foo and Foo are the
     same file or directory).

  +\bo  Run Linux executables or shared libraries on an HFS disk if they
     are stored in the data fork of a file.

  +\bo  Read, write and truncate both forks of files and the Finder's
     metadata of files and directories.

  +\bo  Mmap data forks of files (and the resource fork if the filesystem
     is mounted with the fork=cap option).

  +\bo  Toggle the 'w' permission bits (as a group) of data forks.

  +\bo  Change the i_mtime of files and directories.

  You c\bca\ban\bnn\bno\bot\bt:

  +\bo  Create, delete or rename resource forks of files or the Finder's
     metadata.  Note, however, that they are created (with defaults
     values), deleted and renamed along with the corresponding data fork
     or directory.

  +\bo  Run Linux executables or shared libraries on an HFS disk if they
     are stored in the resource fork of a file.

  +\bo  Mmap the Finder's metadata (when fork=cap) or AppleDouble header
     files (when fork=double or fork=netatalk).

  +\bo  Change permissions on directories.

  +\bo  Change the uid or gid of files or directories.

  +\bo  Set the set-uid, set-gid or sticky permission bits.

  +\bo  Create multiple links to files.

  +\bo  Create symlinks, device files, sockets or FIFOs.

  1\b15\b5.\b.  D\bDo\boe\bes\bs t\bth\bhe\be H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bm w\bwo\bor\brk\bk w\bwi\bit\bth\bh 4\b40\b00\b0k\bk o\bor\br 8\b80\b00\b0k\bk M\bMa\bac\bci\bin\bnt\bto\bos\bsh\bh
  d\bdi\bis\bsk\bke\bet\btt\bte\bes\bs?\b?

  Yes and no.  The software is fully capable of dealing with HFS disks
  of any size.  However, the 400k and 800k diskettes are written in a
  physical format that is incompatible with most non-Macintosh floppy
  drives.  Note also that almost all 400k Macintosh diskettes are MFS,
  not HFS.

  1\b16\b6.\b.  H\bHo\bow\bw c\bca\ban\bn I\bI f\bfo\bor\brm\bma\bat\bt a\ban\bn H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bm?\b?

  Robert Leslie (rob@mars.org) has written a package for working with
  HFS filesystems (like mtools plus a graphical interface).  One program
  in the package is hformat which can format HFS filesystems.  The
  latest version can be found on the HFS Utilities home page
  <http://www.mars.org/home/rob/proj/hfs/>.

  1\b17\b7.\b.  H\bHo\bow\bw c\bca\ban\bn I\bI f\bfs\bsc\bck\bk a\ban\bn H\bHF\bFS\bS f\bfi\bil\ble\bes\bsy\bys\bst\bte\bem\bm?\b?

  Right now you'll have to use a Macintosh to do this.  However, Rob
  Leslie is working on an fsck for HFS filesystems.

  1\b18\b8.\b.  W\bWh\bhy\by d\bdo\bo I\bI g\bge\bet\bt `\b``\b`e\ber\brr\bro\bor\br -\b-5\b50\b0'\b''\b' m\bme\bes\bss\bsa\bag\bge\bes\bs f\bfr\bro\bom\bm m\bmy\by M\bMa\bac\bc w\bwh\bhe\ben\bn u\bus\bsi\bin\bng\bg
  n\bne\bet\bta\bat\bta\bal\blk\bk?\b?

  To be compatible with netatalk's afpd you will need to use netatalk
  version 1.4b1 or newer and mount the HFS filesystem with the ``afpd''
  mount option.  More information is provided in the ``afpd'' subsection
  of the ``Mount Options'' section of the HFS documentation (HFS.txt if
  you have the stand-alone HFS distribution or
  linux/Documentation/filesystems/hfs.txt if HFS is in your kernel
  source tree.)

  1\b19\b9.\b.  W\bWh\bhy\by d\bdo\boe\bes\bs m\bmy\by M\bMa\bac\bci\bin\bnt\bto\bos\bsh\bh s\bsh\bho\bow\bw g\bge\ben\bne\ber\bri\bic\bc a\bap\bpp\bpl\bli\bic\bca\bat\bti\bio\bon\bn a\ban\bnd\bd d\bdo\boc\bcu\bum\bme\ben\bnt\bt
  i\bic\bco\bon\bns\bs?\b?

  When using the ``afpd'' mount option the Desktop database on the disk
  is not made available to Netatalk's afpd.  Because of this mounting an
  HFS filesystem across the network to a Macintosh may result in the
  Finder showing generic application and document icons.  Additionally
  double clicking on a document will fail to start the correct
  application.

  If the disk is writable you can make Netatalk build a new Desktop
  database in its own format by holding down the Option key while
  selecting the volume in the Chooser.  If the disk is not writable then
  these problems can be worked around by copying the application to a
  local disk on the Macintosh.

  2\b20\b0.\b.  H\bHo\bow\bw o\bow\bwn\bns\bs a\bal\bll\bl t\bth\bhe\be c\bco\bop\bpy\byr\bri\big\bgh\bht\bts\bs a\ban\bnd\bd t\btr\bra\bad\bde\bem\bma\bar\brk\bks\bs?\b? ;\b;-\b-)\b)

  2\b20\b0.\b.1\b1.\b.  T\bTh\bhi\bis\bs D\bDo\boc\bcu\bum\bme\ben\bnt\bt

  This document is Copyright (c) 1996, 1997 by Paul H. Hargrove.

  Permission is granted to make and distribute verbatim copies of this
  document provided the copyright notice and this permission notice are
  preserved on all copies.

  Permission is granted to copy and distribute modified versions of this
  document under the conditions for verbatim copies above, provided a
  notice clearly stating that the document is a modified version is also
  included in the modified document.

  Permission is granted to copy and distribute translations of this
  document into another language, under the conditions specified above
  for modified versions.

  Permission is granted to convert this document into another media
  under the conditions specified above for modified versions provided
  the requirement to acknowledge the source document is fulfilled by
  inclusion of an obvious reference to the source document in the new
  media. Where there is any doubt as to what defines ``obvious'' the
  copyright owner reserves the right to decide.

  2\b20\b0.\b.2\b2.\b.  T\bTh\bhe\be S\bSo\bof\bft\btw\bwa\bar\bre\be

  The HFS filesystem software is Copyright (c) 1994-1997 by Paul H.
  Hargrove.

  The software is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2, or (at your option)
  any later version.

  The software is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with the software in the file ``COPYING''; if not, write to the
  Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  USA.

  2\b20\b0.\b.3\b3.\b.  T\bTr\bra\bad\bde\bem\bma\bar\brk\bks\bs

  +\bo  ``Finder'' is a trademark of Apple Computer, Inc.

  +\bo  ``Apple'', ``AppleShare'', and ``Macintosh'' are registered
     trademarks of Apple Computer, Inc.

  +\bo  ``MS-DOS'' is a registered trademarks of Microsoft Corporation.

  +\bo  All other trademarks are the property of their respective owners.