xref: /netbsd-src/sbin/fsck_udf/fsck_udf.8 (revision 3eb96a9ee8c8a0984c37f3aa7ebde552c77a43e4)
1*3eb96a9eSwiz.\"	$NetBSD: fsck_udf.8,v 1.2 2022/04/06 13:41:13 wiz Exp $
2f41dcb03Sreinoud.\"
3f41dcb03Sreinoud.\" Copyright (C) 2022 Reinoud Zandijk
4f41dcb03Sreinoud.\" Based on fsck_msdos(8) by
5f41dcb03Sreinoud.\"     Copyright (C) 1995 Wolfgang Solfrank
6f41dcb03Sreinoud.\"     Copyright (c) 1995 Martin Husemann
7f41dcb03Sreinoud.\"
8f41dcb03Sreinoud.\" Redistribution and use in source and binary forms, with or without
9f41dcb03Sreinoud.\" modification, are permitted provided that the following conditions
10f41dcb03Sreinoud.\" are met:
11f41dcb03Sreinoud.\" 1. Redistributions of source code must retain the above copyright
12f41dcb03Sreinoud.\"    notice, this list of conditions and the following disclaimer.
13f41dcb03Sreinoud.\" 2. Redistributions in binary form must reproduce the above copyright
14f41dcb03Sreinoud.\"    notice, this list of conditions and the following disclaimer in the
15f41dcb03Sreinoud.\"    documentation and/or other materials provided with the distribution.
16f41dcb03Sreinoud.\"
17f41dcb03Sreinoud.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
18f41dcb03Sreinoud.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19f41dcb03Sreinoud.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20f41dcb03Sreinoud.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
21f41dcb03Sreinoud.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22f41dcb03Sreinoud.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23f41dcb03Sreinoud.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24f41dcb03Sreinoud.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25f41dcb03Sreinoud.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26f41dcb03Sreinoud.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27f41dcb03Sreinoud.\"
28f41dcb03Sreinoud.\"
29f41dcb03Sreinoud.Dd February 6, 2022
30f41dcb03Sreinoud.Dt FSCK_UDF 8
31f41dcb03Sreinoud.Os
32f41dcb03Sreinoud.Sh NAME
33f41dcb03Sreinoud.Nm fsck_udf
34f41dcb03Sreinoud.Nd Universal Disk Format file system consistency checker
35f41dcb03Sreinoud.Sh SYNOPSIS
36f41dcb03Sreinoud.Nm
37f41dcb03Sreinoud.Fl p
38f41dcb03Sreinoud.Op Fl fH
39f41dcb03Sreinoud.Ar file system ...
40f41dcb03Sreinoud.Nm
41*3eb96a9eSwiz.Op Fl fHnSsy
42f41dcb03Sreinoud.Ar file system ...
43f41dcb03Sreinoud.Sh DESCRIPTION
44f41dcb03SreinoudThe
45f41dcb03Sreinoud.Nm
46f41dcb03Sreinoudutility verifies and repairs
47f41dcb03Sreinoud.Tn Universal Disk Format
48f41dcb03Sreinoudfile systems (more commonly known as
49f41dcb03Sreinoud.Tn UDF
50f41dcb03Sreinoudfile systems).
51f41dcb03Sreinoud.Pp
52f41dcb03SreinoudThe first form of
53f41dcb03Sreinoud.Nm
54f41dcb03Sreinoudpreens the specified file systems.
55f41dcb03SreinoudIt is normally started by
56f41dcb03Sreinoud.Xr fsck 8
57f41dcb03Sreinoudrun from
58f41dcb03Sreinoud.Pa /etc/rc
59f41dcb03Sreinoudduring automatic reboot, when an UDF file system is detected.
60f41dcb03SreinoudWhen preening file systems,
61f41dcb03Sreinoud.Nm
62f41dcb03Sreinoudwill fix common inconsistencies non-interactively.
63f41dcb03SreinoudIf more serious problems are found,
64f41dcb03Sreinoud.Nm
65f41dcb03Sreinouddoes not try to fix them, indicates that it was not
66f41dcb03Sreinoudsuccessful, and exits.
67f41dcb03Sreinoud.Pp
68f41dcb03SreinoudThe second form of
69f41dcb03Sreinoud.Nm
70f41dcb03Sreinoudchecks the specified file systems and tries to repair all
71f41dcb03Sreinouddetected inconsistencies, requesting confirmation before
72f41dcb03Sreinoudmaking any changes.
73f41dcb03Sreinoud.Pp
74f41dcb03SreinoudThe options are as follows:
75f41dcb03Sreinoud.Bl -tag -width XXXoptions
76f41dcb03Sreinoud.It Fl f
77f41dcb03SreinoudForce detailed checking even when file system is marked closed.
78*3eb96a9eSwiz.It Fl H
79*3eb96a9eSwizEnables heuristic repair options repairing known corruptions in the wild
80*3eb96a9eSwizcaused by bugs.
81f41dcb03Sreinoud.It Fl n
82f41dcb03SreinoudCauses
83f41dcb03Sreinoud.Nm
84*3eb96a9eSwizto assume no as the answer to all operator questions.
85f41dcb03Sreinoud.It Fl p
86f41dcb03SreinoudPreen the specified file systems.
87*3eb96a9eSwiz.It Fl S
88*3eb96a9eSwizCauses
89*3eb96a9eSwiz.Nm
90*3eb96a9eSwizto scan for older VAT tables on recordable media.
91*3eb96a9eSwizThis allows older snapshots of the file system on recordable media to
92*3eb96a9eSwizbe recovered.
93*3eb96a9eSwiz.It Fl s Ar session
94*3eb96a9eSwizSelect session
95*3eb96a9eSwiz.Ar session
96*3eb96a9eSwizto be checked on recordable media.
97*3eb96a9eSwizThis allows older sessions of the file system on recordable media to
98*3eb96a9eSwizbe recovered.
99f41dcb03Sreinoud.It Fl y
100f41dcb03SreinoudCauses
101f41dcb03Sreinoud.Nm
102f41dcb03Sreinoudto assume yes as the answer to all operator questions.
103f41dcb03Sreinoud.El
104f41dcb03Sreinoud.Sh SEE ALSO
105f41dcb03Sreinoud.Xr fsck 8 ,
106f41dcb03Sreinoud.Xr fsck_ffs 8 ,
107f41dcb03Sreinoud.Xr mount_udf 8
108f41dcb03Sreinoud.Sh HISTORY
109f41dcb03SreinoudA
110f41dcb03Sreinoud.Nm
111f41dcb03Sreinoudutility appeared in
112f41dcb03Sreinoud.Nx 10.0 .
113f41dcb03Sreinoud.Sh BUGS
114f41dcb03Sreinoud.Nm
115*3eb96a9eSwizis still under construction.
116*3eb96a9eSwizNot all possible reparations are implemented.
117