Lines Matching +full:- +full:- +full:without +full:- +full:zstd

2 .TH "ZSTD" "1" "March 2024" "zstd 1.5.6" "User Commands"
5 \fBzstd\fR \- zstd, zstdmt, unzstd, zstdcat \- Compress or decompress \.zst files
8 \fBzstd\fR [\fIOPTIONS\fR] [\-|\fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR]
11 \fBzstdmt\fR is equivalent to \fBzstd \-T0\fR
14 \fBunzstd\fR is equivalent to \fBzstd \-d\fR
17 \fBzstdcat\fR is equivalent to \fBzstd \-dcf\fR
20 …zstd\fR is a fast lossless compression algorithm and data compression tool, with command line synt…
23 \fBzstd\fR command line syntax is generally similar to gzip, but features the following few differe…
26 …served by default\. It\'s possible to remove them automatically by using the \fB\-\-rm\fR command\.
29 When compressing a single file, \fBzstd\fR displays progress notifications and result summary by de…
32 \fBzstd\fR displays a short help page when command line is an error\. Use \fB\-q\fR to turn it off\.
35 \fBzstd\fR does not accept input from console, though it does accept \fBstdin\fR when it\'s not the…
38 \fBzstd\fR does not store the input\'s filename or attributes, only its contents\.
43 …zstd\fR processes each \fIfile\fR according to the selected operation mode\. If no \fIfiles\fR are…
46 Unless \fB\-\-stdout\fR or \fB\-o\fR is specified, \fIfiles\fR are written to a new file whose name…
57 It is possible to concatenate multiple \fB\.zst\fR files\. \fBzstd\fR will decompress such agglomer…
76 \fB\-z\fR, \fB\-\-compress\fR
77 …on mode is implied from the command name (for example, \fBunzstd\fR implies \fB\-\-decompress\fR)\.
80 \fB\-d\fR, \fB\-\-decompress\fR, \fB\-\-uncompress\fR
84 \fB\-t\fR, \fB\-\-test\fR
85 Test the integrity of compressed \fIfiles\fR\. This option is equivalent to \fB\-\-decompress \-\-s…
88 \fB\-b#\fR
92 \fB\-\-train FILES\fR
96 \fB\-l\fR, \fB\-\-list\fR
97 …zstd compressed file, such as size, ratio, and checksum\. Some of these fields may not be availabl…
102 \fB\-#\fR: selects \fB#\fR compression level [1\-19] (default: 3)\. Higher compression levels \fIge…
105 \fB\-\-ultra\fR: unlocks high compression levels 20+ (maximum 22), using a lot more memory\. Note t…
108 …-\-fast[=#]\fR: switch to ultra\-fast compression levels\. If \fB=#\fR is not present, it defaults…
111 …-T#\fR, \fB\-\-threads=#\fR: Compress using \fB#\fR working threads (default: 1)\. If \fB#\fR is 0…
114 …-\-single\-thread\fR: Use a single thread for both I/O and compression\. As compression is seriali…
120 …ent from \fB\-T1\fR, which spawns 1 compression thread in parallel with I/O\. Final compressed res…
123 \fB\-\-auto\-threads={physical,logical} (default: physical)\fR: When using a default amount of thre…
126 …-\-adapt[=min=#,max=#]\fR: \fBzstd\fR will dynamically adapt compression level to perceived I/O co…
129 \fINote\fR: at the time of this writing, \fB\-\-adapt\fR can remain stuck at low speed when combine…
132 \fB\-\-long[=#]\fR: enables long distance matching with \fB#\fR \fBwindowLog\fR, if \fB#\fR is not …
135 Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=window…
138 \fB\-D DICT\fR: use \fBDICT\fR as Dictionary to compress or decompress FILE(s)
141 \fB\-\-patch\-from FILE\fR: Specify the file to be used as a reference point for zstd\'s diff engin…
144 Note: cannot use both this and \fB\-D\fR together\.
147 Note: \fB\-\-long\fR mode will be automatically activated if \fIchainLog\fR < \fIfileLog\fR (\fIfil…
150 Note: for all levels, you can use \fB\-\-patch\-from\fR in \fB\-\-single\-thread\fR mode to improve…
153 … of speed by specifying \fB\-\-zstd=targetLength=\fR to be something large (i\.e\. 4096), and by s…
156 …-\-rsyncable\fR: \fBzstd\fR will periodically synchronize the compression state to make the compre…
159 \fB\-C\fR, \fB\-\-[no\-]check\fR: add integrity check computed from uncompressed data (default: ena…
162 …-\-[no\-]content\-size\fR: enable / disable whether or not the original size of the file is placed…
165 \fB\-\-no\-dictID\fR: do not store dictionary ID within frame header (dictionary compression)\. The…
168 \fB\-M#\fR, \fB\-\-memory=#\fR: Set a memory usage limit\. By default, \fBzstd\fR uses 128 MiB for …
171 This is also used during compression when using with \fB\-\-patch\-from=\fR\. In this case, this pa…
174 …ctionary training\. This parameter overrides the default limit of 2 GiB\. zstd will load training …
177 \fB\-\-stream\-size=#\fR: Sets the pledged source size of input coming from a stream\. This value m…
180 \fB\-\-size\-hint=#\fR: When handling input from a stream, \fBzstd\fR must guess how large the sour…
183 \fB\-\-target\-compressed\-block\-size=#\fR: Attempt to produce compressed blocks of approximately …
186 …-f\fR, \fB\-\-force\fR: disable input and output checks\. Allows overwriting existing files, input…
189 \fB\-c\fR, \fB\-\-stdout\fR: write to standard output (even if it is the console); keep original fi…
192 \fB\-o FILE\fR: save result into \fBFILE\fR\. Note that this operation is in conflict with \fB\-c\f…
195 \fB\-\-[no\-]sparse\fR: enable / disable sparse FS support, to make files with many zeroes smaller …
198 …-\-[no\-]pass\-through\fR enable / disable passing through uncompressed files as\-is\. During deco…
201 …-\-rm\fR: remove source file(s) after successful compression or decompression\. This command is si…
204 \fB\-k\fR, \fB\-\-keep\fR: keep source file(s) after successful compression or decompression\. This…
207 \fB\-r\fR: operate recursively on directories\. It selects all files in the named directory and all…
210 \fB\-\-filelist FILE\fR read a list of files to process as content from \fBFILE\fR\. Format is comp…
213 …-\-output\-dir\-flat DIR\fR: resulting files are stored into target \fBDIR\fR directory, instead o…
216 \fB\-\-output\-dir\-mirror DIR\fR: similar to \fB\-\-output\-dir\-flat\fR, the output files are sto…
219 …ut\-dir/var/tmp/abc"\. If there are multiple input files or directories, name collision resolution…
222 …-\-format=FORMAT\fR: compress and decompress in other formats\. If compiled with support, zstd can…
225 \fB\-h\fR/\fB\-H\fR, \fB\-\-help\fR: display help/long help and exit
228 …-V\fR, \fB\-\-version\fR: display version number and immediately exit\. note that, since it exits,…
231 \fB\-v\fR, \fB\-\-verbose\fR: verbose mode, display more information
234 \fB\-q\fR, \fB\-\-quiet\fR: suppress warnings, interactivity, and notifications\. specify twice to …
237 \fB\-\-no\-progress\fR: do not display the progress bar, but keep all other messages\.
240 \fB\-\-show\-default\-cparams\fR: shows the default compression parameters that will be used for a …
243 \fB\-\-exclude\-compressed\fR: only compress files that are not already compressed\.
246 \fB\-\-\fR: All arguments after \fB\-\-\fR are treated as files
251 When invoked via a \fBgzip\fR symlink, \fBzstd\fR will support further options that intend to mimic…
254 \fB\-n\fR, \fB\-\-no\-name\fR
255 …filename and timestamps when compressing a file\. This is the default behavior and hence a no\-op\.
258 \fB\-\-best\fR
259 alias to the option \fB\-9\fR\.
268 …zstd\fR will attempt to use during compression\. If the value of \fBZSTD_NBTHREADS\fR is not a val…
271 …e overridden by corresponding command line arguments: \fB\-#\fR for compression level and \fB\-T#\…
274 …zstd\fR provides 22 predefined regular compression levels plus the fast levels\. A compression lev…
276 .SS "\-\-zstd[=options]:"
277 The \fIoptions\fR are provided as a comma\-separated list\. You may specify only the options you wa…
291 …wlog\fR is 10 (1 KiB) and the maximum is 30 (1 GiB) on 32\-bit platforms and 31 (2 GiB) on 64\-bit…
294 Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=window…
314 …and the maximum is 29 (512M entries / 2 GiB) on 32\-bit platforms and 30 (1B entries / 4 GiB) on 6…
324 The minimum \fIslog\fR is 1 and the maximum is \'windowLog\' \- 1\.
344 For \fBZSTD_fast\fR, it triggers ultra\-fast mode when > 0\. The value represents the amount of dat…
357 …pecial and means "default": \fIovlog\fR is automatically determined by \fBzstd\fR\. In which case,…
409 The default value is \fBwlog \- lhlog\fR\.
415 \fB\-\-zstd\fR=wlog=23,clog=23,hlog=22,slog=6,mml=3,tlen=48,strat=6
417 .SS "\-B#:"
418 …-threading is enabled\. Each compression job is run in parallel, so this value indirectly impacts …
421 …zstd\fR offers \fIdictionary\fR compression, which greatly improves efficiency on small files and …
424 \fB\-\-train FILEs\fR
425 …size (for example, ~10 MB for a 100 KB dictionary)\. \fB\-\-train\fR can be combined with \fB\-r\f…
431 …-\-train\fR supports multithreading if \fBzstd\fR is compiled with threading support (default)\. A…
434 \fB\-o FILE\fR
438 \fB\-\-maxdict=#\fR
442 \fB\-#\fR
446 \fB\-B#\fR
450 \fB\-M#\fR, \fB\-\-memory=#\fR
457 \fB\-\-dictID=#\fR
458 …s value to verify it is using the right dictionary\. By default, zstd will create a 4\-bytes rando…
464 \fB\-\-train\-cover[=k#,d=#,steps=#,split=#,shrink[=#]]\fR
468 …l \fId\fR and \fIk\fR to build dictionary\. Supports multithreading if \fBzstd\fR is compiled with…
474 \fBzstd \-\-train\-cover FILEs\fR
477 \fBzstd \-\-train\-cover=k=50,d=8 FILEs\fR
480 \fBzstd \-\-train\-cover=d=8,steps=500 FILEs\fR
483 \fBzstd \-\-train\-cover=k=50 FILEs\fR
486 \fBzstd \-\-train\-cover=k=50,split=60 FILEs\fR
489 \fBzstd \-\-train\-cover=shrink FILEs\fR
492 \fBzstd \-\-train\-cover=shrink=2 FILEs\fR
495 \fB\-\-train\-fastcover[=k#,d=#,f=#,steps=#,split=#,accel=#]\fR
499 …e \fId\fR\. The subsegment is hashed to an index in the range [0,2^\fIf\fR \- 1]\. It is possible …
505 \fBzstd \-\-train\-fastcover FILEs\fR
508 \fBzstd \-\-train\-fastcover=d=8,f=15,accel=2 FILEs\fR
511 \fB\-\-train\-legacy[=selectivity=#]\fR
512 …mproving its efficiency but reducing its achievable maximum size\. \fB\-\-train\-legacy=s=#\fR is …
518 \fBzstd \-\-train\-legacy FILEs\fR
521 \fBzstd \-\-train\-legacy=selectivity=8 FILEs\fR
524 The \fBzstd\fR CLI provides a benchmarking mode that can be used to easily find suitable compressio…
527 \fB\-b#\fR
531 \fB\-e#\fR
532 benchmark file(s) using multiple compression levels, from \fB\-b#\fR to \fB\-e#\fR (inclusive)
535 \fB\-d\fR
536 benchmark decompression speed only (requires providing an already zstd\-compressed content)
539 \fB\-i#\fR
543 \fB\-B#\fR, \fB\-\-block\-size=#\fR
547 \fB\-\-priority=rt\fR
548 set process priority to real\-time (Windows)
551 \fBOutput Format:\fR CompressionLevel#Filename: InputSize \-> OutputSize (CompressionRatio), Compre…
554 …ion and decompression speed, the entire input is compressed/decompressed in\-memory to measure spe…
560 … is specified in Y\. Collet, "Zstandard Compression and the \'application/zstd\' Media Type", http…
563 Report bugs at: https://github\.com/facebook/zstd/issues