hfs_util/hfs.util.8

   1 .\""Copyright (c) 2001-2008 Apple Inc. All Rights Reserved.
   2 .\"The contents of this file constitute Original Code as defined in and are
   3 .\"subject to the Apple Public Source License Version 1.2 (the 'License').
   4 .\"You may not use this file except in compliance with the
   5 .\"License. Please obtain a copy of the License at
   6 .\"http://www.apple.com/publicsource and read it before using this file.
   7 .\"
   8 .\"This Original Code and all software distributed under the License are
   9 .\"distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  10 .\"EXPRESS OR IMPLIED, AND APPLE
  11 .\"HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY
  12 .\"WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
  13 .\"QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  14 .\"specific language governing rights and limitations under the License."
  15 .Dd July 16, 2003
  16 .Dt HFS.UTIL 8
  17 .Os Darwin
  18 .Sh NAME
  19 .Nm hfs.util
  20 .Nd HFS/HFS+ file system utility
  21 .Sh SYNOPSIS
  22 .Nm
  23 .Fl m
  24 .Ar device  mountpoint
  25 .Op Ar mountflag1
  26 .Op Ar mountflag2
  27 .Op Ar mountflag3
  28 .Op Ar mountflag4
  29 .Pp
  30 .Nm
  31 .Fl p
  32 .Ar device
  33 .Op Ar mountflag1
  34 .Op Ar mountflag2
  35 .Op Ar mountflag3
  36 .Op Ar mountflag4
  37 .Pp
  38 .Nm
  39 .Fl J
  40 .Op Ar size
  41 .Ar mountpoint
  42 .Pp
  43 .Nm
  44 .Fl U
  45 .Ar mountpoint
  46 .Pp
  47 .Nm
  48 .Fl N
  49 .Ar device
  50 .Pp
  51 .Nm
  52 .Fl I
  53 .Ar mountpoint
  54 .Pp
  55 .Nm
  56 .Op Fl aksu
  57 .Ar device
  58 .Sh DESCRIPTION
  59 The
  60 .Nm
  61 command supports the mounting, probing, and unmounting of HFS file systems.
  62 .Pp
  63 Options:
  64 .Bl -tag -compact -offset indent
  65 .It Fl a
  66 Adopt permissions for the HFS file system at
  67 .Ar device
  68 .It Fl I
  69 Print out status information about the journal on the HFS
  70 file system at
  71 .Ar mountpoint
  72 .It Fl J Op Ar size
  73 Enable journaling on the HFS file system mounted on
  74 .Ar mountpoint .
  75 An optional size may
  76 be specified (e.g. 32M for a 32 megabyte journal).
  77 .It Fl k
  78 Get the UUID key for the HFS file system at
  79 .Ar device .
  80 .It Fl m
  81 Mount the HFS file system located on
  82 .Ar device
  83 onto
  84 .Ar mountpoint
  85 with the flags
  86 .Ar mountflag1 mountflag2 mountflag3 mountflag4
  87 .It Fl M
  88 Force mount the HFS file system located on
  89 .Ar device
  90 onto
  91 .Ar mountpoint
  92 with the flags
  93 .Ar mountflag1 mountflag2 mountflag3 mountflag4 .
  94 This is a deprecated option.
  95 .It Fl N
  96 Disable journaling on a HFS+ file system located at
  97 .Ar device
  98 .It Fl p
  99 Probe the
 100 .Ar device
 101 for an HFS file system using the flags
 102 .Ar mountflag1 mountflag2 mountflag3 mountflag4
 103 .It Fl s
 104 Set the UUID key (generates a new UUID value) for the
 105 HFS file system at
 106 .Ar device
 107 .It Fl u
 108 Unmount the HFS file system located at
 109 .Ar device
 110 .It Fl U
 111 Disable journaling on the HFS+ file system mounted on
 112 .Ar mountpoint
 113 .El
 114 .Pp
 115 The
 116 .Ar mountflags
 117 referenced above are either:
 118 .Bl -bullet -compact -offset indent
 119 .It
 120 .Ar removable
 121 or
 122 .Ar fixed
 123 .It
 124 .Ar readonly
 125 or
 126 .Ar writeable
 127 .It
 128 .Ar suid
 129 or
 130 .Ar nosuid
 131 .It
 132 .Ar dev
 133 or
 134 .Ar nodev
 135 .El
 136 .Pp
 137 Note that for the
 138 .Ar device
 139 references above, you must only supply the last component of the path to the
 140 device in question, such as disk0s2 rather than /dev/disk0s2.
 141 .Sh SEE ALSO
 142 .Xr diskarbitrationd 8
 143 .Sh HISTORY
 144 Derived from the Openstep Workspace Manager file system utility programs.