summaryrefslogtreecommitdiff
path: root/doc/lzop.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lzop.1')
-rw-r--r--doc/lzop.1611
1 files changed, 611 insertions, 0 deletions
diff --git a/doc/lzop.1 b/doc/lzop.1
new file mode 100644
index 0000000..3b035e5
--- /dev/null
+++ b/doc/lzop.1
@@ -0,0 +1,611 @@
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings. \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote. \*(C+ will
+.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+. ds -- \(*W-
+. ds PI pi
+. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+. ds L" ""
+. ds R" ""
+. ds C` ""
+. ds C' ""
+'br\}
+.el\{\
+. ds -- \|\(em\|
+. ds PI \(*p
+. ds L" ``
+. ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
+..
+. nr % 0
+. rr F
+.\}
+.el \{\
+. de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear. Run. Save yourself. No user-serviceable parts.
+. \" fudge factors for nroff and troff
+.if n \{\
+. ds #H 0
+. ds #V .8m
+. ds #F .3m
+. ds #[ \f1
+. ds #] \fP
+.\}
+.if t \{\
+. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+. ds #V .6m
+. ds #F 0
+. ds #[ \&
+. ds #] \&
+.\}
+. \" simple accents for nroff and troff
+.if n \{\
+. ds ' \&
+. ds ` \&
+. ds ^ \&
+. ds , \&
+. ds ~ ~
+. ds /
+.\}
+.if t \{\
+. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+. \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+. \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+. \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+. ds : e
+. ds 8 ss
+. ds o a
+. ds d- d\h'-1'\(ga
+. ds D- D\h'-1'\(hy
+. ds th \o'bp'
+. ds Th \o'LP'
+. ds ae ae
+. ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "LZOP 1"
+.TH LZOP 1 "2010-11-06" "lzop 1.03" " "
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+lzop \- compress or expand files
+.SH "ABSTRACT"
+.IX Header "ABSTRACT"
+\&\fBlzop\fR is a file compressor very similar to \fBgzip\fR.
+\&\fBlzop\fR favors speed over compression ratio.
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fBlzop\fR [\ \fIcommand\fR\ ] [\ \fIoptions\fR\ ] [\ \fIfilename\fR\ ...\ \ ]
+.PP
+\&\fBlzop\fR [\fB\-dxlthIVL19\fR] [\fB\-qvcfFnNPkU\fR]
+[\fB\-o\fR\ \fIfile\fR] [\fB\-p\fR[\fIpath\fR]] [\fB\-S\fR\ \fIsuffix\fR]
+[\fIfilename\fR\ ...]
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+\&\fBlzop\fR reduces the size of the named files. Whenever possible,
+each file is compressed into one with the extension
+\&\fB.lzo\fR, while keeping the same ownership modes, access and
+modification times. If no files are specified, or if a
+file name is \*(L"\-\*(R", lzop tries to compress the standard
+input to the standard output. lzop will only attempt to
+compress regular files or symbolic links to regular files.
+In particular, it will ignore directories.
+.PP
+If the compressed file name is too long for its file system,
+\&\fBlzop\fR truncates it.
+.PP
+Compressed files can be restored to their original form
+using \fBlzop\ \-d\fR.
+\&\fBlzop\ \-d\fR takes a list of files on its command line and
+decompresses each file whose name ends with \fB.lzo\fR and which
+begins with the correct magic number to an uncompressed
+file without the original extension. \fBlzop\ \-d\fR also recognizes
+the special extension \fB.tzo\fR as shorthand for \fB.tar.lzo\fR.
+When compressing, lzop uses the \fB.tzo\fR extension if necessary
+instead of truncating a file with a \fB.tar\fR extension.
+.PP
+\&\fBlzop\fR stores the original file name, mode and time stamp
+in the compressed file. These can be used when
+decompressing the file with the \fB\-d\fR option. This is useful when
+the compressed file name was truncated or when the time
+stamp was not preserved after a file transfer.
+.PP
+\&\fBlzop\fR preserves the ownership, mode and time stamp of files
+when compressing. When decompressing lzop restores the
+mode and time stamp if present in the compressed files.
+See the options \fB\-n\fR, \fB\-N\fR, \fB\-\-no\-mode\fR and \fB\-\-no\-time\fR
+for more information.
+.PP
+\&\fBlzop\fR always keeps original files unchanged unless
+you use the option \fB\-U\fR.
+.PP
+\&\fBlzop\fR uses the \fI\s-1LZO\s0 data compression library\fR for compression
+services. The amount of compression obtained depends on
+the size of the input and the distribution of common substrings.
+Typically, text such as source code or English
+is compressed into 40\-50% of the original size, and large files usually
+compress much better than small ones. Compression and decompression speed
+is generally much faster than that achieved by \fBgzip\fR, but
+compression ratio is worse.
+.SS "\s-1COMPRESSION\s0 \s-1LEVELS\s0"
+.IX Subsection "COMPRESSION LEVELS"
+lzop offers the following compression levels of the
+\&\s-1LZO1X\s0 algorithm:
+.IP "\-3" 4
+.IX Item "-3"
+the default level offers pretty fast compression.
+\&\-2, \-3, \-4, \-5 and \-6 are currently all equivalent \- this
+may change in a future release.
+.IP "\-1, \-\-fast" 4
+.IX Item "-1, --fast"
+can be even a little bit faster in some cases \- but
+most times you won't notice the difference
+.IP "\-7, \-8, \-9, \-\-best" 4
+.IX Item "-7, -8, -9, --best"
+these compression levels are mainly intended for generating
+pre-compressed data \- especially \fB\-9\fR can be somewhat slow
+.PP
+Decompression is \fIvery\fR fast for all compression levels,
+and decompression speed is not affected by the compression
+level.
+.SH "MAIN COMMAND"
+.IX Header "MAIN COMMAND"
+If no other command is given then lzop defaults to compression
+(using compression level \-3).
+.IP "\-#, \-\-fast, \-\-best" 4
+.IX Item "-#, --fast, --best"
+Regulate the speed of compression using the specified
+digit \fB#\fR, where \-1 or \-\-fast indicates the
+fastest compression method (less compression) and
+\&\-9 or \-\-best indicates the slowest compression
+method (best compression). The default compression
+level is \-3.
+.IP "\-d, \-\-decompress, \-\-uncompress" 4
+.IX Item "-d, --decompress, --uncompress"
+Decompress. Each file will be placed into
+same the directory as the compressed file.
+.IP "\-x, \-\-extract" 4
+.IX Item "-x, --extract"
+Extract compressed files to the current working
+directory. This is the same as '\-dPp'.
+.IP "\-t, \-\-test" 4
+.IX Item "-t, --test"
+Test. Check the compressed file integrity.
+.IP "\-l, \-\-list" 4
+.IX Item "-l, --list"
+For each compressed file, list the following
+fields:
+.Sp
+.Vb 5
+\& method: compression method
+\& compressed: size of the compressed file
+\& uncompr.: size of the uncompressed file
+\& ratio: compression ratio
+\& uncompressed_name: name of the uncompressed file
+.Ve
+.Sp
+In combination with the \-\-verbose option, the following
+fields are also displayed:
+.Sp
+.Vb 1
+\& date & time: time stamp for the uncompressed file
+.Ve
+.Sp
+With \-\-name, the uncompressed name, date and time
+are those stored within the compress file if present.
+.Sp
+With \-\-verbose, the size totals and compression
+ratio for all files is also displayed. With
+\&\-\-quiet, the title and totals lines are not displayed.
+.Sp
+Note that lzop defines compression ratio
+as compressed_size / uncompressed_size.
+.IP "\-\-ls, \-\-ls=\fI\s-1FLAGS\s0\fR" 4
+.IX Item "--ls, --ls=FLAGS"
+List each compressed file in a format similar to \fBls\ \-ln\fR.
+.Sp
+The following flags are currently honoured:
+ F Append a '*' for executable files.
+ G Inhibit display of group information.
+ Q Enclose file names in double quotes.
+.IP "\-\-info" 4
+.IX Item "--info"
+For each compressed file, list the internal header fields.
+.IP "\-I, \-\-sysinfo" 4
+.IX Item "-I, --sysinfo"
+Display information about the system and quit.
+.IP "\-L, \-\-license" 4
+.IX Item "-L, --license"
+Display the lzop license and quit.
+.IP "\-h, \-H, \-\-help" 4
+.IX Item "-h, -H, --help"
+Display a help screen and quit.
+.IP "\-V" 4
+.IX Item "-V"
+Version. Display the version number and compilation
+options and quit.
+.IP "\-\-version" 4
+.IX Item "--version"
+Version. Display the version number and quit.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\-c, \-\-stdout, \-\-to\-stdout" 4
+.IX Item "-c, --stdout, --to-stdout"
+Write output on standard output. If there are several
+input files, the output consists of a sequence
+of independently (de)compressed members. To obtain
+better compression, concatenate all input files
+before compressing them.
+.IP "\-o \fI\s-1FILE\s0\fR, \-\-output=\fI\s-1FILE\s0\fR" 4
+.IX Item "-o FILE, --output=FILE"
+Write output to the file \fI\s-1FILE\s0\fR. If there are several
+input files, the output consists of a sequence
+of independently (de)compressed members.
+.IP "\-p, \-p\fI\s-1DIR\s0\fR, \-\-path=\fI\s-1DIR\s0\fR" 4
+.IX Item "-p, -pDIR, --path=DIR"
+Write output files into the directory \fI\s-1DIR\s0\fR instead
+of the directory determined by the input file. If
+\&\fI\s-1DIR\s0\fR is omitted, then write to the current working
+directory.
+.IP "\-f, \-\-force" 4
+.IX Item "-f, --force"
+Force lzop to
+.Sp
+.Vb 4
+\& \- overwrite existing files
+\& \- (de\-)compress from stdin even if it seems a terminal
+\& \- (de\-)compress to stdout even if it seems a terminal
+\& \- allow option \-c in combination with \-U
+.Ve
+.Sp
+Using \fB\-f\fR two or more times forces things like
+.Sp
+.Vb 3
+\& \- compress files that already have a .lzo suffix
+\& \- try to decompress files that do not have a valid suffix
+\& \- try to handle compressed files with unknown header flags
+.Ve
+.Sp
+Use with care.
+.IP "\-F, \-\-no\-checksum" 4
+.IX Item "-F, --no-checksum"
+Do not store or verify a checksum of the uncompressed
+file when compressing or decompressing.
+This speeds up the operation of lzop a little bit (especially
+when decompressing), but as unnoticed data corruption can happen
+in case of damaged compressed files the usage of this option
+is not generally recommended.
+Also, a checksum is always stored when
+compressing with one of the slow compression levels (\-7, \-8 or \-9),
+regardless of this option.
+.IP "\-n, \-\-no\-name" 4
+.IX Item "-n, --no-name"
+When decompressing, do not restore the original
+file name if present (remove only the lzop suffix
+from the compressed file name). This option is the
+default under \s-1UNIX\s0.
+.IP "\-N, \-\-name" 4
+.IX Item "-N, --name"
+When decompressing, restore the original file name
+if present. This option is useful on systems which
+have a limit on file name length. If the original name saved in
+the compressed file is not suitable for its file system, a
+new name is constructed from the original one to make it
+legal.
+This option is the default under \s-1DOS\s0, Windows and \s-1OS/2\s0.
+.IP "\-P" 4
+.IX Item "-P"
+When decompressing, restore the original path and file name if present.
+When compressing, store the relative (and cleaned) path name.
+This option is mainly useful when using \fBarchive mode\fR \- see
+usage examples below.
+.IP "\-\-no\-mode" 4
+.IX Item "--no-mode"
+When decompressing, do not restore the original
+mode (permissions) saved in the compressed file.
+.IP "\-\-no\-time" 4
+.IX Item "--no-time"
+When decompressing, do not restore the original
+time stamp saved in the compressed file.
+.IP "\-S \fI.suf\fR, \-\-suffix=\fI.suf\fR" 4
+.IX Item "-S .suf, --suffix=.suf"
+Use suffix \fI.suf\fR instead of \fI.lzo\fR. The suffix must
+not contain multiple dots and special characters like '+' or '*',
+and suffixes other than \fI.lzo\fR should be avoided to avoid confusion
+when files are transferred to other systems.
+.IP "\-k, \-\-keep" 4
+.IX Item "-k, --keep"
+Do not delete input files. This is the default.
+.IP "\-U, \-\-unlink, \-\-delete" 4
+.IX Item "-U, --unlink, --delete"
+Delete input files after succesfull compression or
+decompression. Use this option to make lzop behave
+like \fBgzip\fR and \fBbzip2\fR.
+Note that explicitly giving \fB\-k\fR overrides \fB\-U\fR.
+.IP "\-\-crc32" 4
+.IX Item "--crc32"
+Use a crc32 checksum instead of a adler32 checksum.
+.IP "\-\-no\-warn" 4
+.IX Item "--no-warn"
+Suppress all warnings.
+.IP "\-\-ignore\-warn" 4
+.IX Item "--ignore-warn"
+Suppress all warnings, and never exit with exit status 2.
+.IP "\-q, \-\-quiet, \-\-silent" 4
+.IX Item "-q, --quiet, --silent"
+Suppress all warnings and decrease the verbosity of some
+commands like \fB\-\-list\fR or \fB\-\-test\fR.
+.IP "\-v, \-\-verbose" 4
+.IX Item "-v, --verbose"
+Verbose. Display the name for each file compressed
+or decompressed. Multiple \fB\-v\fR can be used to increase
+the verbosity of some commands like \fB\-\-list\fR or \fB\-\-test\fR.
+.IP "\-\-" 4
+Specifies that this is the end of the options. Any file name
+after \fB\-\-\fR will not be interpreted as an option even if
+it starts with a hyphen.
+.SH "OTHER OPTIONS"
+.IX Header "OTHER OPTIONS"
+.IP "\-\-no\-stdin" 4
+.IX Item "--no-stdin"
+Do not try to read standard input (but a file name \*(L"\-\*(R" will
+still override this option).
+In old versions of \fBlzop\fR, this option was necessary when
+used in cron jobs (which do not have a controlling terminal).
+.IP "\-\-filter=\fI\s-1NUMBER\s0\fR" 4
+.IX Item "--filter=NUMBER"
+Rarely useful.
+Preprocess data with a special \*(L"multimedia\*(R" filter
+before compressing in order to improve compression ratio.
+\&\fI\s-1NUMBER\s0\fR must be a decimal number from 1 to 16, inclusive.
+Using a filter slows down both compression and decompression
+quite a bit, and the compression ratio usually doesn't improve
+much either...
+More effective filters may be added in the future, though.
+.Sp
+You can try \-\-filter=1 with data like 8\-bit sound samples,
+\&\-\-filter=2 with 16\-bit samples or depth\-16 images, etc.
+.Sp
+Un-filtering during decompression is handled automatically.
+.IP "\-C, \-\-checksum" 4
+.IX Item "-C, --checksum"
+Deprecated. Only for compatibility with very old versions
+as lzop now uses a checksum by default. This option will
+get removed in a future release.
+.IP "\-\-no\-color" 4
+.IX Item "--no-color"
+Do not use any color escape sequences.
+.IP "\-\-mono" 4
+.IX Item "--mono"
+Assume a mono \s-1ANSI\s0 terminal. This is the default under \s-1UNIX\s0
+(if console support is compiled in).
+.IP "\-\-color" 4
+.IX Item "--color"
+Assume a color \s-1ANSI\s0 terminal or try full-screen access. This
+is the default under \s-1DOS\s0 and in a Linux virtual console
+(if console support is compiled in).
+.SH "ADVANCED USAGE"
+.IX Header "ADVANCED USAGE"
+lzop allows you to deal with your files in many flexible
+ways. Here are some usage examples:
+.IP "\fBbackup mode\fR" 1
+.IX Item "backup mode"
+.Vb 1
+\& tar \-\-use\-compress\-program=lzop \-cf archive.tar.lzo files..
+\&
+\& This is the recommended mode for creating backups.
+\& Requires GNU tar or a compatible version which accepts the
+\& \*(Aq\-\-use\-compress\-program=XXX\*(Aq option.
+.Ve
+.IP "\fBsingle file mode:\fR individually (de)compress each file" 1
+.IX Item "single file mode: individually (de)compress each file"
+.Vb 5
+\& create
+\& lzop a.c \-> create a.c.lzo
+\& lzop a.c b.c \-> create a.c.lzo & b.c.lzo
+\& lzop \-U a.c b.c \-> create a.c.lzo & b.c.lzo and delete a.c & b.c
+\& lzop *.c
+\&
+\& extract
+\& lzop \-d a.c.lzo \-> restore a.c
+\& lzop \-df a.c.lzo \-> restore a.c, overwrite if already exists
+\& lzop \-d *.lzo
+\&
+\& list
+\& lzop \-l a.c.lzo
+\& lzop \-l *.lzo
+\& lzop \-lv *.lzo \-> be verbose
+\&
+\& test
+\& lzop \-t a.c.lzo
+\& lzop \-tq *.lzo \-> be quiet
+.Ve
+.IP "\fBpipe mode:\fR (de)compress from stdin to stdout" 1
+.IX Item "pipe mode: (de)compress from stdin to stdout"
+.Vb 4
+\& create
+\& lzop < a.c > y.lzo
+\& cat a.c | lzop > y.lzo
+\& tar \-cf \- *.c | lzop > y.tar.lzo \-> create a compressed tar file
+\&
+\& extract
+\& lzop \-d < y.lzo > a.c
+\& lzop \-d < y.tar.lzo | tar \-xvf \- \-> extract a tar file
+\&
+\& list
+\& lzop \-l < y.lzo
+\& cat y.lzo | lzop \-l
+\& lzop \-d < y.tar.lzo | tar \-tvf \- \-> list a tar file
+\&
+\& test
+\& lzop \-t < y.lzo
+\& cat y.lzo | lzop \-t
+.Ve
+.IP "\fBstdout mode:\fR (de)compress to stdout" 1
+.IX Item "stdout mode: (de)compress to stdout"
+.Vb 2
+\& create
+\& lzop \-c a.c > y.lzo
+\&
+\& extract
+\& lzop \-dc y.lzo > a.c
+\& lzop \-dc y.tar.lzo | tar \-xvf \- \-> extract a tar file
+\&
+\& list
+\& lzop \-dc y.tar.lzo | tar \-tvf \- \-> list a tar file
+.Ve
+.IP "\fBarchive mode:\fR compress/extract multiple files into a single archive file" 1
+.IX Item "archive mode: compress/extract multiple files into a single archive file"
+.Vb 5
+\& create
+\& lzop a.c b.c \-o sources.lzo \-> create an archive
+\& lzop \-P src/*.c \-o sources.lzo \-> create an archive, store path name
+\& lzop \-c *.c > sources.lzo \-> another way to create an archive
+\& lzop \-c *.h >> sources.lzo \-> add files to archive
+\&
+\& extract
+\& lzop \-dN sources.lzo
+\& lzop \-x ../src/sources.lzo \-> extract to current directory
+\& lzop \-x \-p/tmp < ../src/sources.lzo \-> extract to /tmp directory
+\&
+\& list
+\& lzop \-lNv sources.lzo
+\&
+\& test
+\& lzop \-t sources.lzo
+\& lzop \-tvv sources.lzo \-> be very verbose
+.Ve
+.PP
+If you wish to create a single archive file with multiple
+members so that members can later be extracted independently,
+you should prefer a full-featured archiver such as
+tar. The latest version of \s-1GNU\s0 tar supports the
+\&\fB\-\-use\-compress\-program=lzop\fR option to invoke lzop transparently.
+lzop is designed as a complement to tar, not as
+a replacement.
+.SH "ENVIRONMENT"
+.IX Header "ENVIRONMENT"
+The environment variable \fB\s-1LZOP\s0\fR can hold a set of default
+options for lzop. These options are interpreted first and
+can be overwritten by explicit command line parameters.
+For example:
+.PP
+.Vb 3
+\& for sh/ksh/zsh: LZOP="\-1v \-\-name"; export LZOP
+\& for csh/tcsh: setenv LZOP "\-1v \-\-name"
+\& for DOS/Windows: set LZOP=\-1v \-\-name
+.Ve
+.PP
+On Vax/VMS, the name of the environment variable is
+\&\s-1LZOP_OPT\s0, to avoid a conflict with the symbol set for
+invocation of the program.
+.PP
+Not all of the options are valid in the environment variable \-
+lzop will tell you.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fBbzip2\fR(1), \fBgzip\fR(1), \fBtar\fR(1)
+.PP
+Precompiled binaries for some platforms are available
+from the lzop home page.
+.PP
+.Vb 1
+\& see http://www.oberhumer.com/opensource/lzop/
+.Ve
+.PP
+lzop uses the \s-1LZO\s0 data compression library for compression
+services.
+.PP
+.Vb 1
+\& see http://www.oberhumer.com/opensource/lzo/
+.Ve
+.SH "DIAGNOSTICS"
+.IX Header "DIAGNOSTICS"
+Exit status is normally 0; if an error occurs, exit status
+is 1. If a warning occurs, exit status is 2 (unless
+option \fB\-\-ignore\-warn\fR is in effect).
+.PP
+\&\fBlzop's\fR diagnostics are intended to be self-explanatory.
+.SH "BUGS"
+.IX Header "BUGS"
+No bugs are known. Please report all problems immediately to the author.
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+Markus Franz Xaver Johannes Oberhumer
+<markus@oberhumer.com>
+http://www.oberhumer.com/opensource/lzop/
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+lzop and the \s-1LZO\s0 library are
+Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
+2006, 2007, 2008, 2009, 2010 by Markus Franz Xaver Johannes Oberhumer.
+All Rights Reserved.
+.PP
+lzop and the \s-1LZO\s0 library are distributed under the terms
+of the \s-1GNU\s0 General Public License (\s-1GPL\s0).
+.PP
+Legal info: If want to integrate lzop into your commercial (backup\-)system
+please carefully read the \s-1GNU\s0 \s-1GPL\s0 \s-1FAQ\s0 at http://www.gnu.org/licenses/gpl\-faq.html
+about possible implications.