← Back to branch summary

~ubuntu-branches/ubuntu/trusty/hfsprogs/trusty-proposed

« back to all changes in this revision

Viewing changes to .pc/0013-Fix-manpages.patch/fsck_hfs.tproj/fsck_hfs.8

  • Committer: Package Import Robot
  • Author(s): Rogério Brito
  • Date: 2013-10-24 01:20:15 UTC
  • Revision ID: package-import@ubuntu.com-20131024012015-qsncxmr4cielybvz
Tags: 332.25-11
http://bugs.debian.org/724195
* debian/control: Remove DMUA flag.
* debian/rules: Override rules for which we don't have makefiles.
  (Closes: #724195)
* debian/patches:
  + Change the headers to be friendlier with gbp pq.
  + Remove unreferenced patches in series file.
  + Coalesce all patches touching man pages into one.
  + Regenerate everything from patch-queue branch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
.pc/0013-Fix-manpages.patch/fsck_hfs.tproj/fsck_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
.\"     @(#)fsck_hfs.8
 
18
.Dd November 21, 2002
 
19
.Dt FSCK_HFS 8
 
20
.Os "Mac OS X"
 
21
.Sh NAME
 
22
.Nm fsck_hfs
 
23
.Nd HFS file system consistency check
 
24
.Sh SYNOPSIS
 
25
.Nm fsck_hfs
 
26
.Fl q
 
27
.Op Fl df
 
28
.Ar special ...
 
29
.Nm fsck_hfs
 
30
.Fl p
 
31
.Op Fl df
 
32
.Ar special ...
 
33
.Nm fsck_hfs
 
34
.Op Fl n | y | r
 
35
.Op Fl dfgl
 
36
.Op Fl m Ar mode
 
37
.Op Fl c Ar size
 
38
.Ar special ...
 
39
.Sh DESCRIPTION
 
40
.Pp
 
41
The
 
42
.Nm
 
43
utility verifies and repairs standard HFS and HFS+ file systems.
 
44
.Pp
 
45
The first form of
 
46
.Nm
 
47
quickly checks the specified file systems to determine whether
 
48
they were cleanly unmounted.
 
49
.Pp
 
50
The second form of
 
51
.Nm
 
52
preens the specified file systems.
 
53
It is normally started by
 
54
.Xr fsck 8
 
55
run from
 
56
.Pa /etc/rc.boot
 
57
during automatic reboot, when a HFS file system is detected.
 
58
When preening file systems,
 
59
.Nm
 
60
will fix common inconsistencies for file systems that were not
 
61
unmounted cleanly.
 
62
If more serious problems are found,
 
63
.Nm
 
64
does not try to fix them, indicates that it was not
 
65
successful, and exits.
 
66
.Pp
 
67
The third form of
 
68
.Nm
 
69
checks the specified file systems and tries to repair all
 
70
detected inconsistencies.
 
71
.Pp
 
72
If no options are specified 
 
73
.Nm
 
74
will always check and attempt to fix the specified file systems.
 
75
.Pp
 
76
The options are as follows:
 
77
.Bl -hang -offset indent
 
78
.It Fl c Ar size
 
79
Specify the
 
80
.Ar size 
 
81
of the cache used by  
 
82
.Nm
 
83
internally.  Bigger 
 
84
.Ar size 
 
85
can result in better performance but can result in deadlock when
 
86
used with 
 
87
.Fl l 
 
88
option.  Size can be specified as a decimal, octal, or 
 
89
hexadecimal number.  If the number ends with a ``k'', ``m'', 
 
90
or ``g'', the number is multiplied by 1024 (1K), 1048576 (1M),
 
91
or 1073741824 (1G), respectively.  
 
92
.It Fl d
 
93
Display debugging information.
 
94
This option may provide useful information when 
 
95
.Nm
 
96
cannot repair a damaged file system.
 
97
.It Fl f
 
98
When used with the
 
99
.Fl p
 
100
option, force
 
101
.Nm
 
102
to check `clean' file systems, otherwise it means force
 
103
.Nm
 
104
to check and repair journaled HFS+ file systems.
 
105
.It Fl g
 
106
Causes
 
107
.Nm
 
108
to generate it's output strings in GUI format.
 
109
This option is used when another application with a graphical user interface
 
110
(like Mac OS X Disk Utility) is envoking the
 
111
.Nm
 
112
tool.
 
113
.It Fl l
 
114
Lock down the file system and perform a test-only check.
 
115
This makes it possible to check a file system that is currently mounted,
 
116
although no repairs can be made.
 
117
.It Fl m Ar mode
 
118
Mode is an octal number that will be used to set the permissions for the
 
119
lost+found directory when it is created.
 
120
The lost+found directory is only created when a volume is repaired and orphaned
 
121
files or directories are detected.
 
122
.Nm
 
123
places orphaned files and directories into the lost+found directory (located
 
124
at the root of the volume).
 
125
The default mode is 01777.
 
126
.It Fl p
 
127
Preen the specified file systems.
 
128
.It Fl q
 
129
Causes
 
130
.Nm
 
131
to quickly check whether the volume was unmounted cleanly.
 
132
If the volume was unmounted cleanly, then the exit status is 0.
 
133
If the volume was not unmounted cleanly, then the exit status will be non-zero.
 
134
In either case, a message is printed to standard output describing whether the
 
135
volume was clean or dirty.
 
136
.It Fl y
 
137
Always attempt to repair any damage that is found.
 
138
.It Fl n
 
139
Never attempt to repair any damage that is found.
 
140
.It Fl r
 
141
Rebuild the catalog file on the specified file system.
 
142
This option currently will only work if there is enough contiguous space on the
 
143
specified file system for a new catalog file and if there is no damage 
 
144
to the leaf nodes in the existing catalog file.
 
145
.El
 
146
.Pp
 
147
Because of inconsistencies between the block device and the buffer cache,
 
148
the raw device should always be used.
 
149
.Sh SEE ALSO
 
150
.Xr fsck 8
 
151
.Sh BUGS
 
152
.Nm
 
153
is not able to fix some inconsistencies that it detects.
 
154
.Sh HISTORY
 
155
The
 
156
.Nm
 
157
command appeared in Mac OS X Server 1.0 .