chore: update client version to 0.2.0 (#3735)

Signed-off-by: Gaius <gaius.qi@gmail.com>
This commit is contained in:
Gaius 2024-12-31 12:18:06 +08:00 committed by GitHub
parent cc687d7b85
commit cc4abed8c1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
32 changed files with 8273 additions and 3831 deletions

11498
CHANGELOG.md

File diff suppressed because it is too large Load Diff

View File

@ -16,7 +16,7 @@ PROJECT_NAME := "d7y.io/dragonfly/v2"
DFGET_NAME := "dfget"
DFCACHE_NAME := "dfcache"
DFSTORE_NAME := "dfstore"
SEMVER := "2.1.0"
SEMVER := "2.2.0"
VERSION_RELEASE := "1"
PKG := "$(PROJECT_NAME)"
PKG_LIST := $(shell go list ${PKG}/... | grep -v /vendor/ | grep -v '\(/test/\)')

View File

@ -1,37 +1,30 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache delete\f[R] \[em] delete file from P2P cache system
.SH SYNOPSIS
.PP
Delete file from P2P cache system.
.IP
.nf
\f[C]
dfcache delete <-i cid> [flags]
\f[R]
.fi
.EX
dfcache delete <\-i cid> [flags]
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for delete
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for delete
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,38 +1,31 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache doc\f[R] \[em] generate documents
.SH SYNOPSIS
.PP
Generate markdown documents for cmd: dfcache.
.IP
.nf
\f[C]
.EX
dfcache doc [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for doc
--path string destination dir of generated markdown documents (default \[dq]./\[dq])
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for doc
\-\-path string destination dir of generated markdown documents (default \[dq]./\[dq])
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,39 +1,32 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache export\f[R] \[em] export file from P2P cache system
.SH SYNOPSIS
.PP
Export file from P2P cache system.
.IP
.nf
\f[C]
dfcache export <-i cid> <output>|<-O output> [flags]
\f[R]
.fi
.EX
dfcache export <\-i cid> <output>|<\-O output> [flags]
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for export
-l, --local only export file from local cache
-O, --output string export file path
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for export
\-l, \-\-local only export file from local cache
\-O, \-\-output string export file path
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,38 +1,31 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache import\f[R] \[em] import file into P2P cache system
.SH SYNOPSIS
.PP
Import file into P2P cache system.
.IP
.nf
\f[C]
dfcache import <-i cid> <file>|<-I file> [flags]
\f[R]
.fi
.EX
dfcache import <\-i cid> <file>|<\-I file> [flags]
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for import
-I, --input string import the given file into P2P network
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for import
\-I, \-\-input string import the given file into P2P network
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,37 +1,30 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache plugin\f[R] \[em] show plugin
.SH SYNOPSIS
.PP
Show the plugin details of dragonfly.
.IP
.nf
\f[C]
.EX
dfcache plugin [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for plugin
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for plugin
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,39 +1,32 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache stat\f[R] \[em] stat checks if a file exists in P2P cache
system
.SH SYNOPSIS
.PP
Stat checks if a file exists in P2P cache system.
.IP
.nf
\f[C]
dfcache stat <-i cid> [flags]
\f[R]
.fi
.EX
dfcache stat <\-i cid> [flags]
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for stat
-l, --local only check task exists locally, and don\[aq]t check other peers in P2P network
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for stat
\-l, \-\-local only check task exists locally, and don\[aq]t check other peers in P2P network
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,37 +1,30 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache version\f[R] \[em] show version
.SH SYNOPSIS
.PP
Show the version details of dragonfly.
.IP
.nf
\f[C]
.EX
dfcache version [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
-h, --help help for version
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
\-h, \-\-help help for version
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache - the P2P cache client of dragonfly
dfcache \- the P2P cache client of dragonfly

View File

@ -1,12 +1,9 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfcache\[rq] Documentation"
.SH NAME
.PP
\f[B]dfcache\f[R] \[em] the P2P cache client of dragonfly
.SH SYNOPSIS
.PP
dfcache is the cache client to of dragonfly that communicates with
dfdaemon and operates on files in P2P network, where the P2P network
acts as a cache system.
@ -20,40 +17,39 @@ user\[cq]s responsibility to go back to source and add file into P2P
network.
.SS OPTIONS
.IP
.nf
\f[C]
-i, --cid string content or cache ID, e.g. sha256 digest of the content
--config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
--console whether logger output records to the stdout
-h, --help help for dfcache
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--logdir string Dfcache log directory
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--service-name string name of the service for tracer (default \[dq]dragonfly-dfcache\[dq])
-t, --tag string different tags for the same cid will be recognized as different files in P2P network
--timeout duration Timeout for this cache operation, 0 is infinite
--verbose whether logger use debug level
--workhome string Dfcache working directory
\f[R]
.fi
.EX
\-i, \-\-cid string content or cache ID, e.g. sha256 digest of the content
\-\-config string the path of configuration file with yaml extension name, default is /etc/dragonfly/dfcache.yaml, it can also be set by env var: DFCACHE_CONFIG
\-\-console whether logger output records to the stdout
\-h, \-\-help help for dfcache
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-logdir string Dfcache log directory
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfcache\[dq])
\-t, \-\-tag string different tags for the same cid will be recognized as different files in P2P network
\-\-timeout duration Timeout for this cache operation, 0 is infinite
\-\-verbose whether logger use debug level
\-\-workhome string Dfcache working directory
.EE
.SH SEE ALSO
.IP \[bu] 2
dfcache completion - generate the autocompletion script for the
dfcache completion \- generate the autocompletion script for the
specified shell
.IP \[bu] 2
dfcache delete - delete file from P2P cache system
dfcache delete \- delete file from P2P cache system
.IP \[bu] 2
dfcache doc - generate documents
dfcache doc \- generate documents
.IP \[bu] 2
dfcache export - export file from P2P cache system
dfcache export \- export file from P2P cache system
.IP \[bu] 2
dfcache import - import file into P2P cache system
dfcache import \- import file into P2P cache system
.IP \[bu] 2
dfcache plugin - show plugin
dfcache plugin \- show plugin
.IP \[bu] 2
dfcache stat - stat checks if a file exists in P2P cache system
dfcache stat \- stat checks if a file exists in P2P cache system
.IP \[bu] 2
dfcache version - show version
dfcache version \- show version
.SH BUGS
.PP
See GitHub Issues: <https://github.com/dragonflyoss/dragonfly/issues>
See GitHub Issues: \c
.UR https://github.com/dragonflyoss/dragonfly/issues
.UE \c

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfcache" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfcache" Documentation
# NAME

View File

@ -1,13 +1,10 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFGET" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfget\[rq] Documentation"
.hy
.TH "DFGET" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfget\[rq] Documentation"
.SH NAME
.PP
\f[B]dfget\f[R] \[em] client of Dragonfly used to download and upload
files
.SH SYNOPSIS
.PP
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
@ -19,38 +16,37 @@ functionality, such as network bandwidth limit, transmission encryption
and so on.
.SS OPTIONS
.IP
.nf
\f[C]
--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 \[aq]key\[aq] and \[aq]sign\[aq] query parameters
-H, --header strings url header, eg: --header=\[aq]Accept: *\[aq] --header=\[aq]Host: abc\[aq]
-h, --help help for dfget
--jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
--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
--pprof-port int listen port for pprof, 0 represents random port (default -1)
--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 \[dq]100.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
--service-name string name of the service for tracer (default \[dq]dragonfly-dfget\[dq])
-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\[aq]s first position argument
--verbose whether logger use debug level
--workhome string Dfget working directory
\f[R]
.fi
.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 \[aq]key\[aq] and \[aq]sign\[aq] query parameters
\-H, \-\-header strings url header, eg: \-\-header=\[aq]Accept: *\[aq] \-\-header=\[aq]Host: abc\[aq]
\-h, \-\-help help for dfget
\-\-jaeger string jaeger endpoint url, like: http://localhost:14250/api/traces
\-\-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
\-\-pprof\-port int listen port for pprof, 0 represents random port (default \-1)
\-\-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 \[dq]100.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
\-\-service\-name string name of the service for tracer (default \[dq]dragonfly\-dfget\[dq])
\-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\[aq]s first position argument
\-\-verbose whether logger use debug level
\-\-workhome string Dfget working directory
.EE
.SH BUGS
.PP
See GitHub Issues: <https://github.com/dragonflyoss/dragonfly/issues>
See GitHub Issues: \c
.UR https://github.com/dragonflyoss/dragonfly/issues
.UE \c

View File

@ -1,4 +1,4 @@
% DFGET(1) Version v2.1.0 | Frivolous "Dfget" Documentation
% DFGET(1) Version v2.2.0 | Frivolous "Dfget" Documentation
# NAME

View File

@ -1,32 +1,25 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.SH NAME
.PP
\f[B]dfstore cp\f[R] \[em] copies a local file or dragonfly object to
another location locally or in dragonfly object storage
.SH SYNOPSIS
.PP
Copies a local file or dragonfly object to another location locally or
in dragonfly object storage.
.IP
.nf
\f[C]
.EX
dfstore cp <source> <target> [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
--filter string filter is used to generate a unique task id by filtering unnecessary query params in the URL, it is separated by & character
-h, --help help for cp
--max-replicas int maxReplicas is the maximum number of replicas of an object cache in seed peers (default 3)
-m, --mode int mode is the mode in which the backend is written, when the value is 0, it represents AsyncWriteBack, and when the value is 1, it represents WriteBack
-e, --endpoint string endpoint of object storage service (default \[dq]http://127.0.0.1:65004\[dq])
\f[R]
.fi
.EX
\-\-filter string filter is used to generate a unique task id by filtering unnecessary query params in the URL, it is separated by & character
\-h, \-\-help help for cp
\-\-max\-replicas int maxReplicas is the maximum number of replicas of an object cache in seed peers (default 3)
\-m, \-\-mode int mode is the mode in which the backend is written, when the value is 0, it represents AsyncWriteBack, and when the value is 1, it represents WriteBack
\-e, \-\-endpoint string endpoint of object storage service (default \[dq]http://127.0.0.1:65004\[dq])
.EE
.SH SEE ALSO
.IP \[bu] 2
dfstore - object storage client of dragonfly
dfstore \- object storage client of dragonfly

View File

@ -1,27 +1,20 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.SH NAME
.PP
\f[B]dfstore rm\f[R] \[em] remove object from P2P storage system
.SH SYNOPSIS
.PP
Remove object from P2P storage system.
.IP
.nf
\f[C]
.EX
dfstore rm <target> [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-h, --help help for rm
-e, --endpoint string endpoint of object storage service (default \[dq]http://127.0.0.1:65004\[dq])
\f[R]
.fi
.EX
\-h, \-\-help help for rm
\-e, \-\-endpoint string endpoint of object storage service (default \[dq]http://127.0.0.1:65004\[dq])
.EE
.SH SEE ALSO
.IP \[bu] 2
dfstore - object storage client of dragonfly
dfstore \- object storage client of dragonfly

View File

@ -1,26 +1,19 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.SH NAME
.PP
\f[B]dfstore version\f[R] \[em] show version
.SH SYNOPSIS
.PP
Show the version details of dragonfly.
.IP
.nf
\f[C]
.EX
dfstore version [flags]
\f[R]
.fi
.EE
.SS OPTIONS
.IP
.nf
\f[C]
-h, --help help for rm
\f[R]
.fi
.EX
\-h, \-\-help help for rm
.EE
.SH SEE ALSO
.IP \[bu] 2
dfstore - object storage client of dragonfly
dfstore \- object storage client of dragonfly

View File

@ -1,12 +1,9 @@
.\" Automatically generated by Pandoc 2.13
.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "DFCACHE" "1" "" "Version v2.1.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.hy
.TH "DFCACHE" "1" "" "Version v2.2.0" "Frivolous \[lq]Dfstore\[rq] Documentation"
.SH NAME
.PP
\f[B]dfstore\f[R] \[em] object storage client of dragonfly
.SH SYNOPSIS
.PP
Dfstore is a storage client for dragonfly.
It can rely on different types of object storage, such as S3 or OSS, to
provide stable object storage capabilities dfstore uses the entire P2P
@ -16,19 +13,18 @@ In the process of object storage, P2P Cache is effectively used for fast
read and write storage.
.SS OPTIONS
.IP
.nf
\f[C]
-h, --help help for rm
\f[R]
.fi
.EX
\-h, \-\-help help for rm
.EE
.SH SEE ALSO
.IP \[bu] 2
dfstore copy - copies a local file or dragonfly object to another
dfstore copy \- copies a local file or dragonfly object to another
location locally or in dragonfly object storage
.IP \[bu] 2
dfcache remove - remove object from P2P storage system
dfcache remove \- remove object from P2P storage system
.IP \[bu] 2
dfcache version - show version
dfcache version \- show version
.SH BUGS
.PP
See GitHub Issues: <https://github.com/dragonflyoss/dragonfly/issues>
See GitHub Issues: \c
.UR https://github.com/dragonflyoss/dragonfly/issues
.UE \c

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfstore" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfstore" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfstore" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfstore" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfstore" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfstore" Documentation
# NAME

View File

@ -1,4 +1,4 @@
% DFCACHE(1) Version v2.1.0 | Frivolous "Dfstore" Documentation
% DFCACHE(1) Version v2.2.0 | Frivolous "Dfstore" Documentation
# NAME

@ -1 +1 @@
Subproject commit 568967dab265f575c98e81ae21bf868e61ea8ddd
Subproject commit 169fca5fe39aac1b69628c5423c42dc4b52d3679

@ -1 +1 @@
Subproject commit 240d603106cfc02cbae24f100e66fac4ce756bfa
Subproject commit a36ebca04b84e09ef31b05d87b51bed6375bf165

@ -1 +1 @@
Subproject commit 57803a54c021c2b188f95a36265b10afb671c3cd
Subproject commit 4252f20ef4d7c22f2f5539d3137a17ff82c4028f

View File

@ -23,7 +23,7 @@ import (
var (
Major = "2"
Minor = "0"
GitVersion = "v2.1.0"
GitVersion = "v2.2.0"
GitCommit = "unknown"
Platform = osArch
BuildTime = "unknown"