xref: /freebsd/sbin/fsck_msdosfs/ext.h (revision 6d49b0c0e7b8b77d8043593356e712307e894743)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
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  */
28 
29 #ifndef EXT_H
30 #define	EXT_H
31 
32 #include <sys/types.h>
33 
34 #include <stdbool.h>
35 
36 #include "dosfs.h"
37 
38 #define	LOSTDIR	"LOST.DIR"
39 
40 /*
41  * Options:
42  */
43 extern int alwaysno;	/* assume "no" for all questions */
44 extern int alwaysyes;	/* assume "yes" for all questions */
45 extern int preen;	/* we are preening */
46 extern int rdonly;	/* device is opened read only (supersedes above) */
47 extern int skipclean;	/* skip clean file systems if preening */
48 extern int allow_mmap;  /* allow the use of mmap() */
49 
50 /*
51  * function declarations
52  */
53 int ask(int, const char *, ...) __printflike(2, 3);
54 
55 /*
56  * Check the dirty flag.  If the file system is clean, then return 1.
57  * Otherwise, return 0 (this includes the case of FAT12 file systems --
58  * they have no dirty flag, so they must be assumed to be unclean).
59  */
60 int checkdirty(int, struct bootblock *);
61 
62 /*
63  * Check file system given as arg
64  */
65 int checkfilesys(const char *);
66 
67 /*
68  * Return values of various functions
69  */
70 #define	FSOK		0		/* Check was OK */
71 #define	FSBOOTMOD	1		/* Boot block was modified */
72 #define	FSDIRMOD	2		/* Some directory was modified */
73 #define	FSFATMOD	4		/* The FAT was modified */
74 #define	FSERROR		8		/* Some unrecovered error remains */
75 #define	FSFATAL		16		/* Some unrecoverable error occurred */
76 #define	FSDIRTY		32		/* File system is dirty */
77 
78 /*
79  * read a boot block in a machine independent fashion and translate
80  * it into our struct bootblock.
81  */
82 int readboot(int, struct bootblock *);
83 
84 /*
85  * Correct the FSInfo block.
86  */
87 int writefsinfo(int, struct bootblock *);
88 
89 /* Opaque type */
90 struct fat_descriptor;
91 
92 int cleardirty(struct fat_descriptor *);
93 
94 void fat_clear_cl_head(struct fat_descriptor *, cl_t);
95 bool fat_is_cl_head(struct fat_descriptor *, cl_t);
96 
97 cl_t fat_get_cl_next(struct fat_descriptor *, cl_t);
98 
99 int fat_set_cl_next(struct fat_descriptor *, cl_t, cl_t);
100 
101 cl_t fat_allocate_cluster(struct fat_descriptor *fat);
102 
103 struct bootblock* fat_get_boot(struct fat_descriptor *);
104 int fat_get_fd(struct fat_descriptor *);
105 bool fat_is_valid_cl(struct fat_descriptor *, cl_t);
106 
107 /*
108  * Read the FAT 0 and return a pointer to the newly allocated
109  * descriptor of it.
110  */
111 int readfat(int, struct bootblock *, struct fat_descriptor **);
112 void releasefat(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