d2dbb8c963
* cli: initial work on debug; server-status target * debug: add metrics capture target (#7376) * check against DR secondary * debug: add compression * refactor check into preflight func * debug: set short test time on tests, fix exit code bug * debug: use temp dir for output on tests * debug: use mholt/archiver for compression * first pass on adding pprof * use logger for output * refactor polling target capture logic * debug: poll and collect replication status * debug: poll and collect host-info; rename output files and collection refactor * fix comments * add archive test; fix bugs found * rename flag name to singular target * add target output test; scaffold other tests cases * debug/test: add pprof and index file tests * debug/test: add min timing check tests * debug: fix index gen race and collection goroutine race * debug: extend archive tests, handle race between program exit and polling goroutines * update docstring * debug: correctly add to pollingWg * debug: add config target support * debug: don't wait on interrupt shutdown; add file exists unit tests * move pprof bits into its goroutine * debug: skip empty metrics and some pprof file creation if permission denied, add matching unit test * address comments and feedback * Vault debug using run.Group (#7658) * debug: switch to use oklog/run.Group * debug: use context to cancel requests and interrupt rungroups. * debug: trigger the first interval properly * debug: metrics collection should use metrics interval * debug: add missing continue on metrics error * debug: remove the use of buffered chan to trigger first interval * debug: don't shadow BaseCommand's client, properly block on interval capture failures * debug: actually use c.cachedClient everywhere * go mod vendor * debug: run all pprof in goroutines; bump pprof timings in tests to reduce flakiness * debug: update help text
36 lines
1.2 KiB
Go
36 lines
1.2 KiB
Go
// Package xz implements XZ decompression natively in Go.
|
|
//
|
|
// Usage
|
|
//
|
|
// For ease of use, this package is designed to have a similar API to
|
|
// compress/gzip. See the examples for further details.
|
|
//
|
|
// Implementation
|
|
//
|
|
// This package is a translation from C to Go of XZ Embedded
|
|
// (http://tukaani.org/xz/embedded.html) with enhancements made so as
|
|
// to implement all mandatory and optional parts of the XZ file format
|
|
// specification v1.0.4. It supports all filters and block check
|
|
// types, supports multiple streams, and performs index verification
|
|
// using SHA-256 as recommended by the specification.
|
|
//
|
|
// Speed
|
|
//
|
|
// On the author's Intel Ivybridge i5, decompression speed is about
|
|
// half that of the standard XZ Utils (tested with a recent linux
|
|
// kernel tarball).
|
|
//
|
|
// Thanks
|
|
//
|
|
// Thanks are due to Lasse Collin and Igor Pavlov, the authors of XZ
|
|
// Embedded, on whose code package xz is based. It would not exist
|
|
// without their decision to allow others to modify and reuse their
|
|
// code.
|
|
//
|
|
// Bug reports
|
|
//
|
|
// For bug reports relating to this package please contact the author
|
|
// through https://github.com/xi2/xz/issues, and not the authors of XZ
|
|
// Embedded.
|
|
package xz
|