~ubuntu-branches/debian/stretch/jfsutils/stretch

« back to all changes in this revision

Viewing changes to fsck/jfs_fsck.8

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Hornburg (Racke)
  • Date: 2005-01-07 10:12:20 UTC
  • mfrom: (1.2.1 upstream) (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050107101220-ka3f7smw42zysmk1
Tags: 1.1.7-1
* new upstream release (Closes: #289106)
* start synopsis with lowercase

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH jfs_fsck 8 "October 29, 2002" " " "JFS utility - file system check"
 
2
 
 
3
.SH NAME
 
4
.B jfs_fsck 
 
5
\- initiate replay of the JFS transaction log, and check and repair a JFS formatted device
 
6
 
 
7
.SH SYNOPSIS
 
8
.B jfs_fsck 
 
9
[
 
10
.B -afnpvV 
 
11
] [
 
12
.B -j 
 
13
.I journal_device
 
14
] [
 
15
.B --omit_journal_replay
 
16
] [
 
17
.B --replay_journal_only
 
18
]
 
19
.I device
 
20
 
 
21
.SH DESCRIPTION
 
22
.PP
 
23
.B jfs_fsck 
 
24
is used to replay the JFS transaction log, check a JFS formatted device for errors, and fix any
 
25
errors found.  
 
26
.PP
 
27
.I device
 
28
is the special file name corresponding to the actual device to be checked
 
29
.RB (e.g. " /dev/hdb1" ). 
 
30
.PP
 
31
.B jfs_fsck 
 
32
must be run as root.
 
33
 
 
34
.SH WARNING
 
35
.PP
 
36
.B jfs_fsck 
 
37
should only be used to check an 
 
38
.B unmounted 
 
39
file system or a file system that is mounted READ ONLY.  Using 
 
40
.B jfs_fsck 
 
41
to check a file system mounted other than READ ONLY could seriously damage the file system!
 
42
 
 
43
.SH OPTIONS
 
44
.P
 
45
If no options are selected, the default is 
 
46
.BR "\-p".
 
47
.TP
 
48
.B \-a
 
49
Autocheck mode - Replay the transaction log.  Do not continue fsck processing
 
50
unless the aggregate state is dirty or the log replay failed.  Functionally equivalent to 
 
51
.BR "\-p".
 
52
Autocheck mode is typically the default mode used when 
 
53
.B jfs_fsck
 
54
is called at boot time.
 
55
.\" .TP
 
56
.\" .B \-b
 
57
.\" *currently unused* Perform Bad Block List utility processing only.
 
58
.\" .TP
 
59
.\" .B \-c
 
60
.\" After a replay of the transaction log completes successfully, only continue fsck processing if the aggregate state is dirty.
 
61
.TP
 
62
.B \-f
 
63
Replay the transaction log and force checking even if the file system appears clean.  Repair all problems automatically.
 
64
.TP
 
65
.BI \-j " journal_device"
 
66
Specify the journal device.
 
67
.TP
 
68
.B \-n
 
69
Open the file system read only.  Do not replay the transaction log.  Report errors, but do not repair them.
 
70
.TP
 
71
.B \--omit_journal_replay
 
72
Omit the replay of the transaction log.  This option should not be used unless as a last resort (i.e.
 
73
the log has been severely corrupted and replaying it causes further problems).
 
74
.TP
 
75
.B \-p
 
76
Automatically repair ("preen") the file system.  Replay the transaction log.  Do not continue fsck processing
 
77
unless the aggregate state is dirty or the log replay failed.  Functionally equivalent to 
 
78
.BR "\-a".
 
79
.TP
 
80
.B \--replay_journal_only
 
81
Only replay the transaction log.  Do not continue with a full file system check if the replay fails or
 
82
if the file system is still dirty even after a journal replay.  In general, this option should only be
 
83
used for debugging purposes as it could leave the file system in an unmountable state.  This option
 
84
cannot be used with
 
85
.BR -f ","
 
86
.BR -n ", or"
 
87
.BR --omit_journal_replay "."
 
88
.TP
 
89
.B \-v
 
90
Verbose messaging - print details and debug statements to stdout.
 
91
.TP
 
92
.B \-V
 
93
Print version information and exit (regardless of any other chosen options).
 
94
.SH EXAMPLES
 
95
.LP
 
96
Check the 3rd partition on the 2nd hard disk, print extended information to stdout, replay the transaction log, 
 
97
force complete jfs_fsck checking, and give permission to repair all errors:
 
98
.IP
 
99
.B jfs_fsck \-v \-f /dev/hdb3
 
100
.IP
 
101
.LP
 
102
Check the 5th partition on the 1st hard disk, and report, but do not repair, any errors:
 
103
.IP
 
104
.B jfs_fsck \-n /dev/hda5
 
105
.IP
 
106
 
 
107
.SH EXIT CODE
 
108
.P
 
109
The exit code returned by
 
110
.B jfs_fsck
 
111
represents one of the following conditions:
 
112
.TP
 
113
.B \ 0
 
114
No errors
 
115
.TP
 
116
.B \ 1
 
117
File system errors corrected and/or transaction log replayed successfully
 
118
.TP
 
119
.B \ 2
 
120
File system errors corrected, system should be rebooted if file system was mounted
 
121
.TP
 
122
.B \ 4
 
123
File system errors left uncorrected
 
124
.TP
 
125
.B \ 8
 
126
Operational error
 
127
.TP
 
128
.B \ 16
 
129
Usage or syntax error
 
130
.TP
 
131
.B \ 128
 
132
Shared library error
 
133
 
 
134
.SH "REPORTING BUGS"
 
135
.PP
 
136
If you find a bug in 
 
137
.B JFS 
 
138
or 
 
139
.BR jfs_fsck ,
 
140
please report it via the bug tracking system ("Report Bugs" section) of the JFS project web site:
 
141
.nf
 
142
http://oss.software.ibm.com/jfs
 
143
.fi
 
144
.PP
 
145
Please send as much pertinent information as possible, including the complete output of running 
 
146
.B jfs_fsck 
 
147
with the 
 
148
.B \-v
 
149
option on the JFS device.
 
150
 
 
151
.SH SEE ALSO
 
152
.BR fsck (8),
 
153
.BR jfs_mkfs (8),
 
154
.BR jfs_fscklog (8),
 
155
.BR jfs_tune (8),
 
156
.BR jfs_logdump (8),
 
157
.BR jfs_debugfs (8)
 
158
 
 
159
.SH AUTHORS
 
160
.nf
 
161
Barry Arndt  (barndt@us.ibm.com)
 
162
William Braswell, Jr.
 
163
 
 
164
.fi
 
165
.B jfs_fsck 
 
166
is maintained by IBM.
 
167
.nf
 
168
See the JFS project web site for more details:
 
169
http://oss.software.ibm.com/jfs
 
170
.fi