gfs_pio_truncate

Name

gfs_pio_truncate -- 指定した長さにファイル切り詰める。もしくは拡張する。

Synopsis

#include <gfarm/gfarm.h>

char *gfs_pio_truncate(GFS_File gf, file_offset_t length);

DESCRIPTION

ファイル gf の長さを変更します。

引数 length がファイル gf よりも短かければ切り詰めます。

引数 length がファイル gf よりも長ければ拡張します。拡張された部分を読んだ場合はゼロを返します。

ファイルポインタは変更しません。

ファイルは書き込み用にオープンされていなければなりません。 このため、オープン時に GFS_FILE_MODE_WRITE フラグを指定する必要があります。

RETURN VALUES

NULL

正常終了を示します。

GFARM_ERR_NO_MEMORY

メモリ不足のため処理を中止しました。

その他

上記以外のエラーが生じたことを示します。

SEE ALSO

gfs_pio_create(3), gfs_pio_open(3)