aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/man/gnunet-download.116
1 files changed, 11 insertions, 5 deletions
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1
index 4dd8ecb79..e2c4ab365 100644
--- a/doc/man/gnunet-download.1
+++ b/doc/man/gnunet-download.1
@@ -49,14 +49,18 @@ The final filename is constructed based on meta-data extracted using libextracto
49.It Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS 49.It Fl p Ar DOWNLOADS | Fl \-parallelism= Ns Ar DOWNLOADS
50Set the maximum number of parallel downloads that is allowed. 50Set the maximum number of parallel downloads that is allowed.
51More parallel downloads can, to some extent, improve the overall time to download content. 51More parallel downloads can, to some extent, improve the overall time to download content.
52However, parallel downloads also take more memory (see also option \-r which can be used to limit memory utilization) and more sockets. 52However, parallel downloads also take more memory (see also
53This option is used to limit the number of files that are downloaded in parallel (\-r can be used to limit the number of blocks that are concurrently requested). 53.Fl r
54which can be used to limit memory utilization) and more sockets.
55This option is used to limit the number of files that are downloaded in parallel.
56.Fl r
57can be used to limit the number of blocks that are concurrently requested.
54As a result, the value only matters for recursive downloads. 58As a result, the value only matters for recursive downloads.
55The default value is 32. 59The default value is 32.
56.It Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS 60.It Fl r Ar REQUESTS | Fl \-request-parallelism= Ns Ar REQUESTS
57Set the maximum number of parallel requests that is allowed. 61Set the maximum number of parallel requests that is allowed.
58If multiple files are downloaded, gnunet\-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value. 62If multiple files are downloaded, gnunet-download will not run them in parallel if this would cause the number of pending requests to possibly exceed the given value.
59This is useful since, for example, downloading dozens of multi\-gigabyte files in parallel could exhaust memory resources and would hardly improve performance. 63This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance.
60Note that the limit only applies to this specific process and that other download activities by other processes are not included in this limit. 64Note that the limit only applies to this specific process and that other download activities by other processes are not included in this limit.
61Consider raising this limit for large recursive downloads with many large files if memory and network bandwidth are not fully utilized and if the parallelism limit 65Consider raising this limit for large recursive downloads with many large files if memory and network bandwidth are not fully utilized and if the parallelism limit
62.Pq Fl p 66.Pq Fl p
@@ -65,7 +69,9 @@ This option also only matters for recursive downloads.
65The default value is 4092. 69The default value is 4092.
66.It Fl R | \-recursive 70.It Fl R | \-recursive
67Download directories recursively (and in parallel). 71Download directories recursively (and in parallel).
68Note that the URI must belong to a GNUnet directory and that the filename given to "\-o" must end in '.gnd' -- otherwise, you will receive an error. 72Note that the URI must belong to a GNUnet directory and that the filename given to
73.Fl o
74must end in '.gnd' \(em otherwise, you will receive an error.
69You may want to use "DIRNAME/.gnd" for the filename, this way a directory "DIRNAME/" will be created, and GNUnet's internal directory information will be stored in "DIRNAME/.gnd". 75You may want to use "DIRNAME/.gnd" for the filename, this way a directory "DIRNAME/" will be created, and GNUnet's internal directory information will be stored in "DIRNAME/.gnd".
70However, it is also possible to specify "DIRNAME.gnd", in which case the files from the directory will end up in "DIRNAME/", while GNUnet's directory meta data will be in "DIRNAME.gnd". 76However, it is also possible to specify "DIRNAME.gnd", in which case the files from the directory will end up in "DIRNAME/", while GNUnet's directory meta data will be in "DIRNAME.gnd".
71.It Fl v | \-version 77.It Fl v | \-version