NAME
gfs_pio_truncate - truncate a file to a specified length
SYNOPSIS
#include <gfarm/gfarm.h>
char *gfs_pio_truncate (GFS_File gf, file_offset_t length);
DESCRIPTION
The gfs_pio_truncate() function truncates the regular file gf to the
length bytes.
If the file was previously shorter than the length, it is extended, and
the extended part is filled by zero bytes.
The file pointer is not changed.
You must specify GFS_FILE_MODE_WRITE in opening the file, because it
must be open for writing.
RETURN VALUES
NULL The function terminated successfully.
GFARM_ERR_NO_MEMORY
Insufficient memory was available.
Others An error except the above occurred. The reason is shown by its
pointed strings.
SEE ALSO
gfs_pio_create(3), gfs_pio_open(3)