From ce1231280a1fd115271311306db697427842c6b4 Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Wed, 25 Mar 2009 06:07:11 +0000 Subject: [PATCH] 2009-03-25 Tatsuhiro Tsujikawa Documented 'falloc' in man page. * doc/aria2c.1.txt --- ChangeLog | 5 +++++ doc/aria2c.1 | 15 ++++++++++++--- doc/aria2c.1.html | 11 ++++++++++- doc/aria2c.1.txt | 10 ++++++++++ 4 files changed, 37 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 0eeb3d05..b26f87d5 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2009-03-25 Tatsuhiro Tsujikawa + + Documented 'falloc' in man page. + * doc/aria2c.1.txt + 2009-03-25 Tatsuhiro Tsujikawa Updated doc diff --git a/doc/aria2c.1 b/doc/aria2c.1 index 67e60f63..e3780a87 100644 --- a/doc/aria2c.1 +++ b/doc/aria2c.1 @@ -1,11 +1,11 @@ .\" Title: aria2c .\" Author: .\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" 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 diff --git a/doc/aria2c.1.html b/doc/aria2c.1.html index 38bc43d7..d09a43b3 100644 --- a/doc/aria2c.1.html +++ b/doc/aria2c.1.html @@ -1446,6 +1446,15 @@ writes the piece to the appropriate files. 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

@@ -2337,7 +2346,7 @@ files in the program, then also delete it here.

diff --git a/doc/aria2c.1.txt b/doc/aria2c.1.txt index ad93d185..dfb9d3a2 100644 --- a/doc/aria2c.1.txt +++ b/doc/aria2c.1.txt @@ -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::