mount_hfs/mount_hfs.8

   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.