.SS ファイル空間の一部削除
.\" commit 00f5e61998dd17f5375d9dfc01331f104b83f841
\fBFALLOC_FL_COLLAPSE_RANGE\fP フラグ (Linux 3.15 以降で利用可能) を \fImode\fP に指定すると、
-æ\8c\87å®\9aã\81\97ã\81\9fã\83\90ã\82¤ã\83\88ç¯\84å\9b²ã\82\92ã\83\95ã\82¡ã\82¤ã\83«ã\81\8bã\82\89å\89\8aé\99¤ã\81\99ã\82\8bã\80\82 ã\81\9dã\81®é\9a\9bã\80\81ã\83\9bã\83¼ã\83«ã\82\92æ®\8bã\82\89ない。 削除されるバイト範囲は \fIoffset\fP から始まる \fIlen\fP
+æ\8c\87å®\9aã\81\97ã\81\9fã\83\90ã\82¤ã\83\88ç¯\84å\9b²ã\82\92ã\83\95ã\82¡ã\82¤ã\83«ã\81\8bã\82\89å\89\8aé\99¤ã\81\99ã\82\8bã\80\82 ã\81\9dã\81®é\9a\9bã\80\81ã\83\9bã\83¼ã\83«ã\82\92æ®\8bã\81\95ない。 削除されるバイト範囲は \fIoffset\fP から始まる \fIlen\fP
バイトの範囲である。 操作が完了すると、 ファイルの \fIoffset+len\fP の位置から始まる内容が \fIoffset\fP の位置に見えるようになり、
ファイルのサイズは \fIlen\fP バイトだけ小さくなる。
でサポートされている。
.SS ファイル空間のゼロ埋め
.\" commit 409332b65d3ed8cfa7a8030f1e9d52f372219642
-Specifying the \fBFALLOC_FL_ZERO_RANGE\fP flag (available since Linux 3.14) in
-\fImode\fP zeroes space in the byte range starting at \fIoffset\fP and continuing
-for \fIlen\fP bytes. Within the specified range, blocks are preallocated for
-the regions that span the holes in the file. After a successful call,
-subsequent reads from this range will return zeroes.
+\fBFALLOC_FL_ZERO_RANGE\fP フラグ (Linux 3.14 以降で利用可能) を \fImode\fP に指定すると、 \fIoffset\fP
+で始まる \fIlen\fP バイト範囲の空間をゼロ埋めする。
+指定された範囲の中では、ブロックは、そのファイル内のホールが広がる領域にあらかじめ割り当てられたものである。 呼び出しが成功すると、
+これ以降のこの範囲からの読み出しでは 0 を返す。
-Zeroing is done within the filesystem preferably by converting the range
-into unwritten extents. This approach means that the specified range will
-not be physically zeroed out on the device (except for partial blocks at the
-either end of the range), and I/O is (otherwise) required only to update
-metadata.
+ゼロ埋めは、ファイルシステム内部では、指定された範囲を書き込みを伴わないエクステントに変換する方法をできるだけ使って行われる。
+この方法は、指定された範囲について物理的にゼロ埋めしたデータがデバイスに書き込まれるのではないことを意味する
+(例外は指定された範囲の端の部分的に使用しているブロックである)。 (これ以外で) I/O が必要なのはメタデータの更新だけである。
-If the \fBFALLOC_FL_KEEP_SIZE\fP flag is additionally specified in \fImode\fP, the
-behavior of the call is similar, but the file size will not be changed even
-if \fIoffset\fP+\fIlen\fP is greater than the file size. This behavior is the
-same as when preallocating space with \fBFALLOC_FL_KEEP_SIZE\fP specified.
+\fBFALLOC_FL_KEEP_SIZE\fP フラグが \fImode\fP に追加で指定された場合、 このシステムコールの動作は似ているが、
+\fIoffset\fP+\fIlen\fP がファイルサイズよりも大きい場合であってもファイルサイズは変更されない点が異なる。 この動作は
+\fBFALLOC_FL_KEEP_SIZE\fP を指定してスペースを前もって割り当てた場合と同じである。
すべてのファイルシステムで \fBFALLOC_FL_ZERO_RANGE\fP がサポートされているわけではない。
ファイルシステムがこの操作をサポートしていない場合は、 エラーが返る。 この操作は少なくとも以下のファイルシステムでサポートされている。
XFS (Linux 3.14 以降)
.IP *
.\" commit b8a8684502a0fc852afa0056c6bb2a9273f6fcc0
-ext4, for extent\-based files (since Linux 3.14)
+ext4 のエクステントベースのファイル (Linux 3.14 以降)
.SH 返り値
-成功の場合、 \fBfallocate\fP() は 0 を返す。 エラーの場合、\-1 を返し、 \fIerror\fP にエラーを示す値を設定する。
+成功の場合、 \fBfallocate\fP() は 0 を返す。 エラーの場合、\-1 を返し、 \fIerrno\fP にエラーを示す値を設定する。
.SH エラー
.TP
\fBEBADF\fP
OSDN Git Service
