pSOSystem System Calls - Read

write_vol pHILE+ System Calls
Error Codes
Notes
See Also
Hex Mnemonic Description
0x200A E_DMOUNT Volume not mounted.
0x2015 E_RO Operation not allowed on read-only
system files, directories, or mounted
volumes.
0x2025 E_IDN Illegal device name.
0x2050 E_BADNFS NFS volume; illegal operation.
0x2060 E_BADCD CD-ROM volume; illegal operation.
1. If index is larger than the volume's block size, the write begins in a subsequent
block. For example, on a volume with a 1024-byte block size, writing block 5,
index 1224, is the same as writing block 6, index 200.
2. write_vol() does not check for the end of the volume; blocks beyond the
specified volume size can be written if they physically exist.
3. If the requested data includes either entire blocks or a contiguous sequence of
blocks and if such blocks are not already in the buffer cache, the pHILE+ file
system manager writes the blocks directly to the volume (without going through
the buffer cache.) Therefore, write_vol() operations are more efficient when
bcount and index equal integral multiples of blocks.
4. write_vol() execution on any block is allowed, including blocks in system
files. Therefore, use this call cautiously.
5. CD-ROM volumes are read-only.
read_vol
2-146 pSOSystem System Calls