xref: /freebsd/sbin/fsck_msdosfs/ext.h (revision d9a42747950146bf03cda7f6e25d219253f8a57a)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (C) 1995, 1996, 1997 Wolfgang Solfrank
5  * Copyright (c) 1995 Martin Husemann
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19  * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  *	$NetBSD: ext.h,v 1.6 2000/04/25 23:02:51 jdolecek Exp $
27  * $FreeBSD$
28  */
29 
30 #ifndef EXT_H
31 #define	EXT_H
32 
33 #include <sys/types.h>
34 
35 #include <stdbool.h>
36 
37 #include "dosfs.h"
38 
39 #define	LOSTDIR	"LOST.DIR"
40 
41 /*
42  * Options:
43  */
44 extern int alwaysno;	/* assume "no" for all questions */
45 extern int alwaysyes;	/* assume "yes" for all questions */
46 extern int preen;	/* we are preening */
47 extern int rdonly;	/* device is opened read only (supersedes above) */
48 extern int skipclean;	/* skip clean file systems if preening */
49 extern int allow_mmap;  /* allow the use of mmap() */
50 
51 /*
52  * function declarations
53  */
54 int ask(int, const char *, ...) __printflike(2, 3);
55 
56 /*
57  * Check the dirty flag.  If the file system is clean, then return 1.
58  * Otherwise, return 0 (this includes the case of FAT12 file systems --
59  * they have no dirty flag, so they must be assumed to be unclean).
60  */
61 int checkdirty(int, struct bootblock *);
62 
63 /*
64  * Check file system given as arg
65  */
66 int checkfilesys(const char *);
67 
68 /*
69  * Return values of various functions
70  */
71 #define	FSOK		0		/* Check was OK */
72 #define	FSBOOTMOD	1		/* Boot block was modified */
73 #define	FSDIRMOD	2		/* Some directory was modified */
74 #define	FSFATMOD	4		/* The FAT was modified */
75 #define	FSERROR		8		/* Some unrecovered error remains */
76 #define	FSFATAL		16		/* Some unrecoverable error occurred */
77 #define	FSDIRTY		32		/* File system is dirty */
78 
79 /*
80  * read a boot block in a machine independent fashion and translate
81  * it into our struct bootblock.
82  */
83 int readboot(int, struct bootblock *);
84 
85 /*
86  * Correct the FSInfo block.
87  */
88 int writefsinfo(int, struct bootblock *);
89 
90 /* Opaque type */
91 struct fat_descriptor;
92 
93 int cleardirty(struct fat_descriptor *);
94 
95 void fat_clear_cl_head(struct fat_descriptor *, cl_t);
96 bool fat_is_cl_head(struct fat_descriptor *, cl_t);
97 
98 cl_t fat_get_cl_next(struct fat_descriptor *, cl_t);
99 
100 int fat_set_cl_next(struct fat_descriptor *, cl_t, cl_t);
101 
102 cl_t fat_allocate_cluster(struct fat_descriptor *fat);
103 
104 struct bootblock* fat_get_boot(struct fat_descriptor *);
105 int fat_get_fd(struct fat_descriptor *);
106 bool fat_is_valid_cl(struct fat_descriptor *, cl_t);
107 
108 /*
109  * Read the FAT 0 and return a pointer to the newly allocated
110  * descriptor of it.
111  */
112 int readfat(int, struct bootblock *, struct fat_descriptor **);
113 
114 /*
115  * Write back FAT entries
116  */
117 int writefat(struct fat_descriptor *);
118 
119 /*
120  * Read a directory
121  */
122 int resetDosDirSection(struct fat_descriptor *);
123 void finishDosDirSection(void);
124 int handleDirTree(struct fat_descriptor *);
125 
126 /*
127  * Cross-check routines run after everything is completely in memory
128  */
129 int checkchain(struct fat_descriptor *, cl_t, size_t *);
130 
131 /*
132  * Check for lost cluster chains
133  */
134 int checklost(struct fat_descriptor *);
135 /*
136  * Try to reconnect a lost cluster chain
137  */
138 int reconnect(struct fat_descriptor *, cl_t, size_t);
139 void finishlf(void);
140 
141 /*
142  * Small helper functions
143  */
144 /*
145  * Return the type of a reserved cluster as text
146  */
147 const char *rsrvdcltype(cl_t);
148 
149 /*
150  * Clear a cluster chain in a FAT
151  */
152 void clearchain(struct fat_descriptor *, cl_t);
153 
154 #endif
155