OSDN Git Service

(split) LDP: Update release pages
[linuxjm/LDP_man-pages.git] / release / man2 / fallocate.2
index 8d95589..e679e4f 100644 (file)
@@ -13,7 +13,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH FALLOCATE 2 2013\-02\-12 Linux "Linux Programmer's Manual"
+.TH FALLOCATE 2 2013\-06\-10 Linux "Linux Programmer's Manual"
 .SH 名前
 fallocate \- ファイル空間の操作
 .SH 書式
@@ -54,21 +54,19 @@ POSIX.1 で規定された方法である \fBposix_fallocate\fP(3)  を使うこ
 割り当てはブロックサイズ単位で行われるため、 \fBfallocate\fP() は指定されたより
 も大きなディスク領域を割り当てることがある。
 .SS ファイル空間の割り当て解除
-Specifying the \fBFALLOC_FL_PUNCH_HOLE\fP flag (available since Linux 2.6.38)
-in \fImode\fP deallocates space (i.e., creates a hole)  in the byte range
-starting at \fIoffset\fP and continuing for \fIlen\fP bytes.  Within the specified
-range, partial file system blocks are zeroed, and whole file system blocks
-are removed from the file.  After a successful call, subsequent reads from
-this range will return zeroes.
+\fBFALLOC_FL_PUNCH_HOLE\fP フラグ (Linux 2.6.38 以降で利用可能) を \fImode\fP に指定すると、
+\fIoffset\fP で始まる \fIlen\fP バイトの領域の空間を解放する (ホールを作成する)。 指定された範囲のうち、
+部分的に使用しているファイルシステムブロックは 0 で埋められ、 全体を使用しているファイルシステムブロックはそのファイルから削除される。
+呼び出しが成功すると、 これ以降のこの範囲からの読み出しでは 0 を返す。
 
-The \fBFALLOC_FL_PUNCH_HOLE\fP flag must be ORed with \fBFALLOC_FL_KEEP_SIZE\fP in
-\fImode\fP; in other words, even when punching off the end of the file, the
-file size (as reported by \fBstat\fP(2))  does not change.
+\fBFALLOC_FL_PUNCH_HOLE\fP フラグは \fBFALLOC_FL_KEEP_SIZE\fP と論理和 (OR) をとって \fImode\fP
+に指定しなければならない。 つまり、 ファイル末尾の punch off を行った場合でも、 (\fBstat\fP(2) で報告される)
+ファイルサイズが変化しない。
 
-Not all file systems support \fBFALLOC_FL_PUNCH_HOLE\fP; if a file system
-doesn't support the operation, an error is returned.
+すべてのファイルシステムで \fBFALLOC_FL_PUNCH_HOLE\fP がサポートされているわけではない。
+ファイルシステムがこの操作をサポートしていない場合は、 エラーが返る。
 .SH 返り値
-\fBfallocate\fP()  は成功すると 0 を返し、エラーの場合は \-1 を返す
+成功の場合、 \fBfallocate\fP() は 0 を返す。 エラーの場合、\-1 を返し、 \fIerror\fP にエラーを示す値を設定する
 .SH エラー
 .TP 
 \fBEBADF\fP
@@ -107,9 +105,9 @@ doesn't support the operation, an error is returned.
 \fImode\fP をサポートしていない。
 .TP 
 \fBEPERM\fP
-The file referred to by \fIfd\fP is marked immutable (see \fBchattr\fP(1)).  Or:
-\fImode\fP specifies \fBFALLOC_FL_PUNCH_HOLE\fP and the file referred to by \fIfd\fP
-is marked append\-only (see \fBchattr\fP(1)).
+\fIfd\fP が参照するファイルに変更不可 (immutable) の属性が付いている (\fBchattr\fP(1) 参照)。 \fImode\fP に
+\fBFALLOC_FL_PUNCH_HOLE\fP が指定されたが、 \fIfd\fP が参照するファイルに追加のみ (append\-only)
+の属性が付いている (\fBchattr\fP(1) 参照)。
 .TP 
 \fBESPIPE\fP
 \fIfd\fP がパイプか FIFO を参照している。
@@ -122,6 +120,6 @@ is marked append\-only (see \fBchattr\fP(1)).
 .SH 関連項目
 \fBfallocate\fP(1), \fBftruncate\fP(2), \fBposix_fadvise\fP(3), \fBposix_fallocate\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。