pSOSystem System Calls - Read

verify_vol pHILE+ System Calls
Target
verify_vol() calls a user-supplied function, faultp(), for status-checking (see
page 2-131). For each processor family, faultp() returns its return value in the
register specified below:
68K
PPC
960
x86
Return Value
Error Codes
pb_badblkptr Points to a user-provided list of bad blocks on the
volume. A bad block is a block that cannot be read
and/or written and is therefore unusable by the
pHILE+ file system manager. This list is made up of
32-bit entries and is terminated with a 0 entry. The
entries need not be in any specific order.
verify_vol() can greatly simplify the handling of
bad blocks. Refer to “Bad Blocks” on page 2-139 for
information on this feature. If no bad block list is
provided, this entry must be 0.
On 68K processors, faultp() uses the D0.L register.
On PowerPC processors, faultp() uses the r3 register.
On 960 processors, faultp() uses the g0 register.
On x86 processors, faultp() uses the %eax register.
This system call returns 0 on success or an error code on failure.
Hex Mnemonic Description
0x2007 E_VALIEN Wrong volume format.
0x2009 E_MNTOPEN Files are open on volume.
2-128 pSOSystem System Calls