summaryrefslogtreecommitdiff
path: root/usr/src/man/man8/fsck_pcfs.8
blob: 0f3d18c5e2711f240750e3f2b7116d989993680b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
'\" te
.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH FSCK_PCFS 8 "Jan 28, 2000"
.SH NAME
fsck_pcfs \- file system consistency check and interactive repair
.SH SYNOPSIS
.LP
.nf
\fBfsck\fR \fB-F\fR pcfs [\fIgeneric_options\fR] \fIspecial\fR
.fi

.LP
.nf
\fBfsck\fR \fB-F\fR pcfs [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR] \fIspecial\fR
.fi

.SH DESCRIPTION
.sp
.LP
The \fBfsck\fR utility audits and interactively repairs inconsistent conditions
on file systems. \fIspecial\fR represents the character special device on which
the file system resides, for example \fB/dev/rdiskette\fR. The character
special device, not the block special device, should be used.
.sp
.LP
In the case of correcting serious inconsistencies, by default, \fBfsck\fR asks
for confirmation before making a repair and waits for the operator to respond
either \fByes\fR or \fBno\fR. If the operator does not have write permission on
the file system, \fBfsck\fR defaults to a \fB-n\fR (no corrections) action. See
\fBfsck\fR(8).
.sp
.LP
Repairing some file system inconsistencies may result in loss of data. The
amount and severity of data loss may be determined from the diagnostic output.
.sp
.LP
When executed with the verify option (\fB\fR\fB-o\fR\fB v\fR), \fBfsck_pcfs\fR
automatically scans the entire file system to verify that all of its allocation
units are accessible. If it finds any units inaccessible, it updates the file
allocation table (\fBFAT\fR) appropriately. It also updates any effected
directory entries to reflect the problem. This directory update includes
truncating the file at the point in its allocation chain where the file data is
no longer accessible. Any remaining accessible allocation units become
orphaned.
.sp
.LP
Orphaned chains of accessible allocation units are, with the operator's
concurrence, linked back into the file system as files in the root directory.
These files are assigned names of the form file\fINNNN\fR.chk, where the
\fIN\fRs are digits in the integral range from \fB0\fR through \fB9\fR.
.sp
.LP
After successfully scanning and correcting any errors in the file system,
\fBfsck\fR displays a summary of information about the file system. This
summary includes the size of the file system in bytes, the number of bytes used
in directories and individual files, and the number of available allocation
units remaining in the file system.
.SH OPTIONS
.sp
.ne 2
.na
\fB\fIgeneric_options\fR\fR
.ad
.RS 23n
The following generic options are supported:
.sp
.ne 2
.na
\fB\fB-m\fR\fR
.ad
.RS 11n
Check but do not repair. This option checks that the file system is suitable
for mounting, returning the appropriate exit status. If the file system is
ready for mounting, \fBfsck\fR  displays a message such as:
.sp
.in +2
.nf
pcfs fsck: sanity check:
\fB/dev/rdiskette\fR okay
.fi
.in -2
.sp

.RE

.sp
.ne 2
.na
\fB\fB-n\fR | \fB-N\fR\fR
.ad
.RS 11n
 Assume a no response to  all  questions  asked  by \fBfsck\fR; do not open the
file system for writing.
.RE

.sp
.ne 2
.na
\fB\fB-V\fR\fR
.ad
.RS 11n
Echo the expanded command line, but do not execute  the command. This option
may be used to verify and  to validate the command line.
.RE

.sp
.ne 2
.na
\fB\fB-y\fR | \fB-Y\fR\fR
.ad
.RS 11n
Assume a \fByes\fR response to all  questions  asked  by \fBfsck\fR.
.RE

.RE

.sp
.ne 2
.na
\fB\fB-o\fR \fIspecific_options\fR\fR
.ad
.RS 23n
Specify \fBpcfs\fR file system specific options in a comma-separated list, in
any combination, with no intervening spaces.
.sp
.ne 2
.na
\fBv\fR
.ad
.RS 5n
Verify all allocation units are accessible prior to correcting inconsistencies
in the metadata.
.RE

.sp
.ne 2
.na
\fBp\fR
.ad
.RS 5n
Check and fix the file system non-interactively (\fBpreen\fR).  Exit
immediately if there is a problem requiring intervention.
.RE

.sp
.ne 2
.na
\fBw\fR
.ad
.RS 5n
Check writable file systems only.
.RE

.RE

.SH FILES
.sp
.ne 2
.na
\fB\fIspecial\fR\fR
.ad
.RS 11n
The device which contains the pcfs. The device name for a diskette is specified
as \fB/dev/rdiskette0\fR for the first diskette drive, or \fB/dev/rdiskette1\fR
for a second diskette drive. A hard disk device or high-capacity removable
device name much be qualified with a suffix to indicate the proper \fBFDISK\fR
partition.
.sp
For example, in the names: \fB/dev/rdsk/c0t0d0p0:c\fR and
\fB/dev/rdsk/c0t4d0s2:c\fR, the \fB:c\fR suffix indicates the first partition
on the disk contains the \fBpcfs\fR.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp

.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE
_
Interface Stability	Stable
.TE

.SH SEE ALSO
.sp
.LP
\fBfsck\fR(8), \fBfstyp\fR(8), \fBfdisk\fR(8), \fBmkfs\fR(8),
\fBmkfs_pcfs\fR(8), \fBmountall\fR(8), \fBattributes\fR(7), \fBpcfs\fR(4FS),
.SH WARNINGS
.sp
.LP
The operating system buffers file system data. Running \fBfsck\fR on a mounted
file system can cause the operating system's buffers to become out of date with
respect to the disk. For this reason, the file system should be unmounted when
\fBfsck\fR is used. If this is not possible, care should be taken that the
system is quiescent and that it is rebooted immediately after \fBfsck\fR is
run. Quite often, however, this is not sufficient. A panic will probably occur
if running \fBfsck\fR on a file system modifies the file system.