sbin/mount_hfs/mount_hfs.8

   1 .\" $NetBSD: mount_hfs.8,v 1.5 2007/05/19 14:21:36 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 2004, 2007 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .\"
  28 .\" Copyright (c) 1993, 1994
  29 .\"     The Regents of the University of California.  All rights reserved.
  30 .\"
  31 .\" This code is derived from software donated to Berkeley by
  32 .\" Christopher G. Demetriou.
  33 .\"
  34 .\" Redistribution and use in source and binary forms, with or without
  35 .\" modification, are permitted provided that the following conditions
  36 .\" are met:
  37 .\" 1. Redistributions of source code must retain the above copyright
  38 .\"    notice, this list of conditions and the following disclaimer.
  39 .\" 2. Redistributions in binary form must reproduce the above copyright
  40 .\"    notice, this list of conditions and the following disclaimer in the
  41 .\"    documentation and/or other materials provided with the distribution.
  42 .\" 3. Neither the name of the University nor the names of its contributors
  43 .\"    may be used to endorse or promote products derived from this software
  44 .\"    without specific prior written permission.
  45 .\"
  46 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  47 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  48 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  49 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  50 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  51 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  52 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  53 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  54 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  55 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  56 .\" SUCH DAMAGE.
  57 .\"
  58 .Dd May 19, 2007
  59 .Dt MOUNT_HFS 8
  60 .Os
  61 .Sh NAME
  62 .Nm mount_hfs
  63 .Nd mount an Apple HFS+ File System
  64 .Sh SYNOPSIS
  65 .Nm
  66 .Op Fl o Ar options
  67 .Ar special node
  68 .Sh DESCRIPTION
  69 The
  70 .Nm
  71 command attaches the Apple HFS+ File System on the
  72 .Ar special
  73 device on to the file system tree at point
  74 .Ar node .
  75 Both
  76 .Ar special
  77 and
  78 .Ar node
  79 are converted to absolute paths before use.
  80 .Pp
  81 This command is normally executed by
  82 .Xr mount 8
  83 at boot time.
  84 The options are as follows:
  85 .Bl -tag -width Ds
  86 .It Fl o
  87 Options are specified with a
  88 .Fl o
  89 flag followed by a comma separated string of options.
  90 See the
  91 .Xr mount 8
  92 man page for possible options and their meanings.
  93 .El
  94 .Sh NOTES
  95 Apple disk images
  96 .Pa ( .dmg
  97 files) and hybrid CD-ROMs contain multiple partitions with an HFS+
  98 file system on one of them.
  99 Use
 100 .Xr apmlabel 8
 101 to enter it into the disklabel and mount the resulting partition.
 102 .Sh SEE ALSO
 103 .Xr mount 2 ,
 104 .Xr unmount 2 ,
 105 .Xr fstab 5 ,
 106 .Xr apmlabel 8 ,
 107 .Xr mount 8
 108 .Sh HISTORY
 109 The
 110 .Nm
 111 utility first appeared in
 112 .Nx 5.0 .
 113 .Sh AUTHORS
 114 .An -nosplit
 115 .Nm
 116 was developed by
 117 .An Yevgeny Binder Aq yevbee@comcast.net
 118 during the 2005 Google Summer of Code.
 119 It was improved and imported into
 120 .Nx
 121 by
 122 .An Dieter Baron Aq dillo@NetBSD.org .
 123 .Sh BUGS
 124 HFS+ support is still experimental.
 125 Currently, no write support is present.
 126 Also, Unicode decomposition is not performed on file names prior to lookup.