pSOSystem System Calls - Read

pHILE+ System Calls init_vol
Return Value
Error Codes
Notes
scratchbuf Points to a buffer that is used temporarily by
the pHILE+ file system manager during
initialization. The scratch buffer must be the
size of a pHILE+ block. The pHILE+
Configuration Table parameter fc_logbsize
(in the sys_conf.h file) determines this
block size.
This system call returns 0 on success or an error code on failure.
Hex Mnemonic Description
0x2003 E_BADVOL Inconsistent data on volume; volume
corrupted.
0x2005 E_VINITPAR Illegal parameters to init_vol().
0x2008 E_MNTED Volume is already mounted.
0x2021 E_ILLDEV Illegal device (exceeds maximum.)
0x2025 E_IDN Illegal device name.
1. All data stored on the volume is lost by execution of this call.
2. The volume's media must have been properly hardware formatted before this
call is executed.
3. A mounted volume cannot be initialized.
4. init_vol() can be used for the first initialization of a volume. It receives all
the information it needs in its parameters.
5. The pHILE+ file system manager stores the volume's label and time of
initialization in the volume's rootblock, but it does not use this information. The
user decides how to use this information, which can be examined by using
read_vol() to read the rootblock (block 2) directly.
6. The starting block of the bitmap also determines the starting block of the
FLIST, since the FLIST immediately follows the bitmap.
pSOSystem System Calls 2-51
2