[apple/hfs.git] / mount_hfs / mount_hfs.8

.\" Copyright (c) 2002 Apple Computer, Inc. All rights reserved.
.\" 
.\" The contents of this file constitute Original Code as defined in and
.\" are subject to the Apple Public Source License Version 1.1 (the
.\" "License").  You may not use this file except in compliance with the
.\" License.  Please obtain a copy of the License at
.\" http://www.apple.com/publicsource and read it before using this file.
.\" 
.\" This Original Code and all software distributed under the License are
.\" distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
.\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
.\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
.\" License for the specific language governing rights and limitations
.\" under the License.
.\" 
.\"     @(#)mount_hfs.8
.Dd March 14, 2001
.Dt MOUNT_HFS 8
.Os "Mac OS X"
.Sh NAME
.Nm mount_hfs
.Nd mount an HFS/HFS+ file system
.Sh SYNOPSIS
.Nm mount_hfs
.Op Fl e Ar encoding
.Op Fl u Ar user
.Op Fl g Ar group
.Op Fl m Ar mask
.Op Fl o Ar options
.Op Fl j
.Op Fl w
.Op Fl x
.Ar special 
.Ar directory
.Sh DESCRIPTION
The
.Nm mount_hfs
command attaches the HFS file system residing on the device
.Pa special
to the global file system namespace at the location indicated by
.Pa directory .
This command is normally executed by
.Xr mount 8
at boot time.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl e Ar encoding (standard HFS volumes only)
Specify the Macintosh encoding. The following encodings are supported:
.Pp
Arabic, ChineseSimp, ChineseTrad, Croatian, Cyrillic, Greek, Hebrew,
Icelandic, Japanese, Korean, Roman (default), Romanian, Thai, Turkish
.It Fl u Ar user
Set the owner of the files in the file system to
.Pa user . 
The default owner is the owner of the directory on which
the file system is being mounted.
The
.Pa user
may be a user-name, or a numeric value.
.It Fl g Ar group
Set the group of the files in the file system to
.Pa group . 
The default group is the group of the directory on which
the file system is being mounted.
The
.Pa group
may be a group-name, or a numeric value.
.It Fl m Ar mask
Specify the maximum file permissions for files in the file system.
(For example, a
.Pa mask
of 755 specifies that, by default, the owner should have read, write,
and execute permissions for files, but others should only have read
and execute permissions.  See chmod(1) for more information about
octal file modes.)  Only the nine low-order bits of
.Pa mask
are used.  The default
.Pa mask
is taken from the directory on which the file system is being mounted.
.It Fl o
Options are specified with a
.Fl o
flag followed by a comma separated string of options.
See the
.Xr mount 8
man page for possible options and their meanings.
.It Fl j
Ignore the journal for this mount.
.It Fl w
Mount the HFS wrapper volume.
.It Fl x
Disable execute permissions on a standard HFS file system.
.El
.Sh SEE ALSO
.Xr mount 2 ,
.Xr unmount 2 ,
.Xr fstab 5 ,
.Xr mount 8
.Sh BUGS
Some HFS file systems with highly fragmented catalog files may not mount.
.Sh HISTORY
The
.Nm mount_hfs
utility first appeared in Mac OS X Server 1.0.
Commit	Line	Data
51e135ce A	1	.\" Copyright (c) 2002 Apple Computer, Inc. All rights reserved.
	2	.\"
	3	.\" The contents of this file constitute Original Code as defined in and
	4	.\" are subject to the Apple Public Source License Version 1.1 (the
	5	.\" "License"). You may not use this file except in compliance with the
	6	.\" License. Please obtain a copy of the License at
	7	.\" http://www.apple.com/publicsource and read it before using this file.
	8	.\"
	9	.\" This Original Code and all software distributed under the License are
	10	.\" distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	11	.\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	12	.\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	13	.\" FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	14	.\" License for the specific language governing rights and limitations
	15	.\" under the License.
	16	.\"
	17	.\" @(#)mount_hfs.8
	18	.Dd March 14, 2001
	19	.Dt MOUNT_HFS 8
	20	.Os "Mac OS X"
	21	.Sh NAME
	22	.Nm mount_hfs
	23	.Nd mount an HFS/HFS+ file system
	24	.Sh SYNOPSIS
	25	.Nm mount_hfs
	26	.Op Fl e Ar encoding
	27	.Op Fl u Ar user
	28	.Op Fl g Ar group
	29	.Op Fl m Ar mask
	30	.Op Fl o Ar options
	31	.Op Fl j
	32	.Op Fl w
	33	.Op Fl x
	34	.Ar special
	35	.Ar directory
	36	.Sh DESCRIPTION
	37	The
	38	.Nm mount_hfs
	39	command attaches the HFS file system residing on the device
	40	.Pa special
	41	to the global file system namespace at the location indicated by
	42	.Pa directory .
	43	This command is normally executed by
	44	.Xr mount 8
	45	at boot time.
	46	.Pp
	47	The options are as follows:
	48	.Bl -tag -width indent
	49	.It Fl e Ar encoding (standard HFS volumes only)
	50	Specify the Macintosh encoding. The following encodings are supported:
	51	.Pp
	52	Arabic, ChineseSimp, ChineseTrad, Croatian, Cyrillic, Greek, Hebrew,
	53	Icelandic, Japanese, Korean, Roman (default), Romanian, Thai, Turkish
	54	.It Fl u Ar user
	55	Set the owner of the files in the file system to
	56	.Pa user .
	57	The default owner is the owner of the directory on which
	58	the file system is being mounted.
	59	The
	60	.Pa user
	61	may be a user-name, or a numeric value.
	62	.It Fl g Ar group
	63	Set the group of the files in the file system to
	64	.Pa group .
65	The default group is the group of the directory on which
66	the file system is being mounted.
67	The
68	.Pa group
69	may be a group-name, or a numeric value.
70	.It Fl m Ar mask
71	Specify the maximum file permissions for files in the file system.
72	(For example, a
73	.Pa mask
74	of 755 specifies that, by default, the owner should have read, write,
75	and execute permissions for files, but others should only have read
76	and execute permissions. See chmod(1) for more information about
77	octal file modes.) Only the nine low-order bits of
78	.Pa mask
79	are used. The default
80	.Pa mask
81	is taken from the directory on which the file system is being mounted.
82	.It Fl o
83	Options are specified with a
84	.Fl o
85	flag followed by a comma separated string of options.
86	See the
87	.Xr mount 8
88	man page for possible options and their meanings.
89	.It Fl j
90	Ignore the journal for this mount.
91	.It Fl w
92	Mount the HFS wrapper volume.
93	.It Fl x
94	Disable execute permissions on a standard HFS file system.
95	.El
96	.Sh SEE ALSO
97	.Xr mount 2 ,
98	.Xr unmount 2 ,
99	.Xr fstab 5 ,
100	.Xr mount 8
101	.Sh BUGS
102	Some HFS file systems with highly fragmented catalog files may not mount.
103	.Sh HISTORY
104	The
105	.Nm mount_hfs
106	utility first appeared in Mac OS X Server 1.0.