pSOSystem System Calls - Read

pHILE+ System Calls truncate_f
truncate_f Changes the size of a named file.
#include
unsigned long truncate_f(
char *name, /* file pathname */
unsigned long length /* file size in bytes */
)
Volume Types
Description
Arguments
Return Value
pHILE+, MS-DOS, and NFS volumes.
truncate_f() causes the file specified by name to have a size (in bytes) equal to
length. If the file was previously longer than length, the extra bytes are
truncated. If it was shorter, the bytes between the old and new lengths are filled
with zeroes.
Unlike annex_f(), this system call changes both the logical and the physical file
size. (annex_f() changes only the physical file size.)
On pHILE+ or MS-DOS volumes, the file must not be open. If this is violated, the
error E_FOPEN is returned.
name Points to the null-terminated pathname of the file.
length Specifies the new file size in bytes.
This system call returns 0 on success or an error code on failure.
pSOSystem System Calls 2-117
2