.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "GFS_PIO_TRUNCATE" "3" "17 November 2004" "Gfarm" ""
.SH NAME
gfs_pio_truncate \- 指定した長さにファイル切り詰める。もしくは拡張する。
.SH SYNOPSIS
.sp
\fB#include
.sp
char *gfs_pio_truncate (GFS_File \fIgf\fB, file_offset_t \fIlength\fB);
\fR
.SH "DESCRIPTION"
.PP
ファイル
\fIgf\fR
の長さを変更します。
.PP
引数
\fIlength\fR
がファイル
\fIgf\fR
よりも短かければ切り詰めます。
.PP
引数
\fIlength\fR
がファイル
\fIgf\fR
よりも長ければ拡張します。拡張された部分を読んだ場合はゼロを返します。
.PP
ファイルポインタは変更しません。
.PP
ファイルは書き込み用にオープンされていなければなりません。
このため、オープン時に GFS_FILE_MODE_WRITE
フラグを指定する必要があります。
.SH "RETURN VALUES"
.TP
\fBNULL\fR
正常終了を示します。
.TP
\fBGFARM_ERR_NO_MEMORY\fR
メモリ不足のため処理を中止しました。
.TP
\fBその他\fR
上記以外のエラーが生じたことを示します。
.SH "SEE ALSO"
.PP
\fBgfs_pio_create\fR(3),
\fBgfs_pio_open\fR(3)