xref: /netbsd-src/sbin/mount_hfs/mount_hfs.8 (revision b7b7574d3bf8eeb51a1fa3977b59142ec6434a55)
1.\" $NetBSD: mount_hfs.8,v 1.8 2014/03/18 18:20:39 riastradh 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
69The
70.Nm
71command attaches the Apple HFS+ File System on the
72.Ar special
73device on to the file system tree at point
74.Ar node .
75Both
76.Ar special
77and
78.Ar node
79are converted to absolute paths before use.
80.Pp
81This command is normally executed by
82.Xr mount 8
83at boot time.
84The options are as follows:
85.Bl -tag -width Ds
86.It Fl o
87Options are specified with a
88.Fl o
89flag followed by a comma separated string of options.
90See the
91.Xr mount 8
92man page for possible options and their meanings.
93.El
94.Sh NOTES
95Apple disk images
96.Pa ( .dmg
97files) and hybrid CD-ROMs contain multiple partitions with an HFS+
98file system on one of them.
99Use
100.Xr apmlabel 8
101to 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
109The
110.Nm
111utility first appeared in
112.Nx 5.0 .
113.Sh AUTHORS
114.An -nosplit
115.Nm
116was developed by
117.An Yevgeny Binder Aq Mt yevbee@comcast.net
118during the 2005 Google Summer of Code.
119It was improved and imported into
120.Nx
121by
122.An Dieter Baron Aq Mt dillo@NetBSD.org .
123.Sh BUGS
124HFS+ support is still experimental.
125Currently, no write support is present.
126Also, Unicode decomposition is not performed on file names prior to lookup.
127