1FSCK_HFS(8) BSD System Manager's Manual FSCK_HFS(8)
2
4 fsck.hfsplus — HFS file system consistency check
5
7 fsck.hfsplus -q [-df] special ...
8 fsck.hfsplus -p [-df] special ...
9 fsck.hfsplus [-n | -y | -r] [-dfgl] [-m mode] special ...
10
12 The fsck.hfsplus utility verifies and repairs standard HFS and HFS+ file
13 systems.
14
15 The first form of fsck.hfsplus quickly checks the specified file systems
16 to determine whether they were cleanly unmounted.
17
18 The second form of fsck.hfsplus preens the specified file systems. It is
19 normally started by fsck(8) run from /etc/rc.boot during automatic
20 reboot, when a HFS file system is detected. When preening file systems,
21 fsck.hfsplus will fix common inconsistencies for file systems that were
22 not unmounted cleanly. If more serious problems are found, fsck.hfsplus
23 does not try to fix them, indicates that it was not successful, and
24 exits.
25
26 The third form of fsck.hfsplus checks the specified file systems and
27 tries to repair all detected inconsistencies.
28
29 If no options are specified fsck.hfsplus will always check and attempt to
30 fix the specified file systems.
31
32 The options are as follows:
33
34 -d Display debugging information. This option may provide
35 useful information when fsck.hfsplus cannot repair a dam‐
36 aged file system.
37
38 -f When used with the -p option, force fsck.hfsplus to check
39 `clean' file systems, otherwise it means force fsck.hfsplus
40 to check and repair journaled HFS+ file systems.
41
42 -g Causes fsck.hfsplus to generate it's output strings in GUI
43 format. This option is used when another application with
44 a graphical user interface (like Mac OS X Disk Utility) is
45 envoking the fsck.hfsplus tool.
46
47 -l Lock down the file system and perform a test-only check.
48 This makes it possible to check a file system that is cur‐
49 rently mounted, although no repairs can be made.
50
51 -m mode Mode is an octal number that will be used to set the per‐
52 missions for the lost+found directory when it is created.
53 The lost+found directory is only created when a volume is
54 repaired and orphaned files or directories are detected.
55 fsck.hfsplus places orphaned files and directories into the
56 lost+found directory (located at the root of the volume).
57 The default mode is 01777.
58
59 -p Preen the specified file systems.
60
61 -q Causes fsck.hfsplus to quickly check whether the volume was
62 unmounted cleanly. If the volume was unmounted cleanly,
63 then the exit status is 0. If the volume was not unmounted
64 cleanly, then the exit status will be non-zero. In either
65 case, a message is printed to standard output describing
66 whether the volume was clean or dirty.
67
68 -y Always attempt to repair any damage that is found.
69
70 -n Never attempt to repair any damage that is found.
71
72 -r Rebuild the catalog file on the specified file system.
73 This option currently will only work if there is enough
74 contiguous space on the specified file system for a new
75 catalog file and if there is no damage to the leaf nodes in
76 the existing catalog file.
77
78 Because of inconsistencies between the block device and the buffer cache,
79 the raw device should always be used.
80
82 fsck(8)
83
85 fsck.hfsplus is not able to fix some inconsistencies that it detects.
86
88 The fsck.hfsplus command appeared in Mac OS X Server 1.0 .
89
90Mac OS X November 21, 2002 Mac OS X