"Fossies" - the Fresh Open Source Software Archive

Member "littleutils-1.2.4/scripts/to-lzma.1" (28 Mar 2021, 3085 Bytes) of package /linux/privat/littleutils-1.2.4.tar.lz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 .TH TO-LZMA 1 "2021 Jan 15" littleutils
    2 .SH NAME
    3 to-lzma \- converts .Z, .lzo, .zip, .rar, .gz, and .bz2 files to lzma format
    4 (DEPRECATED)
    5 .SH SYNOPSIS
    6 \fBto-lzma\fR
    7 [\fB\-(IPv)4\fR]
    8 [\fB\-(IPv)6\fR]
    9 [\fB\-d(elete_original)\fR]
   10 [\fB\-h(elp)\fR]
   11 [\fB\-k(eep_smallest)\fR]
   12 [\fB\-m(ax_compress)\fR]
   13 [\fB\-n(o_overwrite)\fR]
   14 [\fB\-p\fR\~\fInum_cores\fR]
   15 [\fB\-t(imestamp_retain)\fR]
   16 \fIfile/URL\|.\|.\|.\fR
   17 .SH DESCRIPTION
   18 \fBto-lzma\fR recompresses files compressed with the \fBcompress\fR,
   19 \fBlzop\fR, \fBzip\fR, \fBgzip\fR, \fBbzip2\fR, and/or \fBzstd\fR utilities
   20 into \fIlzma\fR format.  The newly compressed files will usually have a
   21 \fI.lzma\fR or a \fI.tlz\fR extension.  If a specified file is actually a URL,
   22 it will be downloaded using \fBwget\fR and then recompressed.
   23 .SH OPTIONS
   24 .TP
   25 \fB\-4\fR
   26 Prefer IPv4 when downloading a URL.
   27 .TP
   28 \fB\-6\fR
   29 Prefer IPv6 when downloading a URL.
   30 .TP
   31 \fB\-d\fR
   32 After each file is compressed, delete the original.
   33 .TP
   34 \fB\-h\fR
   35 Print help and quit.
   36 .TP
   37 \fB\-k\fR
   38 Once a file is successfully recompressed, delete the larger of the original
   39 file or the new one.  This option maximizes disk space savings and is
   40 incompatible with the \fB\-d\fR option.
   41 .TP
   42 \fB\-m\fR
   43 Compress more, but at the expense of increased CPU time and memory usage.
   44 .TP
   45 \fB\-n\fR
   46 Do not overwrite the target \fI.lzma\fR or \fI.tlz\fR file if it already exists.
   47 .TP
   48 \fB\-p\fR\~\fInum_cores\fR
   49 Use the multi-threaded \fB-T\fR option of \fBlzma\fR to utilize multiple cores
   50 during compression.  Note that the output file, while being fully compatible
   51 with unthreaded \fBlzma\fR, will generally be slightly larger.  Specifying a
   52 \fInum_cores\fR value of zero will utilize all available cores.  This option
   53 has no effect if the alternate \fBlzma_alone\fR compression engine is used.
   54 .TP
   55 \fB\-t\fR
   56 Make the timestamp of new files match those of the old files.
   57 .SH "NOTES"
   58 Note that the .lzma file format is a raw LZMA compressed data stream.  It has
   59 been deprecated in favor of the .lz and .xz files produced by \fBlzip\fR and
   60 \fBxz\fR, respectively.  These newer file formats feature identifying magic
   61 bytes and CRC-based integrity checks, and using one of them instead of .lzma is
   62 strongly recommended.  The author prefers \fBlzip\fR, as it compresses slightly
   63 better and has a simpler and arguably superior file format.
   64 .SH "SEE ALSO"
   65 \fBlzma\fR(1), \fBlzma_alone\fR(1), \fBcompress\fR(1), \fBzip\fR(1),
   66 \fBgzip\fR(1), \fBlzop\fR(1), \fBbzip2\fR(1), \fBzstd\fR(1),
   67 \fBrar2tarcat\fR(1), \fBzip2tarcat\fR(1), \fBlzip\fR(1), \fBxz\fR(1),
   68 \fBwget\fR(1)
   69 .SH COPYRIGHT
   70 Copyright (C) 2006-2021 by Brian Lindholm.  This program is free software; you
   71 can use it, redistribute it, and/or modify it under the terms of the GNU
   72 General Public License as published by the Free Software Foundation; either
   73 version 3, or (at your option) any later version.
   74 
   75 This program is distributed in the hope that it will be useful, but WITHOUT ANY
   76 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   77 PARTICULAR PURPOSE.  See the GNU General Public License for more details.