75e3597abb
check hash to cylinder groups. If a check hash fails when a cylinder
group is read, no further allocations are attempted in that cylinder
group until it has been fixed by fsck. This avoids a class of
filesystem panics related to corrupted cylinder group maps. The
hash is done using crc32c.
Check hases are added only to UFS2 and not to UFS1 as UFS1 is primarily
used in embedded systems with small memories and low-powered processors
which need as light-weight a filesystem as possible.
Specifics of the changes:
sys/sys/buf.h:
Add BX_FSPRIV to reserve a set of eight b_xflags that may be used
by individual filesystems for their own purpose. Their specific
definitions are found in the header files for each filesystem
that uses them. Also add fields to struct buf as noted below.
sys/kern/vfs_bio.c:
It is only necessary to compute a check hash for a cylinder
group when it is actually read from disk. When calling bread,
you do not know whether the buffer was found in the cache or
read. So a new flag (GB_CKHASH) and a pointer to a function to
perform the hash has been added to breadn_flags to say that the
function should be called to calculate a hash if the data has
been read. The check hash is placed in b_ckhash and the B_CKHASH
flag is set to indicate that a read was done and a check hash
calculated. Though a rather elaborate mechanism, it should
also work for check hashing other metadata in the future. A
kernel internal API change was to change breada into a static
fucntion and add flags and a function pointer to a check-hash
function.
sys/ufs/ffs/fs.h:
Add flags for types of check hashes; stored in a new word in the
superblock. Define corresponding BX_ flags for the different types
of check hashes. Add a check hash word in the cylinder group.
sys/ufs/ffs/ffs_alloc.c:
In ffs_getcg do the dance with breadn_flags to get a check hash and
if one is provided, check it.
sys/ufs/ffs/ffs_vfsops.c:
Copy across the BX_FFSTYPES flags in background writes.
Update the check hash when writing out buffers that need them.
sys/ufs/ffs/ffs_snapshot.c:
Recompute check hash when updating snapshot cylinder groups.
sys/libkern/crc32.c:
lib/libufs/Makefile:
lib/libufs/libufs.h:
lib/libufs/cgroup.c:
Include libkern/crc32.c in libufs and use it to compute check
hashes when updating cylinder groups.
Four utilities are affected:
sbin/newfs/mkfs.c:
Add the check hashes when building the cylinder groups.
sbin/fsck_ffs/fsck.h:
sbin/fsck_ffs/fsutil.c:
Verify and update check hashes when checking and writing cylinder groups.
sbin/fsck_ffs/pass5.c:
Offer to add check hashes to existing filesystems.
Precompute check hashes when rebuilding cylinder group
(although this will be done when it is written in fsutil.c
it is necessary to do it early before comparing with the old
cylinder group)
sbin/dumpfs/dumpfs.c
Print out the new check hash flag(s)
sbin/fsdb/Makefile:
Needs to add libufs now used by pass5.c imported from fsck_ffs.
Reviewed by: kib
Tested by: Peter Holm (pho)
155 lines
4.2 KiB
C
155 lines
4.2 KiB
C
/*
|
|
* Copyright (c) 2002 Juli Mallett. All rights reserved.
|
|
*
|
|
* This software was written by Juli Mallett <jmallett@FreeBSD.org> for the
|
|
* FreeBSD project. Redistribution and use in source and binary forms, with
|
|
* or without modification, are permitted provided that the following
|
|
* conditions are met:
|
|
*
|
|
* 1. Redistribution of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistribution in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
|
|
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef __LIBUFS_H__
|
|
#define __LIBUFS_H__
|
|
|
|
/*
|
|
* libufs structures.
|
|
*/
|
|
|
|
/*
|
|
* userland ufs disk.
|
|
*/
|
|
struct uufsd {
|
|
const char *d_name; /* disk name */
|
|
int d_ufs; /* decimal UFS version */
|
|
int d_fd; /* raw device file descriptor */
|
|
long d_bsize; /* device bsize */
|
|
ufs2_daddr_t d_sblock; /* superblock location */
|
|
struct csum *d_sbcsum; /* Superblock summary info */
|
|
caddr_t d_inoblock; /* inode block */
|
|
uint32_t d_inomin; /* low inode (not ino_t for ABI compat) */
|
|
uint32_t d_inomax; /* high inode (not ino_t for ABI compat) */
|
|
union {
|
|
struct fs d_fs; /* filesystem information */
|
|
char d_sb[MAXBSIZE];
|
|
/* superblock as buffer */
|
|
} d_sbunion;
|
|
union {
|
|
struct cg d_cg; /* cylinder group */
|
|
char d_buf[MAXBSIZE];
|
|
/* cylinder group storage */
|
|
} d_cgunion;
|
|
int d_ccg; /* current cylinder group */
|
|
int d_lcg; /* last cylinder group (in d_cg) */
|
|
const char *d_error; /* human readable disk error */
|
|
int d_mine; /* internal flags */
|
|
#define d_fs d_sbunion.d_fs
|
|
#define d_sb d_sbunion.d_sb
|
|
#define d_cg d_cgunion.d_cg
|
|
};
|
|
|
|
/*
|
|
* libufs macros (internal, non-exported).
|
|
*/
|
|
#ifdef _LIBUFS
|
|
/*
|
|
* Trace steps through libufs, to be used at entry and erroneous return.
|
|
*/
|
|
static inline void
|
|
ERROR(struct uufsd *u, const char *str)
|
|
{
|
|
|
|
#ifdef _LIBUFS_DEBUGGING
|
|
if (str != NULL) {
|
|
fprintf(stderr, "libufs: %s", str);
|
|
if (errno != 0)
|
|
fprintf(stderr, ": %s", strerror(errno));
|
|
fprintf(stderr, "\n");
|
|
}
|
|
#endif
|
|
if (u != NULL)
|
|
u->d_error = str;
|
|
}
|
|
#endif /* _LIBUFS */
|
|
|
|
__BEGIN_DECLS
|
|
|
|
/*
|
|
* libufs prototypes.
|
|
*/
|
|
|
|
/*
|
|
* block.c
|
|
*/
|
|
ssize_t bread(struct uufsd *, ufs2_daddr_t, void *, size_t);
|
|
ssize_t bwrite(struct uufsd *, ufs2_daddr_t, const void *, size_t);
|
|
int berase(struct uufsd *, ufs2_daddr_t, ufs2_daddr_t);
|
|
|
|
/*
|
|
* cgroup.c
|
|
*/
|
|
ufs2_daddr_t cgballoc(struct uufsd *);
|
|
int cgbfree(struct uufsd *, ufs2_daddr_t, long);
|
|
ino_t cgialloc(struct uufsd *);
|
|
int cgread(struct uufsd *);
|
|
int cgread1(struct uufsd *, int);
|
|
int cgwrite(struct uufsd *);
|
|
int cgwrite1(struct uufsd *, int);
|
|
|
|
/*
|
|
* inode.c
|
|
*/
|
|
int getino(struct uufsd *, void **, ino_t, int *);
|
|
int putino(struct uufsd *);
|
|
|
|
/*
|
|
* sblock.c
|
|
*/
|
|
int sbread(struct uufsd *);
|
|
int sbwrite(struct uufsd *, int);
|
|
|
|
/*
|
|
* type.c
|
|
*/
|
|
int ufs_disk_close(struct uufsd *);
|
|
int ufs_disk_fillout(struct uufsd *, const char *);
|
|
int ufs_disk_fillout_blank(struct uufsd *, const char *);
|
|
int ufs_disk_write(struct uufsd *);
|
|
|
|
/*
|
|
* ffs_subr.c
|
|
*/
|
|
void ffs_clrblock(struct fs *, u_char *, ufs1_daddr_t);
|
|
void ffs_clusteracct(struct fs *, struct cg *, ufs1_daddr_t, int);
|
|
void ffs_fragacct(struct fs *, int, int32_t [], int);
|
|
int ffs_isblock(struct fs *, u_char *, ufs1_daddr_t);
|
|
int ffs_isfreeblock(struct fs *, u_char *, ufs1_daddr_t);
|
|
void ffs_setblock(struct fs *, u_char *, ufs1_daddr_t);
|
|
|
|
/*
|
|
* crc32c.c
|
|
*/
|
|
uint32_t calculate_crc32c(uint32_t, const void *, size_t);
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* __LIBUFS_H__ */
|