Man Linux: Main Page and Category List

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)