49 lines
3.8 KiB
Groff
49 lines
3.8 KiB
Groff
.\" Automatically generated by Pandoc 3.7.0.1
|
|
.\"
|
|
.TH "DFGET" "1" "" "Version v2.3.0" "Frivolous \(lqDfget\(rq Documentation"
|
|
.SH NAME
|
|
\f[B]dfget\f[R] \(em client of Dragonfly used to download and upload
|
|
files
|
|
.SH SYNOPSIS
|
|
dfget is the client of Dragonfly which takes a role of peer in a P2P
|
|
network.
|
|
When user triggers a file downloading task, dfget will download the
|
|
pieces of file from other peers.
|
|
Meanwhile, it will act as an uploader to support other peers to download
|
|
pieces from it if it owns them.
|
|
In addition, dfget has the abilities to provide more advanced
|
|
functionality, such as network bandwidth limit, transmission encryption
|
|
and so on.
|
|
.SS OPTIONS
|
|
.IP
|
|
.EX
|
|
\-\-accept\-regex string Recursively download only. Specify a regular expression to accept the complete URL. In this case, you have to enclose the pattern into quotes to prevent your shell from expanding it
|
|
\-\-config string the path of configuration file with yaml extension name, it can also be set by env var: DFGET_CONFIG
|
|
\-\-console whether logger output records to the stdout
|
|
\-\-daemon\-sock string Download socket path of daemon. In linux, default value is /var/run/dfdaemon.sock, in macos(just for testing), default value is /tmp/dfdaemon.sock
|
|
\-\-digest string Check the integrity of the downloaded file with digest, in format of md5:xxx or sha256:yyy
|
|
\-\-disable\-back\-source Disable downloading directly from source when the daemon fails to download file
|
|
\-\-filter string Filter the query parameters of the url, P2P overlay is the same one if the filtered url is same, in format of key&sign, which will filter \(aqkey\(aq and \(aqsign\(aq query parameters
|
|
\-H, \-\-header strings url header, eg: \-\-header=\(aqAccept: *\(aq \-\-header=\(aqHost: abc\(aq
|
|
\-h, \-\-help help for dfget
|
|
\-\-level uint Recursively download only. Set the maximum number of subdirectories that dfget will recurse into. Set to 0 for no limit (default 5)
|
|
\-l, \-\-list Recursively download only. List all urls instead of downloading them.
|
|
\-\-logdir string Dfget log directory
|
|
\-\-original\-offset Range request only. Download ranged data into target file with original offset. Daemon will make a hardlink to target file. Client can download many ranged data into one file for same url. When enabled, back source in client will be disabled
|
|
\-O, \-\-output string Destination path which is used to store the downloaded file, it must be a full path
|
|
\-P, \-\-priority string Scheduler will schedule task according to priority
|
|
\-\-range string Download range. Like: 0\-9, stands download 10 bytes from 0 \-9, [0:9] in real url
|
|
\-\-ratelimit string The downloading network bandwidth limit per second in format of G(B)/g/M(B)/m/K(B)/k/B, pure number will be parsed as Byte, 0 is infinite (default \(dq100.0MB\(dq)
|
|
\-r, \-\-recursive Recursively download all resources in target url, the target source client must support list action
|
|
\-\-reject\-regex string Recursively download only. Specify a regular expression to reject the complete URL. In this case, you have to enclose the pattern into quotes to prevent your shell from expanding it
|
|
\-b, \-\-show\-progress Show progress bar, it conflicts with \-\-console
|
|
\-\-tag string Different tags for the same url will be divided into different P2P overlay, it conflicts with \-\-digest
|
|
\-\-timeout duration Timeout for the downloading task, 0 is infinite
|
|
\-u, \-\-url string Download one file from the url, equivalent to the command\(aqs first position argument
|
|
\-\-workhome string Dfget working directory
|
|
.EE
|
|
.SH BUGS
|
|
See GitHub Issues: \c
|
|
.UR https://github.com/dragonflyoss/dragonfly/issues
|
|
.UE \c
|