osPfsChecker.3p 1.4 KB
.TH osPfsChecker 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
osPfsChecker  \- Check and repair filesystems for CONTROLLER PAK
.SH SYNOPSIS
.nf
\f3
.Op c
#include <ultra64.h>
.sp .8v
s32 osPfsChecker(OSPfs \(**pfs);
.Op
\f1
.fi
.SH DESCRIPTION
.sp
The 
.I osPfsChecker
function audits and repairs inconsistent conditions for the filesystem
given by
.I pfs.
If the filesystem is inconsistent, the
.I PFS_CORRUPTED
bit in status of pfs is set and
.I osPfsChecker
attempts to make correction. Most corrective actions result in some 
loss of data.  The 
.I OSPfs
handle 
must be the handle returned from 
.I osPfsInit.
See
.IR osPfsInit (3P)
for details on how to create this handle. Application should always call
.I osPfsChecker
when  the error code
.I PFS_ERR_INCONSISTENT
is returned from any function.
.sp
A value of 0 is returned if the calls succeed, otherwise
one of the following error code is returned.
.PP
.nf
.ta 5 26 
	PFS_ERR_NOPACK	No CONTROLLER PAK is plugged in the
			specified controller.
.sp
	PFS_ERR_CONTRFAIL	The controller sends data at higher data
			transfer rate than the hardware handling
			capability or the hardware CRC error
			occurs.
.sp
	PFS_ERR_INCONSISTENT	File system inode reading failed.
.fi
.SH "SEE ALSO"
osContInit (3P),
osPfsAllocateFile (3P),
osPfsFileState (3P),
osPfsFreeBlocks (3P),
osPfsInit (3P),
osPfsIsPlug (3P),
osPfsReSizeFile (3P),
osPfsReadWriteFile (3P),
osPfsSetLabel (3P)