NAME¶
fsck.hfs
—
HFS file system consistency check
SYNOPSIS¶
fsck.hfs |
-q
[-df ]
special ... |
fsck.hfs |
-p
[-df ]
special ... |
fsck.hfs |
[ -n |
-y |
-r ]
[-dfgl ]
[-m
mode ]
[-c
size ]
special ... |
DESCRIPTION¶
The
fsck.hfs
utility verifies and repairs
standard HFS and HFS+ file systems.
The first form of
fsck.hfs
quickly checks the
specified file systems to determine whether they were cleanly unmounted.
The second form of
fsck.hfs
preens the
specified file systems. It is normally started by
fsck(8) during systen boot, when a HFS file
system is detected. When preening file systems,
fsck.hfs
will fix common inconsistencies
for file systems that were not unmounted cleanly. If more serious problems are
found,
fsck.hfs
does not try to fix them,
indicates that it was not successful, and exits.
The third form of
fsck.hfs
checks the
specified file systems and tries to repair all detected inconsistencies.
If no options are specified
fsck.hfs
will
always check and attempt to fix the specified file systems.
The options are as follows:
-c
size
- Specify the size of the cache used by
fsck.hfs
internally. Bigger
size can result in better performance but
can result in deadlock when used with
-l
option. Size can be specified as a
decimal, octal, or hexadecimal number. If the number ends with a ``k'',
``m'', or ``g'', the number is multiplied by 1024 (1K), 1048576 (1M), or
1073741824 (1G), respectively.
-d
- Display debugging information. This option may provide useful information
when
fsck.hfs
cannot repair a damaged
file system.
-f
- When used with the
-p
option, force
fsck.hfs
to check `clean' file systems,
otherwise it means force fsck.hfs
to
check and repair journaled HFS+ file systems.
-g
- Causes
fsck.hfs
to generate its output
strings in GUI format. This option is used when another application with a
graphical user interface (like Mac OS X Disk Utility) is invoking the
fsck.hfs
tool.
-l
- Lock down the file system and perform a test-only check. This makes it
possible to check a file system that is currently mounted, although no
repairs can be made.
-m
mode
- Mode is an octal number that will be used to set the permissions for the
lost+found directory when it is created. The lost+found directory is only
created when a volume is repaired and orphaned files or directories are
detected.
fsck.hfs
places orphaned
files and directories into the lost+found directory (located at the root
of the volume). The default mode is 01777.
-p
- Preen the specified file systems.
-q
- Causes
fsck.hfs
to quickly check
whether the volume was unmounted cleanly. If the volume was unmounted
cleanly, then the exit status is 0. If the volume was not unmounted
cleanly, then the exit status will be non-zero. In either case, a message
is printed to standard output describing whether the volume was clean or
dirty.
-y
- Always attempt to repair any damage that is found.
-n
- Never attempt to repair any damage that is found.
-r
- Rebuild the catalog file on the specified file system. This option
currently will only work if there is enough contiguous space on the
specified file system for a new catalog file and if there is no damage to
the leaf nodes in the existing catalog file.
SEE ALSO¶
fsck(8)
BUGS¶
fsck.hfs
is not able to fix some
inconsistencies that it detects.
HISTORY¶
The
fsck.hfs
command appeared in Mac OS X
Server 1.0 .