1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
.\" Copyright (c) 2007 Silicon Graphics, Inc. All Rights Reserved
.\" Written by Dave Chinner <dgc@sgi.com>
.\" May be distributed as per GNU General Public License version 2.
.\"
.\" Japanese Version Copyright (c) 2007 Akihiro MOTOKI
.\" all rights reserved.
.\" Translated 2007-10-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.66
.\"
.TH FALLOCATE 2 2007-07-20 "Linux" "Linux Programmer's Manual"
.SH ̾
fallocate \- ե֤
.SH
.nf
.\" FIXME . eventually this #include will probably be something
.\" different when support is added in glibc.
.B #include <linux/falloc.h>
.BI "long fallocate(int " fd ", int " mode ", loff_t " offset \
", loff_t " len ");"
.fi
.\" FIXME . check later what feature text macros are required in glibc
.SH
.BR fallocate ()
Ȥȡ
.I fd
Ȥե˳Ƥ줿ǥ֤ľǤ롣
оݤϡ
.I offset
ϤޤĹ
.I len
ХȤΰǤ롣
.I mode
ϡꤵ줿ΰФƼ¹Ԥꤹ롣
ߤΤȤ
.I mode
˻Ǥե饰ϰʲΰĤǤ롣
.TP
.B FALLOC_FL_KEEP_SIZE
Υե饰ϡ
.I offset
.I len
ǻꤵ줿ΰΥǥ֤ơζ֤ 0 ǽ롣
ƤӽФȡ³ƤΰؤνߤԤ뤬
ǥ֤ˤԤȯʤȤݾڤ롣
եΰˤĤ 0 ֥åä
ƤƤȤϡɵ (append) κ٤ŬΤ
ͭѤǤ롣
ե륵
.I "offset + len"
⾮ǤäƤ⡢֥åäƤγƤˤ
.RB ( stat (2)
֤) ե륵ѹ뤳ȤϤʤ
.\"
.\" Note from Amit Arora:
.\" There were few more flags which were discussed, but none of
.\" them have been finalized upon. Here are these flags:
.\" FA_FL_DEALLOC, FA_FL_DEL_DATA, FA_FL_ERR_FREE, FA_FL_NO_MTIME,
.\" FA_FL_NO_CTIME
.\" All of the above flags were debated upon and we can not say
.\" if any/which one of these flags will make it to the later kernels.
.PP
.B FALLOC_FL_KEEP_SIZE
ե饰
.I mode
˻ꤵʤä硢ǥեȤư
.B FALLOC_FL_KEEP_SIZE
ե饰ꤵ줿ȤۤȤƱȤʤ롣
ͣΰ㤤ϡ
.I offset + len
ե륵礭ä硢ƤӽФ
ե륵ѹǤ롣
ΥǥեȤưϡ饤֥ؿ
.BR posix_fallocate (3)
ư˻Ƥ롣
.BR posix_fallocate (3)
Ŭ˼ʤ뤳ȤŪȤƤ뤫Ǥ롣
.PP
Ƥϥ֥åñ̤ǹԤ뤿ᡢ
.BR fallocate ()
ϻꤵ줿礭ΰƤ뤳Ȥ롣
.SH ֤
.BR fallocate ()
0 ֤Ԥȥ顼ֹ֤
.\" FIXME . the library wrapper function will do the right
.\" thing, returning -1 on error and setting errno.
.I errno
ϥåȤʤդ뤳ȡ
.SH 顼
.TP
.B EBADF
.I fd
ͭʥեǥץǤʤ
ѤȤƥץƤʤ
.TP
.B EFBIG
.I offset + len
ե륵κͤ礭
.TP
.B EINTR
¹˥ʥ뤬ª줿
.TP
.B EINVAL
.I offset
0 ̤Ǥ뤫
.I len
0 ʲǤ롣
.TP
.B EIO
ե륷ƥȤɤ߽ϥ顼ȯ
.TP
.B ENODEV
.I fd
̾Υե뤫ǥ쥯ȥȤƤʤ
.RI ( fd
ѥפ FIFO ȤƤ硢̤Υ顼ȯ)
.TP
.B ENOSPC
.I fd
ȤեޤǥХ˽ʬʶΰ褬ʤ
.TP
.B ENOSYS
.I fd
Ȥեޤե륷ƥब
ꤵ줿ݡȤƤʤ
.TP
.B EOPNOTSUPP
.I fd
Ȥեޤե륷ƥब
.I mode
ݡȤƤʤ
.SH С
.BR fallocate ()
ϥͥ 2.6.23 ʹߤ Linux ѲǽǤ롣
.SH
.BR fallocate ()
Linux ͭǤ롣
.SH Ϣ
.BR ftruncate (2),
.BR posix_fallocate (3),
.BR posix_fadvise (3)
|
