github
/
aria2
mirror of https://github.com/aria2/aria2
1
0
Fork 0
Code Issues Releases Wiki Activity

doc: warn that preallocation disables compression on btrfs 

falloc() will disable cow for writes in the preallocated area, and
has the side-effect of also disabling file compression for that file.

If user wants compression they should be advised to use trunc or none
file-allocation instead.
pull/1692/head
Dominique Martinet 2020-10-04 17:26:54 +02:00
parent 15cad965eb
commit ffbe29b930
3 changed files with 16 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/manual-src/en/aria2c.rst
View File

@ -1357,9 +1357,10 @@ Advanced Options
If you are using newer file systems such as ext4
(with extents support), btrfs, xfs or NTFS(MinGW build only), ``falloc`` is
your best choice. It allocates large(few GiB)
files almost instantly. Don't use ``falloc`` with
legacy file systems such as ext3 and FAT32 because it takes
almost same time as ``prealloc`` and it blocks aria2
files almost instantly. Note that btrfs disables compression when
pre-allocating, use ``trunc`` or ``none`` if you want compression.
Don't use ``falloc`` with legacy file systems such as ext3 and FAT32
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
:manpage:`posix_fallocate(3)` function.

7
doc/manual-src/pt/aria2c.rst
View File

@ -1204,9 +1204,10 @@ Opções Avançadas
If you are using newer file systems such as ext4
(with extents support), btrfs, xfs or NTFS(MinGW build only), ``falloc`` is
your best choice. It allocates large(few GiB)
files almost instantly. Don't use ``falloc`` with
legacy file systems such as ext3 and FAT32 because it takes
almost same time as ``prealloc`` and it blocks aria2
files almost instantly. Note that btrfs disables compression when
pre-allocating, use ``trunc`` or ``none`` if you want compression.
Don't use ``falloc`` with legacy file systems such as ext3 and FAT32
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
:manpage:`posix_fallocate(3)` function.

13
src/usage_text.h
View File

@ -138,12 +138,15 @@
" the file.\n" \
" If you are using newer file systems such as ext4\n" \
" (with extents support), btrfs, xfs or NTFS\n" \
" (MinGW build only), 'falloc' is your best\n" \
" (MinGW build only), 'falloc' is your best\n" \
" choice. It allocates large(few GiB) files\n" \
" almost instantly. Don't use 'falloc' with legacy\n" \
" file systems such as ext3 and FAT32 because it\n" \
" takes almost same time as 'prealloc' and it\n" \
" blocks aria2 entirely until allocation finishes.\n" \
" almost instantly. Note that btrfs disables\n" \
" compression when pre-allocating, use ``trunc``\n" \
" or ``none`` if you want compression. Don't use\n" \
" 'falloc' with legacy file systems such as ext3\n" \
" and FAT32 because it takes almost same time as\n" \
" 'prealloc' and it blocks aria2 entirely until\n" \
" allocation finishes.\n" \
" 'falloc' may not be available if your system\n" \
" doesn't have posix_fallocate() function.\n" \
" 'trunc' uses ftruncate() system call or\n" \