summaryrefslogtreecommitdiffstats
path: root/templates/man1/fallocate.1.pot
blob: 82f3c1cfb35b6058b320f5751f91574657f0b3b5 (plain)
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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-03-29 09:39+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "FALLOCATE"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "2022-05-11"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "util-linux 2.38.1"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "User Commands"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "fallocate - preallocate or deallocate space to a file"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"B<fallocate> [B<-c>|B<-p>|B<-z>] [B<-o> I<offset>] B<-l> I<length> [B<-n>] "
"I<filename>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<fallocate> B<-d> [B<-o> I<offset>] [B<-l> I<length>] I<filename>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<fallocate> B<-x> [B<-o> I<offset>] B<-l> I<length filename>"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"B<fallocate> is used to manipulate the allocated disk space for a file, "
"either to deallocate or preallocate it. For filesystems which support the "
"B<fallocate>(2) system call, preallocation is done quickly by allocating "
"blocks and marking them as uninitialized, requiring no IO to the data "
"blocks. This is much faster than creating a file by filling it with zeroes."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The exit status returned by B<fallocate> is 0 on success and 1 on failure."
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "OPTIONS"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The I<length> and I<offset> arguments may be followed by the multiplicative "
"suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, "
"ZiB, and YiB (the \"iB\" is optional, e.g., \"K\" has the same meaning as "
"\"KiB\") or the suffixes KB (=1000), MB (=1000*1000), and so on for GB, TB, "
"PB, EB, ZB, and YB."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The options B<--collapse-range>, B<--dig-holes>, B<--punch-hole>, and B<--"
"zero-range> are mutually exclusive."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-c>, B<--collapse-range>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Removes a byte range from a file, without leaving a hole. The byte range to "
"be collapsed starts at I<offset> and continues for I<length> bytes. At the "
"completion of the operation, the contents of the file starting at the "
"location I<offset>+I<length> will be appended at the location I<offset>, and "
"the file will be I<length> bytes smaller. The option B<--keep-size> may not "
"be specified for the collapse-range operation."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Available since Linux 3.15 for ext4 (only for extent-based files) and XFS."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"A filesystem may place limitations on the granularity of the operation, in "
"order to ensure efficient implementation. Typically, I<offset> and I<length> "
"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, the operation will fail with the error B<EINVAL> if this "
"requirement is violated."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-d>, B<--dig-holes>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Detect and dig holes. This makes the file sparse in-place, without using "
"extra disk space. The minimum size of the hole depends on filesystem I/O "
"block size (usually 4096 bytes). Also, when using this option, B<--keep-"
"size> is implied. If no range is specified by B<--offset> and B<--length>, "
"then the entire file is analyzed for holes."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"You can think of this option as doing a \"B<cp --sparse>\" and then renaming "
"the destination file to the original, without the need for extra disk space."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "See B<--punch-hole> for a list of supported filesystems."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-i>, B<--insert-range>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Insert a hole of I<length> bytes from I<offset>, shifting existing data."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-l>, B<--length> I<length>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Specifies the length of the range, in bytes."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-n>, B<--keep-size>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Do not modify the apparent length of the file. This may effectively allocate "
"blocks past EOF, which can be removed with a truncate."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-o>, B<--offset> I<offset>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Specifies the beginning offset of the range, in bytes."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-p>, B<--punch-hole>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Deallocates space (i.e., creates a hole) in the byte range starting at "
"I<offset> and continuing for I<length> 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. This option may not be specified at the same time "
"as the B<--zero-range> option. Also, when using this option, B<--keep-size> "
"is implied."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Supported for XFS (since Linux 2.6.38), ext4 (since Linux 3.0), Btrfs (since "
"Linux 3.7), tmpfs (since Linux 3.5) and gfs2 (since Linux 4.16)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-v>, B<--verbose>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Enable verbose mode."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-x>, B<--posix>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Enable POSIX operation mode. In that mode allocation operation always "
"completes, but it may take longer time when fast allocation is not supported "
"by the underlying filesystem."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-z>, B<--zero-range>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Zeroes space in the byte range starting at I<offset> and continuing for "
"I<length> 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
#: debian-bookworm
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
#: debian-bookworm
msgid ""
"Option B<--keep-size> can be specified to prevent file length modification."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Available since Linux 3.14 for ext4 (only for extent-based files) and XFS."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-h>, B<--help>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Display help text and exit."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<-V>, B<--version>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Print version and exit."
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "AUTHORS"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<truncate>(1), B<fallocate>(2), B<posix_fallocate>(3)"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "REPORTING BUGS"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "For bug reports, use the issue tracker at"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "AVAILABILITY"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The B<fallocate> command is part of the util-linux package which can be "
"downloaded from"
msgstr ""