#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:53+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man2/fallocate.2:11 #, no-wrap msgid "FALLOCATE" msgstr "" #. type: TH #: man-pages/man2/fallocate.2:11 #, no-wrap msgid "2014-07-08" msgstr "" #. type: TH #: man-pages/man2/fallocate.2:11 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/fallocate.2:11 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/fallocate.2:12 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:14 msgid "fallocate - manipulate file space" msgstr "" #. type: SH #: man-pages/man2/fallocate.2:14 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:18 #, no-wrap msgid "" "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n" "B<#include Efcntl.hE>\n" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:21 #, no-wrap msgid "" "BIB<, int >IB<, off_t >IB<, off_t " ">IB<);>\n" msgstr "" #. type: SH #: man-pages/man2/fallocate.2:22 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:27 msgid "" "This is a nonportable, Linux-specific system call. For the portable, POSIX." "1-specified method of ensuring that space is allocated for a file, see " "B(3)." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:37 msgid "" "B() allows the caller to directly manipulate the allocated disk " "space for the file referred to by I for the byte range starting at " "I and continuing for I bytes." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:42 msgid "" "The I argument determines the operation to be performed on the given " "range. Details of the supported operations are given in the subsections " "below." msgstr "" #. type: SS #: man-pages/man2/fallocate.2:42 #, no-wrap msgid "Allocating disk space" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:65 msgid "" "The default operation (i.e., I is zero) of B() allocates " "the disk space within the range specified by I and I. The file " "size (as reported by B(2)) will be changed if I+I is " "greater than the file size. Any subregion within the range specified by " "I and I that did not contain data before the call will be " "initialized to zero. This default behavior closely resembles the behavior " "of the B(3) library function, and is intended as a method " "of optimally implementing that function." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:71 msgid "" "After a successful call, subsequent writes into the range specified by " "I and I are guaranteed not to fail because of lack of disk " "space." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:82 msgid "" "If the B flag is specified in I, the behavior of " "the call is similar, but the file size will not be changed even if " "I+I is greater than the file size. Preallocating zeroed blocks " "beyond the end of the file in this manner is useful for optimizing append " "workloads." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:86 msgid "" "Because allocation is done in block size chunks, B() may " "allocate a larger range of disk space than was specified." msgstr "" #. type: SS #: man-pages/man2/fallocate.2:86 #, no-wrap msgid "Deallocating file space" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:101 msgid "" "Specifying the B flag (available since Linux 2.6.38) " "in I deallocates space (i.e., creates a hole) in the byte range " "starting at I and continuing for I bytes. Within the specified " "range, partial filesystem blocks are zeroed, and whole filesystem blocks are " "removed from the file. After a successful call, subsequent reads from this " "range will return zeroes." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:112 msgid "" "The B flag must be ORed with B in " "I; in other words, even when punching off the end of the file, the " "file size (as reported by B(2)) does not change." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:117 msgid "" "Not all filesystems support B; if a filesystem doesn't " "support the operation, an error is returned. The operation is supported on " "at least the following filesystems:" msgstr "" #. type: IP #: man-pages/man2/fallocate.2:117 man-pages/man2/fallocate.2:119 man-pages/man2/fallocate.2:122 man-pages/man2/fallocate.2:124 man-pages/man2/fallocate.2:222 man-pages/man2/fallocate.2:225 #, no-wrap msgid "*" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:119 msgid "XFS (since Linux 2.6.38)" msgstr "" #. commit a4bb6b64e39abc0e41ca077725f2a72c868e7622 #. type: Plain text #: man-pages/man2/fallocate.2:122 msgid "ext4 (since Linux 3.0)" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:124 msgid "Btrfs (since Linux 3.7)" msgstr "" #. commit 83e4fa9c16e4af7122e31be3eca5d57881d236fe #. type: Plain text #: man-pages/man2/fallocate.2:127 msgid "tmpfs (since Linux 3.5)" msgstr "" #. type: SS #: man-pages/man2/fallocate.2:127 #, no-wrap msgid "Collapsing file space" msgstr "" #. commit 00f5e61998dd17f5375d9dfc01331f104b83f841 #. type: Plain text #: man-pages/man2/fallocate.2:147 msgid "" "Specifying the B flag (available since Linux 3.15) " "in I removes a byte range from a file, without leaving a hole. The " "byte range to be collapsed starts at I and continues for I " "bytes. At the completion of the operation, the contents of the file " "starting at the location I will be appended at the location " "I, and the file will be I bytes smaller." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:161 msgid "" "A filesystem may place limitations on the granularity of the operation, in " "order to ensure efficient implementation. Typically, I and I " "must be a multiple of the filesystem logical block size, which varies " "according to the filesystem type and configuration. If a filesystem has " "such a requirement, B() will fail with the error B if " "this requirement is violated." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:170 msgid "" "If the region specified by I plus I reaches or passes the end " "of file, an error is returned; instead, use B(2) to truncate a " "file." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:175 msgid "" "No other flags may be specified in I in conjunction with " "B." msgstr "" #. commit 9eb79482a97152930b113b51dff530aba9e28c8e #. commit e1d8fb88a64c1f8094b9f6c3b6d2d9e6719c970d #. type: Plain text #: man-pages/man2/fallocate.2:183 msgid "" "As at Linux 3.15, B is supported by ext4 (only for " "extent-based files) and XFS." msgstr "" #. type: SS #: man-pages/man2/fallocate.2:183 #, no-wrap msgid "Zeroing file space" msgstr "" #. commit 409332b65d3ed8cfa7a8030f1e9d52f372219642 #. type: Plain text #: man-pages/man2/fallocate.2:199 msgid "" "Specifying the B flag (available since Linux 3.14) in " "I zeroes space in the byte range starting at I and continuing " "for I 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." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:205 msgid "" "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." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:217 msgid "" "If the B flag is additionally specified in I, the " "behavior of the call is similar, but the file size will not be changed even " "if I+I is greater than the file size. This behavior is the " "same as when preallocating space with B specified." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:222 msgid "" "Not all filesystems support B; if a filesystem doesn't " "support the operation, an error is returned. The operation is supported on " "at least the following filesystems:" msgstr "" #. commit 376ba313147b4172f3e8cf620b9fb591f3e8cdfa #. type: Plain text #: man-pages/man2/fallocate.2:225 msgid "XFS (since Linux 3.14)" msgstr "" #. commit b8a8684502a0fc852afa0056c6bb2a9273f6fcc0 #. type: Plain text #: man-pages/man2/fallocate.2:228 msgid "ext4, for extent-based files (since Linux 3.14)" msgstr "" #. type: SH #: man-pages/man2/fallocate.2:228 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:235 msgid "" "On success, B() returns zero. On error, -1 is returned and " "I is set to indicate the error." msgstr "" #. type: SH #: man-pages/man2/fallocate.2:235 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: man-pages/man2/fallocate.2:236 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:240 msgid "I is not a valid file descriptor, or is not opened for writing." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:240 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:244 msgid "I+I exceeds the maximum file size." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:244 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:247 msgid "A signal was caught during execution." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:247 man-pages/man2/fallocate.2:259 man-pages/man2/fallocate.2:269 man-pages/man2/fallocate.2:279 man-pages/man2/fallocate.2:287 #, no-wrap msgid "B" msgstr "" #. FIXME (raise a kernel bug) Probably the len==0 case should be #. a no-op, rather than an error. That would be consistent with #. similar APIs for the len==0 case. #. See "Re: [PATCH] fallocate.2: add FALLOC_FL_PUNCH_HOLE flag definition" #. 21 Sep 2012 #. http://thread.gmane.org/gmane.linux.file-systems/48331/focus=1193526 #. type: Plain text #: man-pages/man2/fallocate.2:259 msgid "I was less than 0, or I was less than or equal to 0." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:269 msgid "" "I is B and the range specified by I " "plus I reaches or passes the end of the file." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:279 msgid "" "I is B, but either I or I is " "not a multiple of the filesystem block size." msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:287 msgid "" "I contains both B and other flags; no other " "flags are permitted with B." msgstr "" #. There was a inconsistency in 3.15-rc1, that should be resolved so that all #. filesystems use this error for this case. (Tytso says ex4 will change.) #. http://thread.gmane.org/gmane.comp.file-systems.xfs.general/60485/focus=5521 #. From: Michael Kerrisk (man-pages #. Subject: Re: [PATCH v5 10/10] manpage: update FALLOC_FL_COLLAPSE_RANGE flag in fallocate #. Newsgroups: gmane.linux.man, gmane.linux.file-systems #. Date: 2014-04-17 13:40:05 GMT #. type: Plain text #: man-pages/man2/fallocate.2:304 msgid "" "I is B or B, but the " "file referred to by I is not a regular file." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:304 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:307 msgid "An I/O error occurred while reading from or writing to a filesystem." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:307 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:314 msgid "" "I does not refer to a regular file or a directory. (If I is a pipe " "or FIFO, a different error results.)" msgstr "" #. type: TP #: man-pages/man2/fallocate.2:314 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:319 msgid "" "There is not enough space left on the device containing the file referred to " "by I." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:319 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:323 msgid "This kernel does not implement B()." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:323 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:332 msgid "" "The filesystem containing the file referred to by I does not support " "this operation; or the I is not supported by the filesystem containing " "the file referred to by I." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:332 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:350 msgid "" "The file referred to by I is marked immutable (see B(1)). Or: " "I specifies B or B and " "the file referred to by I is marked append-only (see B(1))." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:350 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:354 msgid "I refers to a pipe or FIFO." msgstr "" #. type: TP #: man-pages/man2/fallocate.2:354 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:362 msgid "" "I specifies B, but the file referred to by " "I is currently being executed." msgstr "" #. type: SH #: man-pages/man2/fallocate.2:362 #, no-wrap msgid "VERSIONS" msgstr "" #. See http://sourceware.org/bugzilla/show_bug.cgi?id=14964 #. type: Plain text #: man-pages/man2/fallocate.2:370 msgid "" "B() is available on Linux since kernel 2.6.23. Support is " "provided by glibc since version 2.10. The B flags are defined " "in glibc headers only since version 2.18." msgstr "" #. type: SH #: man-pages/man2/fallocate.2:370 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:373 msgid "B() is Linux-specific." msgstr "" #. type: SH #: man-pages/man2/fallocate.2:373 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:378 msgid "" "B(1), B(2), B(3), B(3)" msgstr "" #. type: SH #: man-pages/man2/fallocate.2:378 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/fallocate.2:386 msgid "" "This page is part of release 3.70 of the Linux I project. A " "description of the project, information about reporting bugs, and the latest " "version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/" "." msgstr ""