"Fossies" - the Fresh Open Source Software Archive

Member "littleutils-1.2.4/scripts/to-xz.1" (28 Mar 2021, 2518 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-XZ 1 "2021 Jan 15" littleutils
    2 .SH NAME
    3 to-xz \- converts .Z, .lzo, .gz, .zip, .rar, .bz2, .zst, and .lzma files to xz
    4 format
    5 .SH SYNOPSIS
    6 \fBto-xz\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-xz\fR recompresses files compressed with the \fBcompress\fR, \fBlzop\fR,
   19 \fBzip\fR, \fBgzip\fR, \fBbzip2\fR, \fBzstd\fR, and/or \fBlzma(_alone)\fR
   20 utilities into \fIxz\fR format.  The newly compressed files will usually have a
   21 \fI.xz\fR or a \fI.txz\fR extension.  If a specified file is actually a URL, it
   22 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.xz\fR or \fI.txz\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 \fBxz\fR to utilize multiple cores
   50 during compression.  Note that the output file, while being fully compatible
   51 with unthreaded \fBxz\fR, will generally be slightly larger.  Specifying a
   52 \fInum_cores\fR value of zero will utilize all available cores.
   53 .TP
   54 \fB\-t\fR
   55 Make the timestamp of new files match those of the old files.
   56 
   57 \fBxz\fR(1), \fBcompress\fR(1), \fBlzop\fR(1), \fBzip\fR(1), \fBgzip\fR(1),
   58 \fBbzip2\fR(1), \fBzstd\fR(1), \fBlzma\fR(1), \fBlzma_alone\fR(1),
   59 \fBrar2tarcat\fR(1), \fBzip2tarcat\fR(1), \fBwget\fR(1)
   60 .SH COPYRIGHT
   61 Copyright (C) 2009-2021 by Brian Lindholm and D. Gloger.  This program is free
   62 software; you can use it, redistribute it, and/or modify it under the terms of
   63 the GNU General Public License as published by the Free Software Foundation;
   64 either version 3, or (at your option) any later version.
   65 
   66 This program is distributed in the hope that it will be useful, but WITHOUT ANY
   67 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   68 PARTICULAR PURPOSE.  See the GNU General Public License for more details.