2009-03-25 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

Documented 'falloc' in man page.
	* doc/aria2c.1.txt
pull/1/head
Tatsuhiro Tsujikawa 2009-03-25 06:07:11 +00:00
parent bfd7950b82
commit ce1231280a
4 changed files with 37 additions and 4 deletions

View File

@ -1,3 +1,8 @@
2009-03-25 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Documented 'falloc' in man page.
* doc/aria2c.1.txt
2009-03-25 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Updated doc

View File

@ -1,11 +1,11 @@
.\" Title: aria2c
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 03/22/2009
.\" Date: 03/25/2009
.\" Manual:
.\" Source:
.\"
.TH "ARIA2C" "1" "03/22/2009" "" ""
.TH "ARIA2C" "1" "03/25/2009" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
@ -800,7 +800,16 @@ or
\fInone\fR
doesn\'t pre\-allocate file space\&.
\fIprealloc\fR
pre\-allocates file space before download begins\&. This may take some time depending on the size of the file\&. Default:
pre\-allocates file space before download begins\&. This may take some time depending on the size of the file\&. If you are using newer file systems such as ext4 (with extents support), btrfs or xfs,
\fIfalloc\fR
is your best choice\&. It allocates large(few GiB) files almost instantly\&. Don\'t use
\fIfalloc\fR
with legacy file systems such as ext3 because it takes almost same time as
\fIprealloc\fR
and it blocks aria2 entirely until allocation finishes\&.
\fIfalloc\fR
may not be available if your system doesn\'t have
\fBposix_fallocate\fR() function\&. Default:
\fIprealloc\fR
.RE
.PP

View File

@ -1446,6 +1446,15 @@ writes the piece to the appropriate files.</td>
<em>none</em> doesn't pre-allocate file space. <em>prealloc</em> pre-allocates file space
before download begins. This may take some time depending on the size of the
file.
If you are using newer file systems such as ext4
(with extents support), btrfs or xfs, <em>falloc</em> is
your best choice. It allocates large(few GiB)
files almost instantly. Don't use <em>falloc</em> with
legacy file systems such as ext3 because it takes
almost same time as <em>prealloc</em> and it blocks aria2
entirely until allocation finishes. <em>falloc</em> may
not be available if your system doesn't have
<strong>posix_fallocate</strong>() function.
Default: <em>prealloc</em>
</p>
</dd>
@ -2337,7 +2346,7 @@ files in the program, then also delete it here.</p></div>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2009-03-22 16:27:15 JST
Last updated 2009-03-25 15:03:34 JST
</div>
</div>
</body>

View File

@ -575,10 +575,20 @@ Advanced Options
'select'.
*--file-allocation*=METHOD::
Specify file allocation method. METHOD is either 'none' or 'prealloc'.
'none' doesn't pre-allocate file space. 'prealloc' pre-allocates file space
before download begins. This may take some time depending on the size of the
file.
If you are using newer file systems such as ext4
(with extents support), btrfs or xfs, 'falloc' is
your best choice. It allocates large(few GiB)
files almost instantly. Don't use 'falloc' with
legacy file systems such as ext3 because it takes
almost same time as 'prealloc' and it blocks aria2
entirely until allocation finishes. 'falloc' may
not be available if your system doesn't have
*posix_fallocate*() function.
Default: 'prealloc'
*--log-level*=LEVEL::