diff options
author | ng0 <ng0@n0.is> | 2019-04-20 13:59:38 +0000 |
---|---|---|
committer | ng0 <ng0@n0.is> | 2019-04-20 13:59:38 +0000 |
commit | 6131cd0e220764ae6b9c016a3729d130cc53806d (patch) | |
tree | 2bbfee7a1d85de69aafc00a0a5b34da5270224c4 /doc | |
parent | 5e4dc39b85856222643520b8c8908384d548a0db (diff) | |
download | gnunet-6131cd0e220764ae6b9c016a3729d130cc53806d.tar.gz gnunet-6131cd0e220764ae6b9c016a3729d130cc53806d.zip |
style
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man/gnunet-download.1 | 16 |
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 |
50 | Set the maximum number of parallel downloads that is allowed. | 50 | Set the maximum number of parallel downloads that is allowed. |
51 | More parallel downloads can, to some extent, improve the overall time to download content. | 51 | More parallel downloads can, to some extent, improve the overall time to download content. |
52 | However, parallel downloads also take more memory (see also option \-r which can be used to limit memory utilization) and more sockets. | 52 | However, parallel downloads also take more memory (see also |
53 | This 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 |
54 | which can be used to limit memory utilization) and more sockets. | ||
55 | This option is used to limit the number of files that are downloaded in parallel. | ||
56 | .Fl r | ||
57 | can be used to limit the number of blocks that are concurrently requested. | ||
54 | As a result, the value only matters for recursive downloads. | 58 | As a result, the value only matters for recursive downloads. |
55 | The default value is 32. | 59 | The 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 |
57 | Set the maximum number of parallel requests that is allowed. | 61 | Set the maximum number of parallel requests that is allowed. |
58 | If 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. | 62 | If 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. |
59 | This is useful since, for example, downloading dozens of multi\-gigabyte files in parallel could exhaust memory resources and would hardly improve performance. | 63 | This is useful since, for example, downloading dozens of multi-gigabyte files in parallel could exhaust memory resources and would hardly improve performance. |
60 | Note that the limit only applies to this specific process and that other download activities by other processes are not included in this limit. | 64 | Note that the limit only applies to this specific process and that other download activities by other processes are not included in this limit. |
61 | Consider 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 | 65 | Consider 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. | |||
65 | The default value is 4092. | 69 | The default value is 4092. |
66 | .It Fl R | \-recursive | 70 | .It Fl R | \-recursive |
67 | Download directories recursively (and in parallel). | 71 | Download directories recursively (and in parallel). |
68 | Note 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. | 72 | Note that the URI must belong to a GNUnet directory and that the filename given to |
73 | .Fl o | ||
74 | must end in '.gnd' \(em otherwise, you will receive an error. | ||
69 | You 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". | 75 | You 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". |
70 | However, 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". | 76 | However, 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 |