diff options
| author | HyungKyu Song <hk76.song@samsung.com> | 2013-02-16 00:49:08 +0900 |
|---|---|---|
| committer | HyungKyu Song <hk76.song@samsung.com> | 2013-02-16 00:49:08 +0900 |
| commit | b10cd084cf1cdad179efa65f3a1f8399c2d443e5 (patch) | |
| tree | 32e329de8dc8ba2395bb962f1695b4702ef11fe7 /doc | |
| parent | a83fc9cd1e8b00df9de50d6285680a8e19d419f1 (diff) | |
| download | lzop-tizen_2.0.tar.gz lzop-tizen_2.0.tar.bz2 lzop-tizen_2.0.zip | |
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/Makefile.am | 39 | ||||
| -rw-r--r-- | doc/Makefile.in | 457 | ||||
| -rw-r--r-- | doc/lzop.1 | 611 | ||||
| -rw-r--r-- | doc/lzop.html | 616 | ||||
| -rw-r--r-- | doc/lzop.man | 434 | ||||
| -rw-r--r-- | doc/lzop.pod | 565 | ||||
| -rw-r--r-- | doc/lzop.ps | 818 | ||||
| -rw-r--r-- | doc/lzop.tex | 646 | ||||
| -rw-r--r-- | doc/lzop.txt | 423 | ||||
| -rw-r--r-- | doc/magic | 45 |
10 files changed, 4654 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..e0c12dc --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,39 @@ +## Process this file with automake to produce Makefile.in +# +# Copyright (C) 1996-2010 Markus F.X.J. Oberhumer +# + +SUFFIXES = .1 .html .man .pod .ps .tex .texi .txt + +man_MANS = lzop.1 + +BUILT_SOURCES = lzop.1 lzop.html lzop.man lzop.ps lzop.tex lzop.txt + +EXTRA_DIST = lzop.pod magic $(BUILT_SOURCES) + + +all-local: $(BUILT_SOURCES) + +doc-clean: + -rm -f $(BUILT_SOURCES) + + +.pod.1: + pod2man --center=" " --release="$(PACKAGE) $(VERSION)" --date="2010-11-01" $< > $@ + +.pod.html: + pod2html --noindex $< > $@ + -rm -f pod2htm* + +.pod.tex: + pod2latex $< + +.pod.txt: + pod2text < $< > $@ + +.1.man: + nroff -man $< > $@ + +.1.ps: + groff -man $< > $@ + diff --git a/doc/Makefile.in b/doc/Makefile.in new file mode 100644 index 0000000..35b7dfc --- /dev/null +++ b/doc/Makefile.in @@ -0,0 +1,457 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# +# Copyright (C) 1996-2010 Markus F.X.J. Oberhumer +# +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +target_triplet = @target@ +subdir = doc +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/autoconf/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +AM_V_GEN = $(am__v_GEN_$(V)) +am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY)) +am__v_GEN_0 = @echo " GEN " $@; +AM_V_at = $(am__v_at_$(V)) +am__v_at_ = $(am__v_at_$(AM_DEFAULT_VERBOSITY)) +am__v_at_0 = @ +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +GREP = @GREP@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MKDIR_P = @MKDIR_P@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +VERSION = @VERSION@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_CC = @ac_ct_CC@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +configure_CFLAGS = @configure_CFLAGS@ +configure_CPPFLAGS = @configure_CPPFLAGS@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target = @target@ +target_alias = @target_alias@ +target_cpu = @target_cpu@ +target_os = @target_os@ +target_vendor = @target_vendor@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +SUFFIXES = .1 .html .man .pod .ps .tex .texi .txt +man_MANS = lzop.1 +BUILT_SOURCES = lzop.1 lzop.html lzop.man lzop.ps lzop.tex lzop.txt +EXTRA_DIST = lzop.pod magic $(BUILT_SOURCES) +all: $(BUILT_SOURCES) + $(MAKE) $(AM_MAKEFLAGS) all-am + +.SUFFIXES: +.SUFFIXES: .1 .html .man .pod .ps .tex .texi .txt +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign doc/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --foreign doc/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): +install-man1: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" + @list=''; test -n "$(man1dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically \`make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: $(BUILT_SOURCES) + $(MAKE) $(AM_MAKEFLAGS) check-am +all-am: Makefile $(MANS) all-local +installdirs: + for dir in "$(DESTDIR)$(man1dir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ + done +install: $(BUILT_SOURCES) + $(MAKE) $(AM_MAKEFLAGS) install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." + -test -z "$(BUILT_SOURCES)" || rm -f $(BUILT_SOURCES) +clean: clean-am + +clean-am: clean-generic mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-man + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: install-man1 + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-man + +uninstall-man: uninstall-man1 + +.MAKE: all check install install-am install-strip + +.PHONY: all all-am all-local check check-am clean clean-generic \ + distclean distclean-generic distdir dvi dvi-am html html-am \ + info info-am install install-am install-data install-data-am \ + install-dvi install-dvi-am install-exec install-exec-am \ + install-html install-html-am install-info install-info-am \ + install-man install-man1 install-pdf install-pdf-am install-ps \ + install-ps-am install-strip installcheck installcheck-am \ + installdirs maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am uninstall \ + uninstall-am uninstall-man uninstall-man1 + + +all-local: $(BUILT_SOURCES) + +doc-clean: + -rm -f $(BUILT_SOURCES) + +.pod.1: + pod2man --center=" " --release="$(PACKAGE) $(VERSION)" --date="2010-11-01" $< > $@ + +.pod.html: + pod2html --noindex $< > $@ + -rm -f pod2htm* + +.pod.tex: + pod2latex $< + +.pod.txt: + pod2text < $< > $@ + +.1.man: + nroff -man $< > $@ + +.1.ps: + groff -man $< > $@ + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: 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. diff --git a/doc/lzop.html b/doc/lzop.html new file mode 100644 index 0000000..662e4c9 --- /dev/null +++ b/doc/lzop.html @@ -0,0 +1,616 @@ +<?xml version="1.0" ?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<title>lzop - compress or expand files</title> +<meta http-equiv="content-type" content="text/html; charset=utf-8" /> +<link rev="made" href="mailto:root@localhost" /> +</head> + +<body style="background-color: white"> + + +<!-- INDEX BEGIN --> +<div name="index"> +<p><a name="__index__"></a></p> +<!-- + +<ul> + + <li><a href="#name">NAME</a></li> + <li><a href="#abstract">ABSTRACT</a></li> + <li><a href="#synopsis">SYNOPSIS</a></li> + <li><a href="#description">DESCRIPTION</a></li> + <ul> + + <li><a href="#compression_levels">COMPRESSION LEVELS</a></li> + </ul> + + <li><a href="#main_command">MAIN COMMAND</a></li> + <li><a href="#options">OPTIONS</a></li> + <li><a href="#other_options">OTHER OPTIONS</a></li> + <li><a href="#advanced_usage">ADVANCED USAGE</a></li> + <li><a href="#environment">ENVIRONMENT</a></li> + <li><a href="#see_also">SEE ALSO</a></li> + <li><a href="#diagnostics">DIAGNOSTICS</a></li> + <li><a href="#bugs">BUGS</a></li> + <li><a href="#author">AUTHOR</a></li> + <li><a href="#copyright">COPYRIGHT</a></li> +</ul> + +--> + + +</div> +<!-- INDEX END --> + +<p> +</p> +<h1><a name="name">NAME</a></h1> +<p>lzop - compress or expand files</p> +<p> +</p> +<hr /> +<h1><a name="abstract">ABSTRACT</a></h1> +<p><strong>lzop</strong> is a file compressor very similar to <strong>gzip</strong>. +<strong>lzop</strong> favors speed over compression ratio.</p> +<p> +</p> +<hr /> +<h1><a name="synopsis">SYNOPSIS</a></h1> +<p><strong>lzop</strong> [ <em>command</em> ] [ <em>options</em> ] [ <em>filename</em> ... ]</p> +<p><strong>lzop</strong> [<strong>-dxlthIVL19</strong>] [<strong>-qvcfFnNPkU</strong>] +[<strong>-o</strong> <em>file</em>] [<strong>-p</strong>[<em>path</em>]] [<strong>-S</strong> <em>suffix</em>] +[<em>filename</em> ...]</p> +<p> +</p> +<hr /> +<h1><a name="description">DESCRIPTION</a></h1> +<p><strong>lzop</strong> reduces the size of the named files. Whenever possible, +each file is compressed into one with the extension +<strong>.lzo</strong>, while keeping the same ownership modes, access and +modification times. If no files are specified, or if a +file name is "-", 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.</p> +<p>If the compressed file name is too long for its file system, +<strong>lzop</strong> truncates it.</p> +<p>Compressed files can be restored to their original form +using <strong>lzop -d</strong>. +<strong>lzop -d</strong> takes a list of files on its command line and +decompresses each file whose name ends with <strong>.lzo</strong> and which +begins with the correct magic number to an uncompressed +file without the original extension. <strong>lzop -d</strong> also recognizes +the special extension <strong>.tzo</strong> as shorthand for <strong>.tar.lzo</strong>. +When compressing, lzop uses the <strong>.tzo</strong> extension if necessary +instead of truncating a file with a <strong>.tar</strong> extension.</p> +<p><strong>lzop</strong> stores the original file name, mode and time stamp +in the compressed file. These can be used when +decompressing the file with the <strong>-d</strong> option. This is useful when +the compressed file name was truncated or when the time +stamp was not preserved after a file transfer.</p> +<p><strong>lzop</strong> 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 <strong>-n</strong>, <strong>-N</strong>, <strong>--no-mode</strong> and <strong>--no-time</strong> +for more information.</p> +<p><strong>lzop</strong> always keeps original files unchanged unless +you use the option <strong>-U</strong>.</p> +<p><strong>lzop</strong> uses the <em>LZO data compression library</em> 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 <strong>gzip</strong>, but +compression ratio is worse.</p> +<p> +</p> +<h2><a name="compression_levels">COMPRESSION LEVELS</a></h2> +<p>lzop offers the following compression levels of the +LZO1X algorithm:</p> +<dl> +<dt><strong><a name="3" class="item">-3</a></strong></dt> + +<dd> +<p>the default level offers pretty fast compression. +-2, -3, -4, -5 and -6 are currently all equivalent - this +may change in a future release.</p> +</dd> +<dt><strong><a name="1_fast" class="item">-1, --fast</a></strong></dt> + +<dd> +<p>can be even a little bit faster in some cases - but +most times you won't notice the difference</p> +</dd> +<dt><strong><a name="7_8_9_best" class="item">-7, -8, -9, --best</a></strong></dt> + +<dd> +<p>these compression levels are mainly intended for generating +pre-compressed data - especially <strong>-9</strong> can be somewhat slow</p> +</dd> +</dl> +<p>Decompression is <em>very</em> fast for all compression levels, +and decompression speed is not affected by the compression +level.</p> +<p> +</p> +<hr /> +<h1><a name="main_command">MAIN COMMAND</a></h1> +<p>If no other command is given then lzop defaults to compression +(using compression level -3).</p> +<dl> +<dt><strong><a name="fast_best" class="item">-#, --fast, --best</a></strong></dt> + +<dd> +<p>Regulate the speed of compression using the specified +digit <strong>#</strong>, 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.</p> +</dd> +<dt><strong><a name="d_decompress_uncompress" class="item">-d, --decompress, --uncompress</a></strong></dt> + +<dd> +<p>Decompress. Each file will be placed into +same the directory as the compressed file.</p> +</dd> +<dt><strong><a name="x_extract" class="item">-x, --extract</a></strong></dt> + +<dd> +<p>Extract compressed files to the current working +directory. This is the same as '-dPp'.</p> +</dd> +<dt><strong><a name="t_test" class="item">-t, --test</a></strong></dt> + +<dd> +<p>Test. Check the compressed file integrity.</p> +</dd> +<dt><strong><a name="l_list" class="item">-l, --list</a></strong></dt> + +<dd> +<p>For each compressed file, list the following +fields:</p> +<pre> + 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</pre> +<p>In combination with the --verbose option, the following +fields are also displayed:</p> +<pre> + date & time: time stamp for the uncompressed file</pre> +<p>With --name, the uncompressed name, date and time +are those stored within the compress file if present.</p> +<p>With --verbose, the size totals and compression +ratio for all files is also displayed. With +--quiet, the title and totals lines are not displayed.</p> +<p>Note that lzop defines compression ratio +as compressed_size / uncompressed_size.</p> +</dd> +<dt><strong><a name="ls_ls_flags" class="item">--ls, --ls=<em>FLAGS</em></a></strong></dt> + +<dd> +<p>List each compressed file in a format similar to <strong>ls -ln</strong>.</p> +<p>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.</p> +</dd> +<dt><strong><a name="info" class="item">--info</a></strong></dt> + +<dd> +<p>For each compressed file, list the internal header fields.</p> +</dd> +<dt><strong><a name="i_sysinfo" class="item">-I, --sysinfo</a></strong></dt> + +<dd> +<p>Display information about the system and quit.</p> +</dd> +<dt><strong><a name="l_license" class="item">-L, --license</a></strong></dt> + +<dd> +<p>Display the lzop license and quit.</p> +</dd> +<dt><strong><a name="h_h_help" class="item">-h, -H, --help</a></strong></dt> + +<dd> +<p>Display a help screen and quit.</p> +</dd> +<dt><strong><a name="v" class="item">-V</a></strong></dt> + +<dd> +<p>Version. Display the version number and compilation +options and quit.</p> +</dd> +<dt><strong><a name="version" class="item">--version</a></strong></dt> + +<dd> +<p>Version. Display the version number and quit.</p> +</dd> +</dl> +<p> +</p> +<hr /> +<h1><a name="options">OPTIONS</a></h1> +<dl> +<dt><strong><a name="c_stdout_to_stdout" class="item">-c, --stdout, --to-stdout</a></strong></dt> + +<dd> +<p>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.</p> +</dd> +<dt><strong><a name="o_file_output_file" class="item">-o <em>FILE</em>, --output=<em>FILE</em></a></strong></dt> + +<dd> +<p>Write output to the file <em>FILE</em>. If there are several +input files, the output consists of a sequence +of independently (de)compressed members.</p> +</dd> +<dt><strong><a name="p_pdir_path_dir" class="item">-p, -p<em>DIR</em>, --path=<em>DIR</em></a></strong></dt> + +<dd> +<p>Write output files into the directory <em>DIR</em> instead +of the directory determined by the input file. If +<em>DIR</em> is omitted, then write to the current working +directory.</p> +</dd> +<dt><strong><a name="f_force" class="item">-f, --force</a></strong></dt> + +<dd> +<p>Force lzop to</p> +<pre> + - 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</pre> +<p>Using <strong>-f</strong> two or more times forces things like</p> +<pre> + - 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</pre> +<p>Use with care.</p> +</dd> +<dt><strong><a name="f_no_checksum" class="item">-F, --no-checksum</a></strong></dt> + +<dd> +<p>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.</p> +</dd> +<dt><strong><a name="n_no_name" class="item">-n, --no-name</a></strong></dt> + +<dd> +<p>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 UNIX.</p> +</dd> +<dt><strong><a name="n_name" class="item">-N, --name</a></strong></dt> + +<dd> +<p>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 DOS, Windows and OS/2.</p> +</dd> +<dt><strong><a name="p" class="item">-P</a></strong></dt> + +<dd> +<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 <strong>archive mode</strong> - see +usage examples below.</p> +</dd> +<dt><strong><a name="no_mode" class="item">--no-mode</a></strong></dt> + +<dd> +<p>When decompressing, do not restore the original +mode (permissions) saved in the compressed file.</p> +</dd> +<dt><strong><a name="no_time" class="item">--no-time</a></strong></dt> + +<dd> +<p>When decompressing, do not restore the original +time stamp saved in the compressed file.</p> +</dd> +<dt><strong><a name="s_suf_suffix_suf" class="item">-S <em>.suf</em>, --suffix=<em>.suf</em></a></strong></dt> + +<dd> +<p>Use suffix <em>.suf</em> instead of <em>.lzo</em>. The suffix must +not contain multiple dots and special characters like '+' or '*', +and suffixes other than <em>.lzo</em> should be avoided to avoid confusion +when files are transferred to other systems.</p> +</dd> +<dt><strong><a name="k_keep" class="item">-k, --keep</a></strong></dt> + +<dd> +<p>Do not delete input files. This is the default.</p> +</dd> +<dt><strong><a name="u_unlink_delete" class="item">-U, --unlink, --delete</a></strong></dt> + +<dd> +<p>Delete input files after succesfull compression or +decompression. Use this option to make lzop behave +like <strong>gzip</strong> and <strong>bzip2</strong>. +Note that explicitly giving <strong>-k</strong> overrides <strong>-U</strong>.</p> +</dd> +<dt><strong><a name="crc32" class="item">--crc32</a></strong></dt> + +<dd> +<p>Use a crc32 checksum instead of a adler32 checksum.</p> +</dd> +<dt><strong><a name="no_warn" class="item">--no-warn</a></strong></dt> + +<dd> +<p>Suppress all warnings.</p> +</dd> +<dt><strong><a name="ignore_warn" class="item">--ignore-warn</a></strong></dt> + +<dd> +<p>Suppress all warnings, and never exit with exit status 2.</p> +</dd> +<dt><strong><a name="q_quiet_silent" class="item">-q, --quiet, --silent</a></strong></dt> + +<dd> +<p>Suppress all warnings and decrease the verbosity of some +commands like <strong>--list</strong> or <strong>--test</strong>.</p> +</dd> +<dt><strong><a name="v_verbose" class="item">-v, --verbose</a></strong></dt> + +<dd> +<p>Verbose. Display the name for each file compressed +or decompressed. Multiple <strong>-v</strong> can be used to increase +the verbosity of some commands like <strong>--list</strong> or <strong>--test</strong>.</p> +</dd> +<dt><strong><a name="__" class="item">--</a></strong></dt> + +<dd> +<p>Specifies that this is the end of the options. Any file name +after <strong>--</strong> will not be interpreted as an option even if +it starts with a hyphen.</p> +</dd> +</dl> +<p> +</p> +<hr /> +<h1><a name="other_options">OTHER OPTIONS</a></h1> +<dl> +<dt><strong><a name="no_stdin" class="item">--no-stdin</a></strong></dt> + +<dd> +<p>Do not try to read standard input (but a file name "-" will +still override this option). +In old versions of <strong>lzop</strong>, this option was necessary when +used in cron jobs (which do not have a controlling terminal).</p> +</dd> +<dt><strong><a name="filter_number" class="item">--filter=<em>NUMBER</em></a></strong></dt> + +<dd> +<p>Rarely useful. +Preprocess data with a special "multimedia" filter +before compressing in order to improve compression ratio. +<em>NUMBER</em> 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.</p> +<p>You can try --filter=1 with data like 8-bit sound samples, +--filter=2 with 16-bit samples or depth-16 images, etc.</p> +<p>Un-filtering during decompression is handled automatically.</p> +</dd> +<dt><strong><a name="c_checksum" class="item">-C, --checksum</a></strong></dt> + +<dd> +<p>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.</p> +</dd> +<dt><strong><a name="no_color" class="item">--no-color</a></strong></dt> + +<dd> +<p>Do not use any color escape sequences.</p> +</dd> +<dt><strong><a name="mono" class="item">--mono</a></strong></dt> + +<dd> +<p>Assume a mono ANSI terminal. This is the default under UNIX +(if console support is compiled in).</p> +</dd> +<dt><strong><a name="color" class="item">--color</a></strong></dt> + +<dd> +<p>Assume a color ANSI terminal or try full-screen access. This +is the default under DOS and in a Linux virtual console +(if console support is compiled in).</p> +</dd> +</dl> +<p> +</p> +<hr /> +<h1><a name="advanced_usage">ADVANCED USAGE</a></h1> +<p>lzop allows you to deal with your files in many flexible +ways. Here are some usage examples:</p> +<dl> +<dt><strong><a name="backup_mode" class="item"><strong>backup mode</strong></a></strong></dt> + +<dd> +<pre> + tar --use-compress-program=lzop -cf archive.tar.lzo files..</pre> +<pre> + This is the recommended mode for creating backups. + Requires GNU tar or a compatible version which accepts the + '--use-compress-program=XXX' option.</pre> +</dd> +<dt><strong><a name="individually" class="item"><strong>single file mode:</strong> individually (de)compress each file</a></strong></dt> + +<dd> +<pre> + 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</pre> +<pre> + extract + lzop -d a.c.lzo -> restore a.c + lzop -df a.c.lzo -> restore a.c, overwrite if already exists + lzop -d *.lzo</pre> +<pre> + list + lzop -l a.c.lzo + lzop -l *.lzo + lzop -lv *.lzo -> be verbose</pre> +<pre> + test + lzop -t a.c.lzo + lzop -tq *.lzo -> be quiet</pre> +</dd> +<dt><strong><a name="pipe_mode_de_compress_from_stdin_to_stdout" class="item"><strong>pipe mode:</strong> (de)compress from stdin to stdout</a></strong></dt> + +<dd> +<pre> + create + lzop < a.c > y.lzo + cat a.c | lzop > y.lzo + tar -cf - *.c | lzop > y.tar.lzo -> create a compressed tar file</pre> +<pre> + extract + lzop -d < y.lzo > a.c + lzop -d < y.tar.lzo | tar -xvf - -> extract a tar file</pre> +<pre> + list + lzop -l < y.lzo + cat y.lzo | lzop -l + lzop -d < y.tar.lzo | tar -tvf - -> list a tar file</pre> +<pre> + test + lzop -t < y.lzo + cat y.lzo | lzop -t</pre> +</dd> +<dt><strong><a name="stdout_mode_de_compress_to_stdout" class="item"><strong>stdout mode:</strong> (de)compress to stdout</a></strong></dt> + +<dd> +<pre> + create + lzop -c a.c > y.lzo</pre> +<pre> + extract + lzop -dc y.lzo > a.c + lzop -dc y.tar.lzo | tar -xvf - -> extract a tar file</pre> +<pre> + list + lzop -dc y.tar.lzo | tar -tvf - -> list a tar file</pre> +</dd> +<dt><strong><a name="archive_mode_compress_extract_multiple_files_into_a_single_archive_file" class="item"><strong>archive mode:</strong> compress/extract multiple files into a single archive file</a></strong></dt> + +<dd> +<pre> + 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</pre> +<pre> + 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</pre> +<pre> + list + lzop -lNv sources.lzo</pre> +<pre> + test + lzop -t sources.lzo + lzop -tvv sources.lzo -> be very verbose</pre> +</dd> +</dl> +<p>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 GNU tar supports the +<strong>--use-compress-program=lzop</strong> option to invoke lzop transparently. +lzop is designed as a complement to tar, not as +a replacement.</p> +<p> +</p> +<hr /> +<h1><a name="environment">ENVIRONMENT</a></h1> +<p>The environment variable <strong>LZOP</strong> 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:</p> +<pre> + for sh/ksh/zsh: LZOP="-1v --name"; export LZOP + for csh/tcsh: setenv LZOP "-1v --name" + for DOS/Windows: set LZOP=-1v --name</pre> +<p>On Vax/VMS, the name of the environment variable is +LZOP_OPT, to avoid a conflict with the symbol set for +invocation of the program.</p> +<p>Not all of the options are valid in the environment variable - +lzop will tell you.</p> +<p> +</p> +<hr /> +<h1><a name="see_also">SEE ALSO</a></h1> +<p><strong>bzip2</strong>(1), <strong>gzip</strong>(1), <strong>tar</strong>(1)</p> +<p>Precompiled binaries for some platforms are available +from the lzop home page.</p> +<pre> + see <a href="http://www.oberhumer.com/opensource/lzop/">http://www.oberhumer.com/opensource/lzop/</a></pre> +<p>lzop uses the LZO data compression library for compression +services.</p> +<pre> + see <a href="http://www.oberhumer.com/opensource/lzo/">http://www.oberhumer.com/opensource/lzo/</a></pre> +<p> +</p> +<hr /> +<h1><a name="diagnostics">DIAGNOSTICS</a></h1> +<p>Exit status is normally 0; if an error occurs, exit status +is 1. If a warning occurs, exit status is 2 (unless +option <strong>--ignore-warn</strong> is in effect).</p> +<p><strong>lzop's</strong> diagnostics are intended to be self-explanatory.</p> +<p> +</p> +<hr /> +<h1><a name="bugs">BUGS</a></h1> +<p>No bugs are known. Please report all problems immediately to the author.</p> +<p> +</p> +<hr /> +<h1><a name="author">AUTHOR</a></h1> +<p>Markus Franz Xaver Johannes Oberhumer +<<a href="mailto:markus@oberhumer.com">markus@oberhumer.com</a>> +<a href="http://www.oberhumer.com/opensource/lzop/">http://www.oberhumer.com/opensource/lzop/</a></p> +<p> +</p> +<hr /> +<h1><a name="copyright">COPYRIGHT</a></h1> +<p>lzop and the LZO 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.</p> +<p>lzop and the LZO library are distributed under the terms +of the GNU General Public License (GPL).</p> +<p>Legal info: If want to integrate lzop into your commercial (backup-)system +please carefully read the GNU GPL FAQ at <a href="http://www.gnu.org/licenses/gpl-faq.html">http://www.gnu.org/licenses/gpl-faq.html</a> +about possible implications.</p> + +</body> + +</html> diff --git a/doc/lzop.man b/doc/lzop.man new file mode 100644 index 0000000..d86ddd9 --- /dev/null +++ b/doc/lzop.man @@ -0,0 +1,434 @@ +LZOP(1) LZOP(1) + + + +NNAAMMEE + lzop - compress or expand files + +AABBSSTTRRAACCTT + llzzoopp is a file compressor very similar to ggzziipp. llzzoopp favors speed over + compression ratio. + +SSYYNNOOPPSSIISS + llzzoopp [ _c_o_m_m_a_n_d ] [ _o_p_t_i_o_n_s ] [ _f_i_l_e_n_a_m_e ... ] + + llzzoopp [--ddxxlltthhIIVVLL1199] [--qqvvccffFFnnNNPPkkUU] [--oo _f_i_l_e] [--pp[_p_a_t_h]] [--SS _s_u_f_f_i_x] + [_f_i_l_e_n_a_m_e ...] + +DDEESSCCRRIIPPTTIIOONN + llzzoopp reduces the size of the named files. Whenever possible, each file + is compressed into one with the extension ..llzzoo, while keeping the same + ownership modes, access and modification times. If no files are + specified, or if a file name is "-", 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. + + If the compressed file name is too long for its file system, llzzoopp + truncates it. + + Compressed files can be restored to their original form using llzzoopp --dd. + llzzoopp --dd takes a list of files on its command line and decompresses each + file whose name ends with ..llzzoo and which begins with the correct magic + number to an uncompressed file without the original extension. llzzoopp --dd + also recognizes the special extension ..ttzzoo as shorthand for ..ttaarr..llzzoo. + When compressing, lzop uses the ..ttzzoo extension if necessary instead of + truncating a file with a ..ttaarr extension. + + llzzoopp stores the original file name, mode and time stamp in the + compressed file. These can be used when decompressing the file with the + --dd option. This is useful when the compressed file name was truncated + or when the time stamp was not preserved after a file transfer. + + llzzoopp 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 --nn, --NN, ----nnoo--mmooddee + and ----nnoo--ttiimmee for more information. + + llzzoopp always keeps original files unchanged unless you use the option + --UU. + + llzzoopp uses the _L_Z_O _d_a_t_a _c_o_m_p_r_e_s_s_i_o_n _l_i_b_r_a_r_y 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 + ggzziipp, but compression ratio is worse. + + CCOOMMPPRREESSSSIIOONN LLEEVVEELLSS + lzop offers the following compression levels of the LZO1X algorithm: + + -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. + + -1, --fast + can be even a little bit faster in some cases - but most times you + won’t notice the difference + + -7, -8, -9, --best + these compression levels are mainly intended for generating pre- + compressed data - especially --99 can be somewhat slow + + Decompression is _v_e_r_y fast for all compression levels, and + decompression speed is not affected by the compression level. + +MMAAIINN CCOOMMMMAANNDD + If no other command is given then lzop defaults to compression (using + compression level -3). + + -#, --fast, --best + Regulate the speed of compression using the specified digit ##, + 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. + + -d, --decompress, --uncompress + Decompress. Each file will be placed into same the directory as the + compressed file. + + -x, --extract + Extract compressed files to the current working directory. This is + the same as ’-dPp’. + + -t, --test + Test. Check the compressed file integrity. + + -l, --list + For each compressed file, list the following fields: + + 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 + + In combination with the --verbose option, the following fields are + also displayed: + + date & time: time stamp for the uncompressed file + + With --name, the uncompressed name, date and time are those stored + within the compress file if present. + + With --verbose, the size totals and compression ratio for all files + is also displayed. With --quiet, the title and totals lines are not + displayed. + + Note that lzop defines compression ratio as compressed_size / + uncompressed_size. + + --ls, --ls=_F_L_A_G_S + List each compressed file in a format similar to llss --llnn. + + 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. + + --info + For each compressed file, list the internal header fields. + + -I, --sysinfo + Display information about the system and quit. + + -L, --license + Display the lzop license and quit. + + -h, -H, --help + Display a help screen and quit. + + -V Version. Display the version number and compilation options and + quit. + + --version + Version. Display the version number and quit. + +OOPPTTIIOONNSS + -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. + + -o _F_I_L_E, --output=_F_I_L_E + Write output to the file _F_I_L_E. If there are several input files, + the output consists of a sequence of independently (de)compressed + members. + + -p, -p_D_I_R, --path=_D_I_R + Write output files into the directory _D_I_R instead of the directory + determined by the input file. If _D_I_R is omitted, then write to the + current working directory. + + -f, --force + Force lzop to + + - 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 + + Using --ff two or more times forces things like + + - 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 + + Use with care. + + -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. + + -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 UNIX. + + -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 DOS, + Windows and OS/2. + + -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 aarrcchhiivvee mmooddee - see + usage examples below. + + --no-mode + When decompressing, do not restore the original mode (permissions) + saved in the compressed file. + + --no-time + When decompressing, do not restore the original time stamp saved in + the compressed file. + + -S _._s_u_f, --suffix=_._s_u_f + Use suffix _._s_u_f instead of _._l_z_o. The suffix must not contain + multiple dots and special characters like ’+’ or ’*’, and suffixes + other than _._l_z_o should be avoided to avoid confusion when files are + transferred to other systems. + + -k, --keep + Do not delete input files. This is the default. + + -U, --unlink, --delete + Delete input files after succesfull compression or decompression. + Use this option to make lzop behave like ggzziipp and bbzziipp22. Note that + explicitly giving --kk overrides --UU. + + --crc32 + Use a crc32 checksum instead of a adler32 checksum. + + --no-warn + Suppress all warnings. + + --ignore-warn + Suppress all warnings, and never exit with exit status 2. + + -q, --quiet, --silent + Suppress all warnings and decrease the verbosity of some commands + like ----lliisstt or ----tteesstt. + + -v, --verbose + Verbose. Display the name for each file compressed or decompressed. + Multiple --vv can be used to increase the verbosity of some commands + like ----lliisstt or ----tteesstt. + + -- Specifies that this is the end of the options. Any file name after + ---- will not be interpreted as an option even if it starts with a + hyphen. + +OOTTHHEERR OOPPTTIIOONNSS + --no-stdin + Do not try to read standard input (but a file name "-" will still + override this option). In old versions of llzzoopp, this option was + necessary when used in cron jobs (which do not have a controlling + terminal). + + --filter=_N_U_M_B_E_R + Rarely useful. Preprocess data with a special "multimedia" filter + before compressing in order to improve compression ratio. _N_U_M_B_E_R + 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. + + You can try --filter=1 with data like 8-bit sound samples, + --filter=2 with 16-bit samples or depth-16 images, etc. + + Un-filtering during decompression is handled automatically. + + -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. + + --no-color + Do not use any color escape sequences. + + --mono + Assume a mono ANSI terminal. This is the default under UNIX (if + console support is compiled in). + + --color + Assume a color ANSI terminal or try full-screen access. This is the + default under DOS and in a Linux virtual console (if console + support is compiled in). + +AADDVVAANNCCEEDD UUSSAAGGEE + lzop allows you to deal with your files in many flexible ways. Here are + some usage examples: + + bbaacckkuupp mmooddee + 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 + '--use-compress-program=XXX' option. + + ssiinnggllee ffiillee mmooddee:: individually (de)compress each file + 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 + + ppiippee mmooddee:: (de)compress from stdin to stdout + 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 + + ssttddoouutt mmooddee:: (de)compress to stdout + 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 + + aarrcchhiivvee mmooddee:: compress/extract multiple files into a single archive + file + 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 + + 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 GNU tar + supports the ----uussee--ccoommpprreessss--pprrooggrraamm==llzzoopp option to invoke lzop + transparently. lzop is designed as a complement to tar, not as a + replacement. + +EENNVVIIRROONNMMEENNTT + The environment variable LLZZOOPP 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: + + for sh/ksh/zsh: LZOP="-1v --name"; export LZOP + for csh/tcsh: setenv LZOP "-1v --name" + for DOS/Windows: set LZOP=-1v --name + + On Vax/VMS, the name of the environment variable is LZOP_OPT, to avoid + a conflict with the symbol set for invocation of the program. + + Not all of the options are valid in the environment variable - lzop + will tell you. + +SSEEEE AALLSSOO + bbzziipp22(1), ggzziipp(1), ttaarr(1) + + Precompiled binaries for some platforms are available from the lzop + home page. + + see http://www.oberhumer.com/opensource/lzop/ + + lzop uses the LZO data compression library for compression services. + + see http://www.oberhumer.com/opensource/lzo/ + +DDIIAAGGNNOOSSTTIICCSS + Exit status is normally 0; if an error occurs, exit status is 1. If a + warning occurs, exit status is 2 (unless option ----iiggnnoorree--wwaarrnn is in + effect). + + llzzoopp’’ss diagnostics are intended to be self-explanatory. + +BBUUGGSS + No bugs are known. Please report all problems immediately to the + author. + +AAUUTTHHOORR + Markus Franz Xaver Johannes Oberhumer <markus@oberhumer.com> + http://www.oberhumer.com/opensource/lzop/ + +CCOOPPYYRRIIGGHHTT + lzop and the LZO 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. + + lzop and the LZO library are distributed under the terms of the GNU + General Public License (GPL). + + Legal info: If want to integrate lzop into your commercial + (backup-)system please carefully read the GNU GPL FAQ at + http://www.gnu.org/licenses/gpl-faq.html about possible implications. + + + +lzop 1.03 2010-11-06 LZOP(1) diff --git a/doc/lzop.pod b/doc/lzop.pod new file mode 100644 index 0000000..bef01b3 --- /dev/null +++ b/doc/lzop.pod @@ -0,0 +1,565 @@ +=head1 NAME + +lzop - compress or expand files + + + +=head1 ABSTRACT + +B<lzop> is a file compressor very similar to B<gzip>. +B<lzop> favors speed over compression ratio. + + + +=head1 SYNOPSIS + +B<lzop> S<[ I<command> ]> S<[ I<options> ]> S<[ I<filename> ... ]> + +B<lzop> S<[B<-dxlthIVL19>]> S<[B<-qvcfFnNPkU>]> +S<[B<-o> I<file>]> S<[B<-p>[I<path>]]> S<[B<-S> I<suffix>]> +S<[I<filename> ...]> + + + +=head1 DESCRIPTION + +B<lzop> reduces the size of the named files. Whenever possible, +each file is compressed into one with the extension +B<.lzo>, while keeping the same ownership modes, access and +modification times. If no files are specified, or if a +file name is "-", 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. + +If the compressed file name is too long for its file system, +B<lzop> truncates it. + +Compressed files can be restored to their original form +using S<B<lzop -d>>. +S<B<lzop -d>> takes a list of files on its command line and +decompresses each file whose name ends with B<.lzo> and which +begins with the correct magic number to an uncompressed +file without the original extension. S<B<lzop -d>> also recognizes +the special extension B<.tzo> as shorthand for B<.tar.lzo>. +When compressing, lzop uses the B<.tzo> extension if necessary +instead of truncating a file with a B<.tar> extension. + +B<lzop> stores the original file name, mode and time stamp +in the compressed file. These can be used when +decompressing the file with the B<-d> option. This is useful when +the compressed file name was truncated or when the time +stamp was not preserved after a file transfer. + +B<lzop> 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 B<-n>, B<-N>, B<--no-mode> and B<--no-time> +for more information. + +B<lzop> always keeps original files unchanged unless +you use the option B<-U>. + +B<lzop> uses the I<LZO data compression library> 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 B<gzip>, but +compression ratio is worse. + + + +=head2 COMPRESSION LEVELS + +lzop offers the following compression levels of the +LZO1X algorithm: + +=over 4 + +=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. + +=item -1, --fast + +can be even a little bit faster in some cases - but +most times you won't notice the difference + +=item -7, -8, -9, --best + +these compression levels are mainly intended for generating +pre-compressed data - especially B<-9> can be somewhat slow + +=back + +Decompression is I<very> fast for all compression levels, +and decompression speed is not affected by the compression +level. + + + +=head1 MAIN COMMAND + +If no other command is given then lzop defaults to compression +(using compression level -3). + +=over 4 + +=item -#, --fast, --best + +Regulate the speed of compression using the specified +digit B<#>, 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. + +=item -d, --decompress, --uncompress + +Decompress. Each file will be placed into +same the directory as the compressed file. + +=item -x, --extract + +Extract compressed files to the current working +directory. This is the same as '-dPp'. + +=item -t, --test + +Test. Check the compressed file integrity. + +=item -l, --list + +For each compressed file, list the following +fields: + + 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 + +In combination with the --verbose option, the following +fields are also displayed: + + date & time: time stamp for the uncompressed file + +With --name, the uncompressed name, date and time +are those stored within the compress file if present. + +With --verbose, the size totals and compression +ratio for all files is also displayed. With +--quiet, the title and totals lines are not displayed. + +Note that lzop defines compression ratio +as compressed_size / uncompressed_size. + +=item --ls, --ls=I<FLAGS> + +List each compressed file in a format similar to S<B<ls -ln>>. + +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. + +=item --info + +For each compressed file, list the internal header fields. + +=item -I, --sysinfo + +Display information about the system and quit. + +=item -L, --license + +Display the lzop license and quit. + +=item -h, -H, --help + +Display a help screen and quit. + +=item -V + +Version. Display the version number and compilation +options and quit. + +=item --version + +Version. Display the version number and quit. + +=back + + + +=head1 OPTIONS + +=over 4 + +=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. + +=item -o I<FILE>, --output=I<FILE> + +Write output to the file I<FILE>. If there are several +input files, the output consists of a sequence +of independently (de)compressed members. + +=item -p, -pI<DIR>, --path=I<DIR> + +Write output files into the directory I<DIR> instead +of the directory determined by the input file. If +I<DIR> is omitted, then write to the current working +directory. + +=item -f, --force + +Force lzop to + + - 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 + +Using B<-f> two or more times forces things like + + - 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 + +Use with care. + +=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. + +=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 UNIX. + +=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 DOS, Windows and OS/2. + +=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 B<archive mode> - see +usage examples below. + +=item --no-mode + +When decompressing, do not restore the original +mode (permissions) saved in the compressed file. + +=item --no-time + +When decompressing, do not restore the original +time stamp saved in the compressed file. + +=item -S I<.suf>, --suffix=I<.suf> + +Use suffix I<.suf> instead of I<.lzo>. The suffix must +not contain multiple dots and special characters like '+' or '*', +and suffixes other than I<.lzo> should be avoided to avoid confusion +when files are transferred to other systems. + +=item -k, --keep + +Do not delete input files. This is the default. + +=item -U, --unlink, --delete + +Delete input files after succesfull compression or +decompression. Use this option to make lzop behave +like B<gzip> and B<bzip2>. +Note that explicitly giving B<-k> overrides B<-U>. + +=item --crc32 + +Use a crc32 checksum instead of a adler32 checksum. + +=item --no-warn + +Suppress all warnings. + +=item --ignore-warn + +Suppress all warnings, and never exit with exit status 2. + +=item -q, --quiet, --silent + +Suppress all warnings and decrease the verbosity of some +commands like B<--list> or B<--test>. + +=item -v, --verbose + +Verbose. Display the name for each file compressed +or decompressed. Multiple B<-v> can be used to increase +the verbosity of some commands like B<--list> or B<--test>. + +=item -- + +Specifies that this is the end of the options. Any file name +after B<--> will not be interpreted as an option even if +it starts with a hyphen. + +=back + + + +=head1 OTHER OPTIONS + +=over 4 + +=item --no-stdin + +Do not try to read standard input (but a file name "-" will +still override this option). +In old versions of B<lzop>, this option was necessary when +used in cron jobs (which do not have a controlling terminal). + +=item --filter=I<NUMBER> + +Rarely useful. +Preprocess data with a special "multimedia" filter +before compressing in order to improve compression ratio. +I<NUMBER> 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. + +You can try S<--filter=1> with data like 8-bit sound samples, +S<--filter=2> with 16-bit samples or depth-16 images, etc. + +Un-filtering during decompression is handled automatically. + +=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. + +=item --no-color + +Do not use any color escape sequences. + +=item --mono + +Assume a mono ANSI terminal. This is the default under UNIX +(if console support is compiled in). + +=item --color + +Assume a color ANSI terminal or try full-screen access. This +is the default under DOS and in a Linux virtual console +(if console support is compiled in). + + +=back + + + +=head1 ADVANCED USAGE + +lzop allows you to deal with your files in many flexible +ways. Here are some usage examples: + +=over 1 + +=item B<backup mode> + + 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 + '--use-compress-program=XXX' option. + +=item B<single file mode:> individually (de)compress each file + + 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 + +=item B<pipe mode:> (de)compress from stdin to stdout + + 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 + +=item B<stdout mode:> (de)compress to stdout + + 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 + +=item B<archive mode:> compress/extract multiple files into a single archive file + + 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 + +=back + +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 GNU tar supports the +S<B<--use-compress-program=lzop>> option to invoke lzop transparently. +lzop is designed as a complement to tar, not as +a replacement. + + + +=head1 ENVIRONMENT + +The environment variable B<LZOP> 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: + + for sh/ksh/zsh: LZOP="-1v --name"; export LZOP + for csh/tcsh: setenv LZOP "-1v --name" + for DOS/Windows: set LZOP=-1v --name + +On Vax/VMS, the name of the environment variable is +LZOP_OPT, to avoid a conflict with the symbol set for +invocation of the program. + +Not all of the options are valid in the environment variable - +lzop will tell you. + + + +=head1 SEE ALSO + +B<bzip2>(1), B<gzip>(1), B<tar>(1) + +Precompiled binaries for some platforms are available +from the lzop home page. + + see http://www.oberhumer.com/opensource/lzop/ + +lzop uses the LZO data compression library for compression +services. + + see http://www.oberhumer.com/opensource/lzo/ + + + +=head1 DIAGNOSTICS + +Exit status is normally 0; if an error occurs, exit status +is 1. If a warning occurs, exit status is 2 (unless +option B<--ignore-warn> is in effect). + +B<lzop's> diagnostics are intended to be self-explanatory. + + + +=head1 BUGS + +No bugs are known. Please report all problems immediately to the author. + + + +=head1 AUTHOR + +Markus Franz Xaver Johannes Oberhumer +<markus@oberhumer.com> +http://www.oberhumer.com/opensource/lzop/ + + + +=head1 COPYRIGHT + +lzop and the LZO 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. + +lzop and the LZO library are distributed under the terms +of the GNU General Public License (GPL). + +Legal info: If want to integrate lzop into your commercial (backup-)system +please carefully read the GNU GPL FAQ at http://www.gnu.org/licenses/gpl-faq.html +about possible implications. + diff --git a/doc/lzop.ps b/doc/lzop.ps new file mode 100644 index 0000000..341ad69 --- /dev/null +++ b/doc/lzop.ps @@ -0,0 +1,818 @@ +%!PS-Adobe-3.0 +%%Creator: groff version 1.18.1.4 +%%CreationDate: Mon Nov 1 00:51:10 2010 +%%DocumentNeededResources: font Times-Roman +%%+ font Times-Bold +%%+ font Times-Italic +%%+ font Courier +%%DocumentSuppliedResources: procset grops 1.18 1 +%%Pages: 6 +%%PageOrder: Ascend +%%Orientation: Portrait +%%EndComments +%%BeginProlog +%%BeginResource: procset grops 1.18 1 +/setpacking where{ +pop +currentpacking +true setpacking +}if +/grops 120 dict dup begin +/SC 32 def +/A/show load def +/B{0 SC 3 -1 roll widthshow}bind def +/C{0 exch ashow}bind def +/D{0 exch 0 SC 5 2 roll awidthshow}bind def +/E{0 rmoveto show}bind def +/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def +/G{0 rmoveto 0 exch ashow}bind def +/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/I{0 exch rmoveto show}bind def +/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def +/K{0 exch rmoveto 0 exch ashow}bind def +/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/M{rmoveto show}bind def +/N{rmoveto 0 SC 3 -1 roll widthshow}bind def +/O{rmoveto 0 exch ashow}bind def +/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/Q{moveto show}bind def +/R{moveto 0 SC 3 -1 roll widthshow}bind def +/S{moveto 0 exch ashow}bind def +/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/SF{ +findfont exch +[exch dup 0 exch 0 exch neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/MF{ +findfont +[5 2 roll +0 3 1 roll +neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/level0 0 def +/RES 0 def +/PL 0 def +/LS 0 def +/MANUAL{ +statusdict begin/manualfeed true store end +}bind def +/PLG{ +gsave newpath clippath pathbbox grestore +exch pop add exch pop +}bind def +/BP{ +/level0 save def +1 setlinecap +1 setlinejoin +72 RES div dup scale +LS{ +90 rotate +}{ +0 PL translate +}ifelse +1 -1 scale +}bind def +/EP{ +level0 restore +showpage +}bind def +/DA{ +newpath arcn stroke +}bind def +/SN{ +transform +.25 sub exch .25 sub exch +round .25 add exch round .25 add exch +itransform +}bind def +/DL{ +SN +moveto +SN +lineto stroke +}bind def +/DC{ +newpath 0 360 arc closepath +}bind def +/TM matrix def +/DE{ +TM currentmatrix pop +translate scale newpath 0 0 .5 0 360 arc closepath +TM setmatrix +}bind def +/RC/rcurveto load def +/RL/rlineto load def +/ST/stroke load def +/MT/moveto load def +/CL/closepath load def +/Fr{ +setrgbcolor fill +}bind def +/Fk{ +setcmykcolor fill +}bind def +/Fg{ +setgray fill +}bind def +/FL/fill load def +/LW/setlinewidth load def +/Cr/setrgbcolor load def +/Ck/setcmykcolor load def +/Cg/setgray load def +/RE{ +findfont +dup maxlength 1 index/FontName known not{1 add}if dict begin +{ +1 index/FID ne{def}{pop pop}ifelse +}forall +/Encoding exch def +dup/FontName exch def +currentdict end definefont pop +}bind def +/DEFS 0 def +/EBEGIN{ +moveto +DEFS begin +}bind def +/EEND/end load def +/CNT 0 def +/level1 0 def +/PBEGIN{ +/level1 save def +translate +div 3 1 roll div exch scale +neg exch neg exch translate +0 setgray +0 setlinecap +1 setlinewidth +0 setlinejoin +10 setmiterlimit +[]0 setdash +/setstrokeadjust where{ +pop +false setstrokeadjust +}if +/setoverprint where{ +pop +false setoverprint +}if +newpath +/CNT countdictstack def +userdict begin +/showpage{}def +}bind def +/PEND{ +clear +countdictstack CNT sub{end}repeat +level1 restore +}bind def +end def +/setpacking where{ +pop +setpacking +}if +%%EndResource +%%IncludeResource: font Times-Roman +%%IncludeResource: font Times-Bold +%%IncludeResource: font Times-Italic +%%IncludeResource: font Courier +grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 +def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron +/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen +/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon +/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O +/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex +/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y +/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft +/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl +/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut +/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash +/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen +/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft +/logicalnot/minus/registered/macron/degree/plusminus/twosuperior +/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior +/ordmasculine/guilsinglright/onequarter/onehalf/threequarters +/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE +/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex +/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis +/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn +/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash +/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def +/Courier@0 ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE +/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE +%%EndProlog +%%Page: 1 1 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R/F1 +10.95/Times-Bold@0 SF -.219<4e41>72 84 S<4d45>.219 E F0 +<6c7a6f7020ad20636f6d7072657373206f722065>108 96 Q<7870616e64208c6c6573> +-.15 E F1<414253545241>72 112.8 Q<4354>-.602 E/F2 10/Times-Bold@0 SF +<6c7a6f70>108 124.8 Q F0<69732061208c6c6520636f6d70726573736f722076>2.5 +E<6572792073696d696c617220746f>-.15 E F2<677a6970>2.5 E F0<2e>A F2 +<6c7a6f70>5 E F0 -.1<6661>2.5 G -.2<766f>-.1 G<7273207370656564206f>.2 E +-.15<7665>-.15 G 2.5<7263>.15 G<6f6d7072657373696f6e20726174696f2e>-2.5 +E F1<53594e4f50534953>72 141.6 Q F2<6c7a6f70>108 153.6 Q F0<5b>2.5 E/F3 +10/Times-Italic@0 SF<636f6d6d616e64>2.5 E F0 2.5<5d5b>2.5 G F3 +<6f7074696f6e73>A F0 2.5<5d5b>2.5 G F3<8c6c656e616d65>A F0 2.5 +<2e2e2e205d>2.5 F F2<6c7a6f70>108 170.4 Q F0<5b>2.5 E F2 +<ad64786c746849564c3139>A F0 2.5<5d5b>C F2<ad71766366466e4e506b55>-2.5 E +F0 2.5<5d5b>C F2<ad6f>-2.5 E F3<8c6c65>2.5 E F0 2.5<5d5b>C F2<ad70>-2.5 +E F0<5b>A F3<70617468>A F0<5d5d205b>A F2<ad53>A F3<737566>2.5 E<8c78> +-.18 E F0 2.5<5d5b>C F3<8c6c656e616d65>-2.5 E F0<2e2e2e5d>2.5 E F1 +<4445534352495054494f4e>72 187.2 Q F2<6c7a6f70>108 199.2 Q F0 1.534<7265 +6475636573207468652073697a65206f6620746865206e616d6564208c6c65732e205768 +656e65>4.035 F -.15<7665>-.25 G 4.034<7270>.15 G 1.534<6f737369626c652c +2065616368208c6c6520697320636f6d7072657373656420696e746f206f6e6520776974 +6820746865>-4.034 F -.15<6578>108 211.2 S<74656e73696f6e>.15 E F2 +<2e6c7a6f>3.985 E F0 3.985<2c77>C 1.485<68696c65206b>-3.985 F 1.485 +<656570696e67207468652073616d65206f>-.1 F 1.486<776e657273686970206d6f64 +65732c2061636365737320616e64206d6f64698c636174696f6e2074696d65732e204966 +206e6f208c6c657320617265>-.25 F .131 +<73706563698c65642c206f722069662061208c6c65206e616d652069732060>108 +223.2 R<60ad27>-.74 E .13<272c206c7a6f7020747269657320746f20636f6d707265 +737320746865207374616e6461726420696e70757420746f20746865207374616e646172 +64206f75747075742e206c7a6f702077696c6c>-.74 F 2.271 +<6f6e6c7920617474656d707420746f20636f6d7072657373207265>108 235.2 R +2.271 +<67756c6172208c6c6573206f722073796d626f6c6963206c696e6b7320746f207265> +-.15 F 2.271<67756c6172208c6c65732e>-.15 F 2.272 +<496e20706172746963756c6172>7.271 F 4.772<2c69>-.4 G 4.772<7477>-4.772 G +2.272<696c6c2069676e6f7265>-4.772 F<6469726563746f726965732e>108 247.2 Q +<49662074686520636f6d70726573736564208c6c65206e616d6520697320746f6f206c +6f6e6720666f7220697473208c6c652073797374656d2c>108 264 Q F2<6c7a6f70>2.5 +E F0<7472756e63617465732069742e>2.5 E .966<436f6d70726573736564208c6c65 +732063616e20626520726573746f72656420746f207468656972206f726967696e616c20 +666f726d207573696e67>108 280.8 R F2<6c7a6f7020ad64>3.466 E F0<2e>A F2 +<6c7a6f7020ad64>5.965 E F0<74616b>3.465 E .965 +<65732061206c697374206f66208c6c6573206f6e20697473>-.1 F .99<636f6d6d616e +64206c696e6520616e64206465636f6d707265737365732065616368208c6c652077686f +7365206e616d6520656e64732077697468>108 292.8 R F2<2e6c7a6f>3.49 E F0 .99 +<616e64207768696368206265>3.49 F .99 +<67696e7320776974682074686520636f7272656374>-.15 F .702<6d61676963206e75 +6d62657220746f20616e20756e636f6d70726573736564208c6c6520776974686f757420 +746865206f726967696e616c2065>108 304.8 R<7874656e73696f6e2e>-.15 E F2 +<6c7a6f7020ad64>3.202 E F0 .702 +<616c736f207265636f676e697a657320746865207370656369616c>3.202 F -.15 +<6578>108 316.8 S<74656e73696f6e>.15 E F2<2e747a6f>4.507 E F0 2.008 +<61732073686f727468616e6420666f72>4.507 F F2<2e746172>4.508 E<2e6c7a6f> +-1 E F0 7.008<2e57>C 2.008 +<68656e20636f6d7072657373696e672c206c7a6f70207573657320746865>-7.008 F +F2<2e747a6f>4.508 E F0 -.15<6578>4.508 G 2.008 +<74656e73696f6e206966206e6563657373617279>.15 F +<696e7374656164206f66207472756e636174696e672061208c6c6520776974682061> +108 328.8 Q F2<2e746172>2.5 E F0 -.15<6578>2.5 G<74656e73696f6e2e>.15 E +F2<6c7a6f70>108 345.6 Q F0 .978<73746f72657320746865206f726967696e616c20 +8c6c65206e616d652c206d6f646520616e642074696d65207374616d7020696e20746865 +20636f6d70726573736564208c6c652e2054686573652063616e20626520757365642077 +68656e>3.479 F .575 +<6465636f6d7072657373696e6720746865208c6c65207769746820746865>108 357.6 +R F2<ad64>3.075 E F0 .575<6f7074696f6e2e20546869732069732075736566756c20 +7768656e2074686520636f6d70726573736564208c6c65206e616d652077>3.075 F +.576<6173207472756e6361746564206f72>-.1 F +<7768656e207468652074696d65207374616d702077>108 369.6 Q +<6173206e6f742070726573657276>-.1 E +<65642061667465722061208c6c65207472616e73666572>-.15 E<2e>-.55 E F2 +<6c7a6f70>108 386.4 Q F0<70726573657276>2.954 E .454<657320746865206f> +-.15 F .453<776e6572736869702c206d6f646520616e642074696d65207374616d7020 +6f66208c6c6573207768656e20636f6d7072657373696e672e205768656e206465636f6d +7072657373696e67206c7a6f70>-.25 F .453<726573746f72657320746865206d6f64 +6520616e642074696d65207374616d702069662070726573656e7420696e207468652063 +6f6d70726573736564208c6c65732e>108 398.4 R .453 +<53656520746865206f7074696f6e73>5.453 F F2<ad6e>2.953 E F0<2c>A F2<ad4e> +2.953 E F0<2c>A F2<adad6e6fad6d6f6465>2.953 E F0<616e64>108 410.4 Q F2 +<adad6e6fad74696d65>2.5 E F0<666f72206d6f726520696e666f726d6174696f6e2e> +2.5 E F2<6c7a6f70>108 427.2 Q F0<616c>2.5 E -.1<7761>-.1 G<7973206b>.1 E +<65657073206f726967696e616c208c6c657320756e6368616e67656420756e6c657373 +20796f752075736520746865206f7074696f6e>-.1 E F2<ad55>2.5 E F0<2e>A F2 +<6c7a6f70>108 444 Q F0 .136<7573657320746865>2.636 F/F4 9/Times-Italic@0 +SF<4c5a4f>2.636 E F3 .135<6461746120636f6d7072>2.636 F .135 +<657373696f6e206c696272>-.37 F<617279>-.15 E F0 .135<666f7220636f6d7072 +657373696f6e2073657276696365732e2054686520616d6f756e74206f6620636f6d7072 +657373696f6e206f627461696e6564>2.635 F .552<646570656e6473206f6e20746865 +2073697a65206f662074686520696e70757420616e64207468652064697374726962>108 +456 R .552<7574696f6e206f6620636f6d6d6f6e20737562737472696e67732e>-.2 F +-.8<5479>5.553 G<706963616c6c79>.8 E 3.053<2c74>-.65 G -.15<6578>-3.053 +G 3.053<7473>.15 G .553<75636820617320736f75726365>-3.053 F 1.332<636f64 +65206f7220456e676c69736820697320636f6d7072657373656420696e746f203430ad35 +3025206f6620746865206f726967696e616c2073697a652c20616e64206c6172>108 468 +R 1.332<6765208c6c657320757375616c6c7920636f6d7072657373206d756368>-.18 +F .64<626574746572207468616e20736d616c6c206f6e65732e20436f6d707265737369 +6f6e20616e64206465636f6d7072657373696f6e2073706565642069732067656e657261 +6c6c79206d7563682066>108 480 R .64 +<6173746572207468616e2074686174206163686965>-.1 F -.15<7665>-.25 G<64> +.15 E<6279>108 492 Q F2<677a6970>2.5 E F0 2.5<2c62>C +<757420636f6d7072657373696f6e20726174696f2069732077>-2.7 E<6f7273652e> +-.1 E/F5 9/Times-Bold@0 SF .25<434f4d5052455353494f4e204c4556454c53>87 +508.8 R F0<6c7a6f70206f66>108 520.8 Q<666572732074686520666f6c6c6f>-.25 +E<77696e6720636f6d7072657373696f6e206c65>-.25 E -.15<7665>-.25 G +<6c73206f6620746865>.15 E/F6 9/Times-Roman@0 SF<4c5a4f3158>2.5 E F0 +<616c676f726974686d3a>2.5 E 6.86<ad3320746865>108 537.6 R<646566>3.326 E +.826<61756c74206c65>-.1 F -.15<7665>-.25 G 3.326<6c6f>.15 G -.25<6666> +-3.326 G .826<657273207072657474792066>.25 F .825 +<61737420636f6d7072657373696f6e2e>-.1 F .825<ad322c20ad332c20ad342c20ad +3520616e6420ad36206172652063757272656e746c7920616c6c2065717569>5.825 F +-.25<7661>-.25 G .825<6c656e7420ad>.25 F<74686973206d6179206368616e6765 +20696e2061206675747572652072656c656173652e>128 549.6 Q<ad312c20adad66> +108 566.4 Q<617374>-.1 E<63616e2062652065>128 578.4 Q -.15<7665>-.25 G +2.5<6e616c>.15 G<6974746c65206269742066>-2.5 E +<617374657220696e20736f6d6520636173657320ad2062>-.1 E +<7574206d6f73742074696d657320796f752077>-.2 E<6f6e27>-.1 E 2.5<746e>-.18 +G<6f746963652074686520646966>-2.5 E<666572656e6365>-.25 E +<ad372c20ad382c20ad392c20adad62657374>108 595.2 Q .537 +<746865736520636f6d7072657373696f6e206c65>128 607.2 R -.15<7665>-.25 G +.538<6c7320617265206d61696e6c7920696e74656e64656420666f722067656e657261 +74696e67207072652d636f6d70726573736564206461746120ad20657370656369616c6c +79>.15 F F2<ad39>3.038 E F0<63616e>3.038 E<626520736f6d65>128 619.2 Q +<7768617420736c6f>-.25 E<77>-.25 E 1.708 +<4465636f6d7072657373696f6e206973>108 636 R F3<76657279>4.208 E F0 -.1 +<6661>4.208 G 1.708<737420666f7220616c6c20636f6d7072657373696f6e206c65> +.1 F -.15<7665>-.25 G 1.707<6c732c20616e64206465636f6d7072657373696f6e20 +7370656564206973206e6f74206166>.15 F 1.707<66656374656420627920746865> +-.25 F<636f6d7072657373696f6e206c65>108 648 Q -.15<7665>-.25 G<6c2e>.15 +E F1<4d41494e20434f4d4d414e44>72 664.8 Q F0 +<4966206e6f206f7468657220636f6d6d616e64206973206769>108 676.8 Q -.15 +<7665>-.25 G 2.5<6e74>.15 G<68656e206c7a6f7020646566>-2.5 E<61756c747320 +746f20636f6d7072657373696f6e20287573696e6720636f6d7072657373696f6e206c65> +-.1 E -.15<7665>-.25 G 2.5<6cad>.15 G<33292e>-2.5 E<ad232c20adad66>108 +693.6 Q<6173742c20adad62657374>-.1 E<5265>128 705.6 Q .325<67756c617465 +20746865207370656564206f6620636f6d7072657373696f6e207573696e672074686520 +73706563698c6564206469676974>-.15 F F2<23>2.826 E F0 2.826<2c77>C .326 +<6865726520ad31206f7220adad66>-2.826 F .326 +<61737420696e64696361746573207468652066>-.1 F<617374657374>-.1 E .864<63 +6f6d7072657373696f6e206d6574686f6420286c65737320636f6d7072657373696f6e29 +20616e6420ad39206f7220adad6265737420696e646963617465732074686520736c6f> +128 717.6 R .864<7765737420636f6d7072657373696f6e206d6574686f64>-.25 F +<286265737420636f6d7072657373696f6e292e2054686520646566>128 729.6 Q +<61756c7420636f6d7072657373696f6e206c65>-.1 E -.15<7665>-.25 G 2.5<6c69> +.15 G 2.5<73ad>-2.5 G<332e>-2.5 E<6c7a6f7020312e3033>72 768 Q 203.17 +<323031302d31312d30362031>173.45 F 0 Cg EP +%%Page: 2 2 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R +<ad642c20adad6465636f6d70726573732c20adad756e636f6d7072657373>108 84 Q< +4465636f6d70726573732e2045616368208c6c652077696c6c20626520706c6163656420 +696e746f2073616d6520746865206469726563746f72792061732074686520636f6d7072 +6573736564208c6c652e>128 96 Q<ad782c20adad65>108 112.8 Q<787472616374> +-.15 E<4578747261637420636f6d70726573736564208c6c657320746f207468652063 +757272656e742077>128 124.8 Q<6f726b696e67206469726563746f7279>-.1 E 2.5 +<2e54>-.65 G<686973206973207468652073616d652061732027ad645070272e>-2.5 E +<ad742c20adad74657374>108 141.6 Q -.7<5465>128 153.6 S +<73742e20436865636b2074686520636f6d70726573736564208c6c6520696e7465>.7 E +<6772697479>-.15 E<2e>-.65 E<ad6c2c20adad6c697374>108 170.4 Q -.15<466f> +128 182.4 S 2.5<7265>.15 G +<61636820636f6d70726573736564208c6c652c206c6973742074686520666f6c6c6f> +-2.5 E<77696e67208c656c64733a>-.25 E/F1 10/Courier@0 SF +<6d6574686f643a20636f6d7072657373696f6e206d6574686f64>140 200.4 Q<636f6d +707265737365643a2073697a65206f662074686520636f6d707265737365642066696c65> +140 212.4 Q<756e636f6d70722e3a2073697a65206f662074686520756e636f6d707265 +737365642066696c65>140 224.4 Q +<726174696f3a20636f6d7072657373696f6e20726174696f>140 236.4 Q<756e636f6d +707265737365645f6e616d653a206e616d65206f662074686520756e636f6d7072657373 +65642066696c65>140 248.4 Q F0 +<496e20636f6d62696e6174696f6e20776974682074686520adad76>128 266.4 Q +<6572626f7365206f7074696f6e2c2074686520666f6c6c6f>-.15 E +<77696e67208c656c64732061726520616c736f20646973706c617965643a>-.25 E F1< +6461746520262074696d653a2074696d65207374616d7020666f722074686520756e636f +6d707265737365642066696c65>140 284.4 Q F0 -.4<5769>128 302.4 S 1.653<74 +6820adad6e616d652c2074686520756e636f6d70726573736564206e616d652c20646174 +6520616e642074696d65206172652074686f73652073746f7265642077697468696e2074 +686520636f6d7072657373208c6c65206966>.4 F<70726573656e742e>128 314.4 Q +-.4<5769>128 332.4 S .461<746820adad76>.4 F .461<6572626f73652c20746865 +2073697a6520746f74616c7320616e6420636f6d7072657373696f6e20726174696f2066 +6f7220616c6c208c6c657320697320616c736f20646973706c617965642e2057>-.15 F +.46<69746820adad71756965742c20746865>-.4 F<7469746c6520616e6420746f7461 +6c73206c696e657320617265206e6f7420646973706c617965642e>128 344.4 Q<4e6f +74652074686174206c7a6f702064658c6e657320636f6d7072657373696f6e2072617469 +6f20617320636f6d707265737365645f73697a65202f20756e636f6d707265737365645f +73697a652e>128 362.4 Q<adad6c732c20adad6c733d>108 379.2 Q/F2 9 +/Times-Italic@0 SF<464c41>A<4753>-.315 E F0<4c697374206561636820636f6d70 +726573736564208c6c6520696e206120666f726d61742073696d696c617220746f>128 +391.2 Q/F3 10/Times-Bold@0 SF<6c7320ad6c6e>2.5 E F0<2e>A +<54686520666f6c6c6f>128 409.2 Q +<77696e67208d616773206172652063757272656e746c7920686f6e6f757265643a>-.25 +E 5<4641>133 421.2 S<7070656e64206120272a2720666f722065>-5 E -.15<7865> +-.15 G<63757461626c65208c6c65732e>.15 E 5<4749>133 433.2 S<6e6869626974 +20646973706c6179206f662067726f757020696e666f726d6174696f6e2e>-5 E 5 +<5145>133 445.2 S +<6e636c6f7365208c6c65206e616d657320696e20646f75626c652071756f7465732e>-5 +E<adad696e666f>108 462 Q -.15<466f>128 474 S 2.5<7265>.15 G<61636820636f +6d70726573736564208c6c652c206c6973742074686520696e7465726e616c2068656164 +6572208c656c64732e>-2.5 E<ad492c20adad737973696e666f>108 490.8 Q<446973 +706c617920696e666f726d6174696f6e2061626f7574207468652073797374656d20616e +6420717569742e>128 502.8 Q<ad4c2c20adad6c6963656e7365>108 519.6 Q +<446973706c617920746865206c7a6f70206c6963656e736520616e6420717569742e> +128 531.6 Q<ad682c20ad482c20adad68656c70>108 548.4 Q +<446973706c617920612068656c702073637265656e20616e6420717569742e>128 +560.4 Q 4.64<ad562056>108 577.2 R +<657273696f6e2e20446973706c6179207468652076>-1.11 E<657273696f6e206e756d +62657220616e6420636f6d70696c6174696f6e206f7074696f6e7320616e642071756974 +2e>-.15 E<adad76>108 594 Q<657273696f6e>-.15 E -1.11<5665>128 606 S +<7273696f6e2e20446973706c6179207468652076>1.11 E +<657273696f6e206e756d62657220616e6420717569742e>-.15 E/F4 10.95 +/Times-Bold@0 SF<4f5054494f4e53>72 622.8 Q F0 +<ad632c20adad7374646f75742c20adad746fad7374646f7574>108 634.8 Q .913<57 +72697465206f7574707574206f6e207374616e64617264206f75747075742e2049662074 +6865726520617265207365>128 646.8 R -.15<7665>-.25 G .913<72616c20696e70 +7574208c6c65732c20746865206f757470757420636f6e7369737473206f662061207365 +7175656e6365206f66>.15 F 2.231<696e646570656e64656e746c792028646529636f +6d70726573736564206d656d626572732e2054>128 658.8 R 4.731<6f6f>-.8 G +2.231<627461696e2062657474657220636f6d7072657373696f6e2c20636f6e63617465 +6e61746520616c6c20696e707574208c6c6573>-4.731 F +<6265666f726520636f6d7072657373696e67207468656d2e>128 670.8 Q<ad6f>108 +687.6 Q F2<46494c45>2.5 E F0 2.5<2cad>C<ad6f75747075743d>-2.5 E F2 +<46494c45>A F0 1.704<5772697465206f757470757420746f20746865208c6c65>128 +699.6 R F2<46494c45>4.204 E F0 4.204<2e49>C 4.204<6674>-4.204 G 1.704 +<6865726520617265207365>-4.204 F -.15<7665>-.25 G 1.705<72616c20696e7075 +74208c6c65732c20746865206f757470757420636f6e7369737473206f66206120736571 +75656e6365206f66>.15 F<696e646570656e64656e746c792028646529636f6d707265 +73736564206d656d626572732e>128 711.6 Q<6c7a6f7020312e3033>72 768 Q +203.17<323031302d31312d30362032>173.45 F 0 Cg EP +%%Page: 3 3 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R +<ad702c20ad70>108 84 Q/F1 9/Times-Italic@0 SF<444952>A F0 2.5<2cad>C +<ad706174683d>-2.5 E F1<444952>A F0 .377<5772697465206f7574707574208c6c +657320696e746f20746865206469726563746f7279>128 96 R F1<444952>2.876 E F0 +.376<696e7374656164206f6620746865206469726563746f72792064657465726d696e +65642062792074686520696e707574208c6c652e204966>2.876 F F1<444952>2.876 E +F0<6973>2.876 E<6f6d69747465642c207468656e20777269746520746f207468652063 +757272656e742077>128 108 Q<6f726b696e67206469726563746f7279>-.1 E<2e> +-.65 E<ad662c20adad666f726365>108 124.8 Q -.15<466f>128 136.8 S +<726365206c7a6f7020746f>.15 E/F2 10/Courier@0 SF 6<ad6f>134 154.8 S +<7665727772697465206578697374696e672066696c6573>-6 E 6<ad28>134 166.8 S< +6465ad29636f6d70726573732066726f6d20737464696e206576656e2069662069742073 +65656d732061207465726d696e616c>-6 E 6<ad28>134 178.8 S<6465ad29636f6d70 +7265737320746f207374646f7574206576656e206966206974207365656d732061207465 +726d696e616c>-6 E 6<ad61>134 190.8 S<6c6c6f77206f7074696f6e20ad6320696e +20636f6d62696e6174696f6e207769746820ad55>-6 E F0<5573696e67>128 208.8 Q +/F3 10/Times-Bold@0 SF<ad66>2.5 E F0<7477>2.5 E 2.5<6f6f>-.1 G 2.5<726d> +-2.5 G<6f72652074696d657320666f72636573207468696e6773206c696b>-2.5 E<65> +-.1 E F2 6<ad63>134 226.8 S<6f6d70726573732066696c6573207468617420616c72 +6561647920686176652061202e6c7a6f20737566666978>-6 E 6<ad74>134 238.8 S< +727920746f206465636f6d70726573732066696c6573207468617420646f206e6f742068 +61766520612076616c696420737566666978>-6 E 6<ad74>134 250.8 S<727920746f +2068616e646c6520636f6d707265737365642066696c6573207769746820756e6b6e6f77 +6e2068656164657220666c616773>-6 E F0<557365207769746820636172652e>128 +268.8 Q<ad46>108 285.6 Q 2.5<2cad>-.8 G<ad6e6fad636865636b73756d>-2.5 E +1.607<446f206e6f742073746f7265206f722076>128 297.6 R 1.607<657269667920 +6120636865636b73756d206f662074686520756e636f6d70726573736564208c6c652077 +68656e20636f6d7072657373696e67206f72206465636f6d7072657373696e672e>-.15 +F .054<546869732073706565647320757020746865206f7065726174696f6e206f6620 +6c7a6f702061206c6974746c65206269742028657370656369616c6c79207768656e2064 +65636f6d7072657373696e67292c2062>128 309.6 R .054 +<757420617320756e6e6f74696365642064617461>-.2 F .893<636f7272757074696f +6e2063616e2068617070656e20696e2063617365206f662064616d6167656420636f6d70 +726573736564208c6c657320746865207573616765206f662074686973206f7074696f6e +206973206e6f742067656e6572616c6c79>128 321.6 R 6.326 +<7265636f6d6d656e6465642e20416c736f2c>128 333.6 R 6.326<6163>6.326 G +3.826<6865636b73756d20697320616c>-6.326 F -.1<7761>-.1 G 3.825<79732073 +746f726564207768656e20636f6d7072657373696e672077697468206f6e65206f662074 +686520736c6f>.1 F<77>-.25 E<636f6d7072657373696f6e206c65>128 345.6 Q +-.15<7665>-.25 G<6c732028ad372c20ad38206f7220ad39292c207265>.15 E -.05 +<6761>-.15 G<72646c657373206f662074686973206f7074696f6e2e>.05 E +<ad6e2c20adad6e6fad6e616d65>108 362.4 Q .042<5768656e206465636f6d707265 +7373696e672c20646f206e6f7420726573746f726520746865206f726967696e616c208c +6c65206e616d652069662070726573656e74202872656d6f>128 374.4 R .342 -.15 +<7665206f>-.15 H .042<6e6c7920746865206c7a6f7020737566>.15 F .042 +<8c782066726f6d>-.25 F<74686520636f6d70726573736564208c6c65206e616d6529 +2e2054686973206f7074696f6e2069732074686520646566>128 386.4 Q +<61756c7420756e646572>-.1 E/F4 9/Times-Roman@0 SF<554e4958>2.5 E F0<2e>A +<ad4e2c20adad6e616d65>108 403.2 Q .34<5768656e206465636f6d7072657373696e +672c20726573746f726520746865206f726967696e616c208c6c65206e616d6520696620 +70726573656e742e2054686973206f7074696f6e2069732075736566756c206f6e207379 +7374656d73207768696368>128 415.2 R<6861>128 427.2 Q .423 -.15 +<76652061206c>-.2 H .123<696d6974206f6e208c6c65206e616d65206c656e677468 +2e20496620746865206f726967696e616c206e616d65207361>.15 F -.15<7665>-.2 G +2.623<6469>.15 G 2.623<6e74>-2.623 G .123<686520636f6d70726573736564208c +6c65206973206e6f74207375697461626c6520666f7220697473>-2.623 F 1.672 +<8c6c652073797374656d2c2061206e65>128 439.2 R 4.171<776e>-.25 G 1.671<61 +6d6520697320636f6e73747275637465642066726f6d20746865206f726967696e616c20 +6f6e6520746f206d616b>-4.171 F 4.171<6569>-.1 G 4.171<746c>-4.171 G -2.25 +-.15<65672061>-4.171 H 4.171<6c2e2054686973>.15 F 1.671 +<6f7074696f6e20697320746865>4.171 F<646566>128 451.2 Q +<61756c7420756e646572>-.1 E F4<444f53>2.5 E F0 2.5<2c57>C<696e646f>-2.9 +E<777320616e64>-.25 E F4<4f532f32>2.5 E F0<2e>A 6.3<ad50205768656e>108 +468 R .386<6465636f6d7072657373696e672c20726573746f726520746865206f7269 +67696e616c207061746820616e64208c6c65206e616d652069662070726573656e742e> +2.886 F .387<5768656e20636f6d7072657373696e672c2073746f726520746865> +5.387 F<72656c617469>128 480 Q .647 -.15<76652028>-.25 H .347 +<616e6420636c65616e6564292070617468206e616d652e>.15 F .346<54686973206f +7074696f6e206973206d61696e6c792075736566756c207768656e207573696e67>5.346 +F F3<6172>2.846 E<636869>-.18 E .546 -.1<7665206d>-.1 H<6f6465>.1 E F0 +2.846<ad73>2.846 G .346<6565207573616765>-2.846 F -.15<6578>128 492 S +<616d706c65732062656c6f>.15 E -.65<772e>-.25 G<adad6e6fad6d6f6465>108 +508.8 Q<5768656e206465636f6d7072657373696e672c20646f206e6f7420726573746f +726520746865206f726967696e616c206d6f646520287065726d697373696f6e73292073 +61>128 520.8 Q -.15<7665>-.2 G 2.5<6469>.15 G 2.5<6e74>-2.5 G +<686520636f6d70726573736564208c6c652e>-2.5 E<adad6e6fad74696d65>108 +537.6 Q<5768656e206465636f6d7072657373696e672c20646f206e6f7420726573746f +726520746865206f726967696e616c2074696d65207374616d70207361>128 549.6 Q +-.15<7665>-.2 G 2.5<6469>.15 G 2.5<6e74>-2.5 G +<686520636f6d70726573736564208c6c652e>-2.5 E<ad53>108 566.4 Q/F5 10 +/Times-Italic@0 SF<2e737566>2.5 E F0 2.5<2cad>C<ad737566>-2.5 E<8c783d> +-.25 E F5<2e737566>A F0 .248<55736520737566>128 578.4 R<8c78>-.25 E F5 +<2e737566>2.748 E F0 .248<696e7374656164206f66>2.748 F F5<2e6c7a6f>2.748 +E F0 2.748<2e54>C .248<686520737566>-2.748 F .248<8c78206d757374206e6f74 +20636f6e7461696e206d756c7469706c6520646f747320616e64207370656369616c2063 +686172616374657273206c696b>-.25 F 2.749<6527>-.1 G<2b27>-2.749 E .699 +<6f7220272a272c20616e6420737566>128 590.4 R<8c78>-.25 E .699 +<6573206f74686572207468616e>-.15 F F5<2e6c7a6f>3.199 E F0 .699 +<73686f756c642062652061>3.199 F -.2<766f>-.2 G .699<6964656420746f2061> +.2 F -.2<766f>-.2 G .699<696420636f6e667573696f6e207768656e208c6c657320 +617265207472616e7366657272656420746f>.2 F<6f746865722073797374656d732e> +128 602.4 Q<ad6b2c20adad6b>108 619.2 Q<656570>-.1 E<446f206e6f742064656c +65746520696e707574208c6c65732e20546869732069732074686520646566>128 631.2 +Q<61756c742e>-.1 E<ad552c20adad756e6c696e6b2c20adad64656c657465>108 648 +Q .278<44656c65746520696e707574208c6c6573206166746572207375636365736675 +6c6c20636f6d7072657373696f6e206f72206465636f6d7072657373696f6e2e20557365 +2074686973206f7074696f6e20746f206d616b>128 660 R 2.779<656c>-.1 G .279 +<7a6f702062656861>-2.779 F -.15<7665>-.2 G<6c696b>128 672 Q<65>-.1 E F3 +<677a6970>2.5 E F0<616e64>2.5 E F3<627a697032>2.5 E F0 5<2e4e>C +<6f746520746861742065>-5 E<78706c696369746c79206769>-.15 E<76696e67>-.25 +E F3<ad6b>2.5 E F0 -.15<6f7665>2.5 G<727269646573>.15 E F3<ad55>2.5 E F0 +<2e>A<adad6372633332>108 688.8 Q<557365206120637263333220636865636b7375 +6d20696e7374656164206f6620612061646c6572333220636865636b73756d2e>128 +700.8 Q<6c7a6f7020312e3033>72 768 Q 203.17<323031302d31312d30362033> +173.45 F 0 Cg EP +%%Page: 4 4 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R +<adad6e6fad77>108 84 Q<61726e>-.1 E<537570707265737320616c6c2077>128 96 +Q<61726e696e67732e>-.1 E<adad69676e6f7265ad77>108 112.8 Q<61726e>-.1 E +<537570707265737320616c6c2077>128 124.8 Q +<61726e696e67732c20616e64206e65>-.1 E -.15<7665>-.25 G 2.5<7265>.15 G +<78697420776974682065>-2.65 E<7869742073746174757320322e>-.15 E +<ad712c20adad71756965742c20adad73696c656e74>108 141.6 Q +<537570707265737320616c6c2077>128 153.6 Q +<61726e696e677320616e64206465637265617365207468652076>-.1 E +<6572626f73697479206f6620736f6d6520636f6d6d616e6473206c696b>-.15 E<65> +-.1 E/F1 10/Times-Bold@0 SF<adad6c697374>2.5 E F0<6f72>2.5 E F1 +<adad74657374>2.5 E F0<2e>A<ad76>108 170.4 Q 2.5<2cad>-.65 G<ad76>-2.5 E +<6572626f7365>-.15 E -1.11<5665>128 182.4 S 1.518<72626f73652e2044697370 +6c617920746865206e616d6520666f722065616368208c6c6520636f6d70726573736564 +206f72206465636f6d707265737365642e204d756c7469706c65>1.11 F F1<ad76> +4.018 E F0 1.518<63616e206265207573656420746f>4.018 F +<696e637265617365207468652076>128 194.4 Q +<6572626f73697479206f6620736f6d6520636f6d6d616e6473206c696b>-.15 E<65> +-.1 E F1<adad6c697374>2.5 E F0<6f72>2.5 E F1<adad74657374>2.5 E F0<2e>A +6.22<adad2053706563698c6573>108 211.2 R .247<74686174207468697320697320 +74686520656e64206f6620746865206f7074696f6e732e20416e>2.747 F 2.747<798c> +-.15 G .248<6c65206e616d65206166746572>-2.747 F F1<adad>2.748 E F0 .248< +77696c6c206e6f7420626520696e74657270726574656420617320616e206f7074696f6e> +2.748 F -2.15 -.25<65762065>128 223.2 T 2.5<6e69>.25 G 2.5<6669>-2.5 G +2.5<7473>-2.5 G<7461727473207769746820612068>-2.5 E<797068656e2e>-.05 E +/F2 10.95/Times-Bold@0 SF -.438<4f54>72 240 S<484552204f5054494f4e53> +.438 E F0<adad6e6fad737464696e>108 252 Q .551<446f206e6f742074727920746f +2072656164207374616e6461726420696e707574202862>128 264 R .551 +<75742061208c6c65206e616d652060>-.2 F<60ad27>-.74 E 3.051<2777>-.74 G +.551<696c6c207374696c6c206f>-3.051 F -.15<7665>-.15 G .551 +<72726964652074686973206f7074696f6e292e>.15 F .551<496e206f6c642076> +5.551 F<657273696f6e73>-.15 E<6f66>128 276 Q F1<6c7a6f70>2.5 E F0 2.5 +<2c74>C<686973206f7074696f6e2077>-2.5 E<6173206e656365737361727920776865 +6e207573656420696e2063726f6e206a6f62732028776869636820646f206e6f74206861> +-.1 E .3 -.15<766520612063>-.2 H +<6f6e74726f6c6c696e67207465726d696e616c292e>.15 E<adad8c6c7465723d>108 +292.8 Q/F3 9/Times-Italic@0 SF<4e554d424552>A F0 1.876 +<526172656c792075736566756c2e>128 304.8 R 1.876 +<50726570726f63657373206461746120776974682061207370656369616c2060>6.876 +F<606d756c74696d6564696127>-.74 E 4.376<278c>-.74 G 1.876 +<6c746572206265666f726520636f6d7072657373696e6720696e206f7264657220746f> +-4.376 F<696d70726f>128 316.8 Q .326 -.15<76652063>-.15 H .026 +<6f6d7072657373696f6e20726174696f2e>.15 F F3<4e554d424552>5.026 E F0 +.025<6d757374206265206120646563696d616c206e756d6265722066726f6d20312074 +6f2031362c20696e636c757369>2.526 F -.15<7665>-.25 G 5.025<2e55>.15 G +.025<73696e672061208c6c746572>-5.025 F<736c6f>128 328.8 Q 2.331 +<777320646f>-.25 F 2.332<776e20626f746820636f6d7072657373696f6e20616e64 +206465636f6d7072657373696f6e2071756974652061206269742c20616e642074686520 +636f6d7072657373696f6e20726174696f20757375616c6c79>-.25 F<646f65736e27> +128 340.8 Q 2.5<7469>-.18 G<6d70726f>-2.5 E .3 -.15<7665206d>-.15 H +<75636820656974686572>.15 E 2.5<2e2e2e204d6f7265>-.55 F<6566>2.5 E +<6665637469>-.25 E .3 -.15<7665208c>-.25 H<6c74657273206d61792062652061 +6464656420696e20746865206675747572652c2074686f7567682e>.15 E -1.1<596f> +128 358.8 S 2.516<7563>1.1 G .016 +<616e2074727920adad8c6c7465723d3120776974682064617461206c696b>-2.516 F +2.515<6538>-.1 G .015<ad62697420736f756e642073616d706c65732c20adad8c6c74 +65723d322077697468203136ad6269742073616d706c6573206f72206465707468ad3136> +-2.515 F<696d616765732c206574632e>128 370.8 Q<556e2d8c6c746572696e672064 +7572696e67206465636f6d7072657373696f6e2069732068616e646c6564206175746f6d +61746963616c6c79>128 388.8 Q<2e>-.65 E<ad432c20adad636865636b73756d>108 +405.6 Q 1.051<446570726563617465642e204f6e6c7920666f7220636f6d7061746962 +696c69747920776974682076>128 417.6 R 1.051<657279206f6c642076>-.15 F +1.051<657273696f6e73206173206c7a6f70206e6f>-.15 F 3.552<7775>-.25 G +1.052<736573206120636865636b73756d20627920646566>-3.552 F<61756c742e>-.1 +E<54686973206f7074696f6e2077696c6c206765742072656d6f>128 429.6 Q -.15 +<7665>-.15 G 2.5<6469>.15 G 2.5<6e6166>-2.5 G +<75747572652072656c656173652e>-2.5 E<adad6e6fad636f6c6f72>108 446.4 Q +<446f206e6f742075736520616e>128 458.4 Q 2.5<7963>-.15 G +<6f6c6f72206573636170652073657175656e6365732e>-2.5 E<adad6d6f6e6f>108 +475.2 Q<417373756d652061206d6f6e6f>128 487.2 Q/F4 9/Times-Roman@0 SF +<414e5349>2.5 E F0<7465726d696e616c2e20546869732069732074686520646566> +2.5 E<61756c7420756e646572>-.1 E F4<554e4958>2.5 E F0<28696620636f6e736f +6c6520737570706f727420697320636f6d70696c656420696e292e>2.5 E +<adad636f6c6f72>108 504 Q .532<417373756d65206120636f6c6f72>128 516 R F4 +<414e5349>3.032 E F0 .531<7465726d696e616c206f72207472792066756c6c2d7363 +7265656e206163636573732e20546869732069732074686520646566>3.032 F .531 +<61756c7420756e646572>-.1 F F4<444f53>3.031 E F0 .531 +<616e6420696e2061204c696e7578>3.031 F<7669727475616c20636f6e736f6c652028 +696620636f6e736f6c6520737570706f727420697320636f6d70696c656420696e292e> +128 528 Q F2<4144>72 544.8 Q -1.478<5641>-.438 G<4e43454420555341>1.478 +E<4745>-.602 E F0<6c7a6f7020616c6c6f>108 556.8 Q<777320796f7520746f2064 +65616c207769746820796f7572208c6c657320696e206d616e>-.25 E 2.5<798d>-.15 +G -.15<6578>-2.5 G<69626c652077>.15 E +<6179732e20486572652061726520736f6d652075736167652065>-.1 E +<78616d706c65733a>-.15 E F1<6261636b7570206d6f6465>108 573.6 Q/F5 10 +/Courier@0 SF<74617220adad757365ad636f6d7072657373ad70726f6772616d3d6c7a +6f7020ad636620617263686976652e7461722e6c7a6f2066696c65732e2e>125 585.6 Q +<5468697320697320746865207265636f6d6d656e646564206d6f646520666f72206372 +656174696e67206261636b7570732e>125 609.6 Q<526571756972657320474e552074 +6172206f72206120636f6d70617469626c652076657273696f6e20776869636820616363 +6570747320746865>125 621.6 Q<08adad757365ad636f6d7072657373ad70726f6772 +616d3d58585808206f7074696f6e2e>125 633.6 Q F1 +<73696e676c65208c6c65206d6f64653a>108 650.4 Q F0<696e6469>2.5 E +<76696475616c6c792028646529636f6d70726573732065616368208c6c65>-.25 E F5 +<637265617465>119 662.4 Q<6c7a6f7020612e63>131 674.4 Q +<ad3e2063726561746520612e632e6c7a6f>78 E<6c7a6f7020612e6320622e63>131 +686.4 Q<ad3e2063726561746520612e632e6c7a6f202620622e632e6c7a6f>54 E +<6c7a6f7020ad5520612e6320622e63>131 698.4 Q<ad3e2063726561746520612e632e +6c7a6f202620622e632e6c7a6f20616e642064656c65746520612e63202620622e63>36 +E<6c7a6f70202a2e63>131 710.4 Q F0<6c7a6f7020312e3033>72 768 Q 203.17 +<323031302d31312d30362034>173.45 F 0 Cg EP +%%Page: 5 5 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R/F1 +10/Courier@0 SF<65787472616374>119 84 Q<6c7a6f7020ad6420612e632e6c7a6f> +131 96 Q<ad3e20726573746f726520612e63>36 E +<6c7a6f7020ad646620612e632e6c7a6f>131 108 Q<ad3e20726573746f726520612e63 +2c206f766572777269746520696620616c726561647920657869737473>30 E +<6c7a6f7020ad64202a2e6c7a6f>131 120 Q<6c697374>119 144 Q +<6c7a6f7020ad6c20612e632e6c7a6f>131 156 Q<6c7a6f7020ad6c202a2e6c7a6f>131 +168 Q<6c7a6f7020ad6c76202a2e6c7a6f>131 180 Q<ad3e20626520766572626f7365> +42 E<74657374>119 204 Q<6c7a6f7020ad7420612e632e6c7a6f>131 216 Q +<6c7a6f7020ad7471202a2e6c7a6f>131 228 Q<ad3e206265207175696574>42 E/F2 +10/Times-Bold@0 SF<70697065206d6f64653a>108 244.8 Q F0 +<28646529636f6d70726573732066726f6d20737464696e20746f207374646f7574>2.5 +E F1<637265617465>119 256.8 Q<6c7a6f70203c20612e63203e20792e6c7a6f>131 +268.8 Q<63617420612e63207c206c7a6f70203e20792e6c7a6f>131 280.8 Q +<74617220ad636620ad202a2e63207c206c7a6f70203e20792e7461722e6c7a6f>131 +292.8 Q<ad3e20637265617465206120636f6d70726573736564207461722066696c65> +30 E<65787472616374>119 316.8 Q +<6c7a6f7020ad64203c20792e6c7a6f203e20612e63>131 328.8 Q +<6c7a6f7020ad64203c20792e7461722e6c7a6f207c2074617220ad78766620ad>131 +340.8 Q<ad3e20657874726163742061207461722066696c65>30 E<6c697374>119 +364.8 Q<6c7a6f7020ad6c203c20792e6c7a6f>131 376.8 Q +<63617420792e6c7a6f207c206c7a6f7020ad6c>131 388.8 Q +<6c7a6f7020ad64203c20792e7461722e6c7a6f207c2074617220ad74766620ad>131 +400.8 Q<ad3e206c6973742061207461722066696c65>30 E<74657374>119 424.8 Q +<6c7a6f7020ad74203c20792e6c7a6f>131 436.8 Q +<63617420792e6c7a6f207c206c7a6f7020ad74>131 448.8 Q F2 +<7374646f7574206d6f64653a>108 465.6 Q F0 +<28646529636f6d707265737320746f207374646f7574>2.5 E F1<637265617465>119 +477.6 Q<6c7a6f7020ad6320612e63203e20792e6c7a6f>131 489.6 Q +<65787472616374>119 513.6 Q<6c7a6f7020ad646320792e6c7a6f203e20612e63>131 +525.6 Q<6c7a6f7020ad646320792e7461722e6c7a6f207c2074617220ad78766620ad> +131 537.6 Q<ad3e20657874726163742061207461722066696c65>36 E<6c697374>119 +561.6 Q<6c7a6f7020ad646320792e7461722e6c7a6f207c2074617220ad74766620ad> +131 573.6 Q<ad3e206c6973742061207461722066696c65>36 E F2<6172>108 590.4 +Q<636869>-.18 E .2 -.1<7665206d>-.1 H<6f64653a>.1 E F0 +<636f6d70726573732f65>2.5 E<787472616374206d756c7469706c65208c6c65732069 +6e746f20612073696e676c65206172636869>-.15 E .3 -.15<7665208c>-.25 H +<6c65>.15 E F1<637265617465>119 602.4 Q +<6c7a6f7020612e6320622e6320ad6f20736f75726365732e6c7a6f>131 614.4 Q +<ad3e2063726561746520616e2061726368697665>60 E +<6c7a6f7020ad50207372632f2a2e6320ad6f20736f75726365732e6c7a6f>131 626.4 +Q<ad3e2063726561746520616e20617263686976652c2073746f72652070617468206e61 +6d65>42 E<6c7a6f7020ad63202a2e63203e20736f75726365732e6c7a6f>131 638.4 Q +<ad3e20616e6f746865722077617920746f2063726561746520616e2061726368697665> +72 E<6c7a6f7020ad63202a2e68203e3e20736f75726365732e6c7a6f>131 650.4 Q +<ad3e206164642066696c657320746f2061726368697665>66 E<65787472616374>119 +674.4 Q<6c7a6f7020ad644e20736f75726365732e6c7a6f>131 686.4 Q +<6c7a6f7020ad78202e2e2f7372632f736f75726365732e6c7a6f>131 698.4 Q +<ad3e206578747261637420746f2063757272656e74206469726563746f7279>66 E +<6c7a6f7020ad7820ad702f746d70203c202e2e2f7372632f736f75726365732e6c7a6f> +131 710.4 Q<ad3e206578747261637420746f202f746d70206469726563746f7279>12 +E F0<6c7a6f7020312e3033>72 768 Q 203.17<323031302d31312d30362035>173.45 +F 0 Cg EP +%%Page: 6 6 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF 392.18<4c5a4f50283129204c5a4f50283129>72 48 R/F1 +10/Courier@0 SF<6c697374>119 84 Q +<6c7a6f7020ad6c4e7620736f75726365732e6c7a6f>131 96 Q<74657374>119 120 Q +<6c7a6f7020ad7420736f75726365732e6c7a6f>131 132 Q +<6c7a6f7020ad74767620736f75726365732e6c7a6f>131 144 Q +<ad3e206265207665727920766572626f7365>96 E F0 1.041<496620796f7520776973 +6820746f2063726561746520612073696e676c65206172636869>108 160.8 R 1.341 +-.15<7665208c>-.25 H 1.041<6c652077697468206d756c7469706c65206d656d6265 +727320736f2074686174206d656d626572732063616e206c617465722062652065>.15 F +<7874726163746564>-.15 E<696e646570656e64656e746c79>108 172.8 Q 2.738 +<2c79>-.65 G .238<6f752073686f756c642070726566657220612066756c6c2d666561 +7475726564206172636869>-2.738 F -.15<7665>-.25 G 2.737<7273>.15 G .237 +<75636820617320746172>-2.737 F 2.737<2e54>-.55 G .237 +<6865206c61746573742076>-2.737 F .237<657273696f6e206f66>-.15 F/F2 9 +/Times-Roman@0 SF<474e55>2.737 E F0 .237<74617220737570706f727473>2.737 +F<746865>108 184.8 Q/F3 10/Times-Bold@0 SF<adad757365ad636f6d7072>6.941 +E<657373ad7072>-.18 E<6f6772616d3d6c7a6f70>-.18 E F0 4.442 +<6f7074696f6e20746f20696e>6.941 F -.2<766f>-.4 G 4.642 -.1<6b65206c>.2 H +4.442<7a6f70207472616e73706172656e746c79>.1 F 9.442<2e6c>-.65 G 4.442 +<7a6f702069732064657369676e65642061732061>-9.442 F +<636f6d706c656d656e7420746f20746172>108 196.8 Q 2.5<2c6e>-.4 G +<6f742061732061207265706c6163656d656e742e>-2.5 E/F4 10.95/Times-Bold@0 +SF<454e564952>72 213.6 Q<4f4e4d454e54>-.329 E F0 1.059<54686520656e>108 +225.6 R 1.059<7669726f6e6d656e742076>-.4 F<61726961626c65>-.25 E/F5 9 +/Times-Bold@0 SF<4c5a4f50>3.559 E F0 1.058 +<63616e20686f6c64206120736574206f6620646566>3.559 F 1.058<61756c74206f70 +74696f6e7320666f72206c7a6f702e205468657365206f7074696f6e732061726520696e +746572707265746564>-.1 F<8c72737420616e642063616e206265206f>108 237.6 Q +-.15<7665>-.15 G<727772697474656e2062792065>.15 E +<78706c6963697420636f6d6d616e64206c696e6520706172616d65746572732e>-.15 E +-.15<466f>5 G 2.5<7265>.15 G<78616d706c653a>-2.65 E F1 +<666f722073682f6b73682f7a73683a>132 254.4 Q +<4c5a4f503d22ad317620adad6e616d65223b206578706f7274204c5a4f50>24 E +<666f72206373682f746373683a>132 266.4 Q +<736574656e76204c5a4f502022ad317620adad6e616d6522>36 E +<666f7220444f532f57696e646f77733a>132 278.4 Q +<736574204c5a4f503dad317620adad6e616d65>18 E F0 .615<4f6e2056>108 295.2 +R .616<61782f564d532c20746865206e616d65206f662074686520656e>-1.11 F .616 +<7669726f6e6d656e742076>-.4 F .616<61726961626c65206973>-.25 F F2 +<4c5a4f505f4f5054>3.116 E F0 3.116<2c74>C 3.116<6f61>-3.116 G -.2<766f> +-3.316 G .616 +<6964206120636f6e8d6963742077697468207468652073796d626f6c20736574>.2 F +<666f7220696e>108 307.2 Q -.2<766f>-.4 G +<636174696f6e206f66207468652070726f6772616d2e>.2 E +<4e6f7420616c6c206f6620746865206f7074696f6e73206172652076>108 324 Q +<616c696420696e2074686520656e>-.25 E<7669726f6e6d656e742076>-.4 E +<61726961626c6520ad206c7a6f702077696c6c2074656c6c20796f752e>-.25 E F4 +<53454520414c534f>72 340.8 Q F3<627a697032>108 352.8 Q F0<2831292c>A F3 +<677a6970>2.5 E F0<2831292c>A F3<746172>2.5 E F0<283129>A<507265636f6d70 +696c65642062696e617269657320666f7220736f6d6520706c6174666f726d7320617265 +2061>108 369.6 Q -.25<7661>-.2 G +<696c61626c652066726f6d20746865206c7a6f7020686f6d6520706167652e>.25 E F1 +<73656520687474703a2f2f7777772e6f62657268756d65722e636f6d2f6f70656e736f +757263652f6c7a6f702f>132 386.4 Q F0<6c7a6f70207573657320746865>108 403.2 +Q F2<4c5a4f>2.5 E F0<6461746120636f6d7072657373696f6e206c69627261727920 +666f7220636f6d7072657373696f6e2073657276696365732e>2.5 E F1<736565206874 +74703a2f2f7777772e6f62657268756d65722e636f6d2f6f70656e736f757263652f6c7a +6f2f>132 420 Q F4<444941>72 436.8 Q<474e4f5354494353>-.602 E F0 1.148<45 +78697420737461747573206973206e6f726d616c6c7920303b20696620616e206572726f +72206f63637572732c2065>108 448.8 R 1.148 +<7869742073746174757320697320312e20496620612077>-.15 F 1.148 +<61726e696e67206f63637572732c2065>-.1 F 1.148 +<7869742073746174757320697320322028756e6c657373>-.15 F<6f7074696f6e>108 +460.8 Q F3<adad69676e6f72>2.5 E<65ad776172>-.18 E<6e>-.15 E F0 +<697320696e206566>2.5 E<66656374292e>-.25 E F3<6c7a6f7027>108 477.6 Q +<73>-.37 E F0<646961676e6f73746963732061726520696e74656e64656420746f2062 +652073656c662d65>2.5 E<78706c616e61746f7279>-.15 E<2e>-.65 E F4 -.11 +<4255>72 494.4 S<4753>.11 E F0<4e6f2062>108 506.4 Q +<75677320617265206b6e6f>-.2 E<776e2e20506c65617365207265706f727420616c6c +2070726f626c656d7320696d6d6564696174656c7920746f2074686520617574686f72> +-.25 E<2e>-.55 E F4 -.548<4155>72 523.2 S<54484f52>.548 E F0 29.496 +<4d61726b7573204672616e7a205861>108 535.2 R -.15<7665>-.2 G 31.996<724a> +.15 G 29.496 +<6f68616e6e6573204f62657268756d6572203c6d61726b7573406f62657268756d6572> +-31.996 F<2e636f6d3e>-.55 E<687474703a2f2f777777>108 547.2 Q +<2e6f62657268756d6572>-.65 E<2e636f6d2f6f70656e736f757263652f6c7a6f702f> +-.55 E F4<434f50595249474854>72 564 Q F0 .616<6c7a6f7020616e6420746865> +108 576 R F2<4c5a4f>3.116 E F0 .616<6c6962726172792061726520436f70>3.116 +F .615<7972696768742028432920313939362c20313939372c20313939382c20313939 +392c20323030302c20323030312c20323030322c20323030332c20323030342c20323030 +352c>-.1 F<323030362c20323030372c20323030382c20323030392c20323031302062 +79204d61726b7573204672616e7a205861>108 588 Q -.15<7665>-.2 G 2.5<724a> +.15 G<6f68616e6e6573204f62657268756d6572>-2.5 E 5<2e41>-.55 G +<6c6c2052696768747320526573657276>-5 E<65642e>-.15 E +<6c7a6f7020616e6420746865>108 604.8 Q F2<4c5a4f>2.5 E F0 +<6c696272617279206172652064697374726962>2.5 E +<7574656420756e64657220746865207465726d73206f6620746865>-.2 E F2<474e55> +2.5 E F0<47656e6572616c205075626c6963204c6963656e73652028>2.5 E F2 +<47504c>A F0<292e>A<4c65>108 621.6 Q -.05<6761>-.15 G 3.012<6c69>.05 G +.512<6e666f3a2049662077>-3.012 F .512<616e7420746f20696e7465>-.1 F .513< +6772617465206c7a6f7020696e746f20796f757220636f6d6d65726369616c2028626163 +6b7570ad2973797374656d20706c65617365206361726566756c6c792072656164207468 +65>-.15 F F2<474e55>3.013 E .25<47504c2046>108 633.6 R -.495<4151>-.666 +G F0<617420687474703a2f2f777777>2.995 E<2e676e752e6f72>-.65 E +<672f6c6963656e7365732f67706cad66>-.18 E<61712e68746d6c2061626f75742070 +6f737369626c6520696d706c69636174696f6e732e>-.1 E<6c7a6f7020312e3033>72 +768 Q 203.17<323031302d31312d30362036>173.45 F 0 Cg EP +%%Trailer +end +%%EOF diff --git a/doc/lzop.tex b/doc/lzop.tex new file mode 100644 index 0000000..430b1b5 --- /dev/null +++ b/doc/lzop.tex @@ -0,0 +1,646 @@ +\section{NAME\label{NAME}\index{NAME}} + + +lzop - compress or expand files + +\section{ABSTRACT\label{ABSTRACT}\index{ABSTRACT}} + + +\textbf{lzop} is a file compressor very similar to \textbf{gzip}. +\textbf{lzop} favors speed over compression ratio. + +\section{SYNOPSIS\label{SYNOPSIS}\index{SYNOPSIS}} + + +\textbf{lzop} [~\textit{command}~] [~\textit{options}~] [~\textit{filename}~...~~] + + + +\textbf{lzop} [\textbf{-dxlthIVL19}] [\textbf{-qvcfFnNPkU}] +[\textbf{-o}~\textit{file}] [\textbf{-p}[\textit{path}]] [\textbf{-S}~\textit{suffix}] +[\textit{filename}~...] + +\section{DESCRIPTION\label{DESCRIPTION}\index{DESCRIPTION}} + + +\textbf{lzop} reduces the size of the named files. Whenever possible, +each file is compressed into one with the extension +\textbf{.lzo}, while keeping the same ownership modes, access and +modification times. If no files are specified, or if a +file name is "-", 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. + + + +If the compressed file name is too long for its file system, +\textbf{lzop} truncates it. + + + +Compressed files can be restored to their original form +using \textbf{lzop~-d}. +\textbf{lzop~-d} takes a list of files on its command line and +decompresses each file whose name ends with \textbf{.lzo} and which +begins with the correct magic number to an uncompressed +file without the original extension. \textbf{lzop~-d} also recognizes +the special extension \textbf{.tzo} as shorthand for \textbf{.tar.lzo}. +When compressing, lzop uses the \textbf{.tzo} extension if necessary +instead of truncating a file with a \textbf{.tar} extension. + + + +\textbf{lzop} stores the original file name, mode and time stamp +in the compressed file. These can be used when +decompressing the file with the \textbf{-d} option. This is useful when +the compressed file name was truncated or when the time +stamp was not preserved after a file transfer. + + + +\textbf{lzop} 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 \textbf{-n}, \textbf{-N}, \textbf{--no-mode} and \textbf{--no-time} +for more information. + + + +\textbf{lzop} always keeps original files unchanged unless +you use the option \textbf{-U}. + + + +\textbf{lzop} uses the \textit{LZO data compression library} 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 \textbf{gzip}, but +compression ratio is worse. + +\subsection*{COMPRESSION LEVELS\label{COMPRESSION_LEVELS}\index{COMPRESSION LEVELS}} + + +lzop offers the following compression levels of the +LZO1X algorithm: + +\begin{description} + +\item[{-3}] \mbox{} + +the default level offers pretty fast compression. +-2, -3, -4, -5 and -6 are currently all equivalent - this +may change in a future release. + + +\item[{-1, --fast}] \mbox{} + +can be even a little bit faster in some cases - but +most times you won't notice the difference + + +\item[{-7, -8, -9, --best}] \mbox{} + +these compression levels are mainly intended for generating +pre-compressed data - especially \textbf{-9} can be somewhat slow + +\end{description} + + +Decompression is \textit{very} fast for all compression levels, +and decompression speed is not affected by the compression +level. + +\section{MAIN COMMAND\label{MAIN_COMMAND}\index{MAIN COMMAND}} + + +If no other command is given then lzop defaults to compression +(using compression level -3). + +\begin{description} + +\item[{-\#, --fast, --best}] \mbox{} + +Regulate the speed of compression using the specified +digit \textbf{\#}, 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. + + +\item[{-d, --decompress, --uncompress}] \mbox{} + +Decompress. Each file will be placed into +same the directory as the compressed file. + + +\item[{-x, --extract}] \mbox{} + +Extract compressed files to the current working +directory. This is the same as '-dPp'. + + +\item[{-t, --test}] \mbox{} + +Test. Check the compressed file integrity. + + +\item[{-l, --list}] \mbox{} + +For each compressed file, list the following +fields: + +\begin{verbatim} + 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 +\end{verbatim} + + +In combination with the --verbose option, the following +fields are also displayed: + +\begin{verbatim} + date & time: time stamp for the uncompressed file +\end{verbatim} + + +With --name, the uncompressed name, date and time +are those stored within the compress file if present. + + + +With --verbose, the size totals and compression +ratio for all files is also displayed. With +--quiet, the title and totals lines are not displayed. + + + +Note that lzop defines compression ratio +as compressed\_size / uncompressed\_size. + + +\item[{--ls, --ls=\textit{FLAGS}}] \mbox{} + +List each compressed file in a format similar to \textbf{ls~-ln}. + + + +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. + + +\item[{--info}] \mbox{} + +For each compressed file, list the internal header fields. + + +\item[{-I, --sysinfo}] \mbox{} + +Display information about the system and quit. + + +\item[{-L, --license}] \mbox{} + +Display the lzop license and quit. + + +\item[{-h, -H, --help}] \mbox{} + +Display a help screen and quit. + + +\item[{-V}] \mbox{} + +Version. Display the version number and compilation +options and quit. + + +\item[{--version}] \mbox{} + +Version. Display the version number and quit. + +\end{description} +\section{OPTIONS\label{OPTIONS}\index{OPTIONS}} +\begin{description} + +\item[{-c, --stdout, --to-stdout}] \mbox{} + +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. + + +\item[{-o \textit{FILE}, --output=\textit{FILE}}] \mbox{} + +Write output to the file \textit{FILE}. If there are several +input files, the output consists of a sequence +of independently (de)compressed members. + + +\item[{-p, -p\textit{DIR}, --path=\textit{DIR}}] \mbox{} + +Write output files into the directory \textit{DIR} instead +of the directory determined by the input file. If +\textit{DIR} is omitted, then write to the current working +directory. + + +\item[{-f, --force}] \mbox{} + +Force lzop to + +\begin{verbatim} + - 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 +\end{verbatim} + + +Using \textbf{-f} two or more times forces things like + +\begin{verbatim} + - 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 +\end{verbatim} + + +Use with care. + + +\item[{-F, --no-checksum}] \mbox{} + +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. + + +\item[{-n, --no-name}] \mbox{} + +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 UNIX. + + +\item[{-N, --name}] \mbox{} + +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 DOS, Windows and OS/2. + + +\item[{-P}] \mbox{} + +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 \textbf{archive mode} - see +usage examples below. + + +\item[{--no-mode}] \mbox{} + +When decompressing, do not restore the original +mode (permissions) saved in the compressed file. + + +\item[{--no-time}] \mbox{} + +When decompressing, do not restore the original +time stamp saved in the compressed file. + + +\item[{-S \textit{.suf}, --suffix=\textit{.suf}}] \mbox{} + +Use suffix \textit{.suf} instead of \textit{.lzo}. The suffix must +not contain multiple dots and special characters like '+' or '*', +and suffixes other than \textit{.lzo} should be avoided to avoid confusion +when files are transferred to other systems. + + +\item[{-k, --keep}] \mbox{} + +Do not delete input files. This is the default. + + +\item[{-U, --unlink, --delete}] \mbox{} + +Delete input files after succesfull compression or +decompression. Use this option to make lzop behave +like \textbf{gzip} and \textbf{bzip2}. +Note that explicitly giving \textbf{-k} overrides \textbf{-U}. + + +\item[{--crc32}] \mbox{} + +Use a crc32 checksum instead of a adler32 checksum. + + +\item[{--no-warn}] \mbox{} + +Suppress all warnings. + + +\item[{--ignore-warn}] \mbox{} + +Suppress all warnings, and never exit with exit status 2. + + +\item[{-q, --quiet, --silent}] \mbox{} + +Suppress all warnings and decrease the verbosity of some +commands like \textbf{--list} or \textbf{--test}. + + +\item[{-v, --verbose}] \mbox{} + +Verbose. Display the name for each file compressed +or decompressed. Multiple \textbf{-v} can be used to increase +the verbosity of some commands like \textbf{--list} or \textbf{--test}. + + +\item[{--}] \mbox{} + +Specifies that this is the end of the options. Any file name +after \textbf{--} will not be interpreted as an option even if +it starts with a hyphen. + +\end{description} +\section{OTHER OPTIONS\label{OTHER_OPTIONS}\index{OTHER OPTIONS}} +\begin{description} + +\item[{--no-stdin}] \mbox{} + +Do not try to read standard input (but a file name "-" will +still override this option). +In old versions of \textbf{lzop}, this option was necessary when +used in cron jobs (which do not have a controlling terminal). + + +\item[{--filter=\textit{NUMBER}}] \mbox{} + +Rarely useful. +Preprocess data with a special "multimedia" filter +before compressing in order to improve compression ratio. +\textit{NUMBER} 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. + + + +You can try --filter=1 with data like 8-bit sound samples, +--filter=2 with 16-bit samples or depth-16 images, etc. + + + +Un-filtering during decompression is handled automatically. + + +\item[{-C, --checksum}] \mbox{} + +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. + + +\item[{--no-color}] \mbox{} + +Do not use any color escape sequences. + + +\item[{--mono}] \mbox{} + +Assume a mono ANSI terminal. This is the default under UNIX +(if console support is compiled in). + + +\item[{--color}] \mbox{} + +Assume a color ANSI terminal or try full-screen access. This +is the default under DOS and in a Linux virtual console +(if console support is compiled in). + +\end{description} +\section{ADVANCED USAGE\label{ADVANCED_USAGE}\index{ADVANCED USAGE}} + + +lzop allows you to deal with your files in many flexible +ways. Here are some usage examples: + +\begin{description} + +\item[{\textbf{backup mode}}] \mbox{}\begin{verbatim} + tar --use-compress-program=lzop -cf archive.tar.lzo files.. +\end{verbatim} +\begin{verbatim} + This is the recommended mode for creating backups. + Requires GNU tar or a compatible version which accepts the + '--use-compress-program=XXX' option. +\end{verbatim} + +\item[{\textbf{single file mode:} individually}] \textbf{(de)compress each file}\begin{verbatim} + 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 +\end{verbatim} +\begin{verbatim} + extract + lzop -d a.c.lzo -> restore a.c + lzop -df a.c.lzo -> restore a.c, overwrite if already exists + lzop -d *.lzo +\end{verbatim} +\begin{verbatim} + list + lzop -l a.c.lzo + lzop -l *.lzo + lzop -lv *.lzo -> be verbose +\end{verbatim} +\begin{verbatim} + test + lzop -t a.c.lzo + lzop -tq *.lzo -> be quiet +\end{verbatim} + +\item[{\textbf{pipe mode:} (de)compress from stdin}] \textbf{to stdout}\begin{verbatim} + create + lzop < a.c > y.lzo + cat a.c | lzop > y.lzo + tar -cf - *.c | lzop > y.tar.lzo -> create a compressed tar file +\end{verbatim} +\begin{verbatim} + extract + lzop -d < y.lzo > a.c + lzop -d < y.tar.lzo | tar -xvf - -> extract a tar file +\end{verbatim} +\begin{verbatim} + list + lzop -l < y.lzo + cat y.lzo | lzop -l + lzop -d < y.tar.lzo | tar -tvf - -> list a tar file +\end{verbatim} +\begin{verbatim} + test + lzop -t < y.lzo + cat y.lzo | lzop -t +\end{verbatim} + +\item[{\textbf{stdout mode:} (de)compress to stdout}] \mbox{}\begin{verbatim} + create + lzop -c a.c > y.lzo +\end{verbatim} +\begin{verbatim} + extract + lzop -dc y.lzo > a.c + lzop -dc y.tar.lzo | tar -xvf - -> extract a tar file +\end{verbatim} +\begin{verbatim} + list + lzop -dc y.tar.lzo | tar -tvf - -> list a tar file +\end{verbatim} + +\item[{\textbf{archive mode:} compress/extract}] \textbf{multiple files into a single archive file}\begin{verbatim} + 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 +\end{verbatim} +\begin{verbatim} + 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 +\end{verbatim} +\begin{verbatim} + list + lzop -lNv sources.lzo +\end{verbatim} +\begin{verbatim} + test + lzop -t sources.lzo + lzop -tvv sources.lzo -> be very verbose +\end{verbatim} +\end{description} + + +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 GNU tar supports the +\textbf{--use-compress-program=lzop} option to invoke lzop transparently. +lzop is designed as a complement to tar, not as +a replacement. + +\section{ENVIRONMENT\label{ENVIRONMENT}\index{ENVIRONMENT}} + + +The environment variable \textbf{LZOP} 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: + +\begin{verbatim} + for sh/ksh/zsh: LZOP="-1v --name"; export LZOP + for csh/tcsh: setenv LZOP "-1v --name" + for DOS/Windows: set LZOP=-1v --name +\end{verbatim} + + +On Vax/VMS, the name of the environment variable is +LZOP\_OPT, to avoid a conflict with the symbol set for +invocation of the program. + + + +Not all of the options are valid in the environment variable - +lzop will tell you. + +\section{SEE ALSO\label{SEE_ALSO}\index{SEE ALSO}} + + +\textbf{bzip2}(1), \textbf{gzip}(1), \textbf{tar}(1) + + + +Precompiled binaries for some platforms are available +from the lzop home page. + +\begin{verbatim} + see http://www.oberhumer.com/opensource/lzop/ +\end{verbatim} + + +lzop uses the LZO data compression library for compression +services. + +\begin{verbatim} + see http://www.oberhumer.com/opensource/lzo/ +\end{verbatim} +\section{DIAGNOSTICS\label{DIAGNOSTICS}\index{DIAGNOSTICS}} + + +Exit status is normally 0; if an error occurs, exit status +is 1. If a warning occurs, exit status is 2 (unless +option \textbf{--ignore-warn} is in effect). + + + +\textbf{lzop's} diagnostics are intended to be self-explanatory. + +\section{BUGS\label{BUGS}\index{BUGS}} + + +No bugs are known. Please report all problems immediately to the author. + +\section{AUTHOR\label{AUTHOR}\index{AUTHOR}} + + +Markus Franz Xaver Johannes Oberhumer +$<$markus@oberhumer.com$>$ +http://www.oberhumer.com/opensource/lzop/ + +\section{COPYRIGHT\label{COPYRIGHT}\index{COPYRIGHT}} + + +lzop and the LZO 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. + + + +lzop and the LZO library are distributed under the terms +of the GNU General Public License (GPL). + + + +Legal info: If want to integrate lzop into your commercial (backup-)system +please carefully read the GNU GPL FAQ at http://www.gnu.org/licenses/gpl-faq.html +about possible implications. + diff --git a/doc/lzop.txt b/doc/lzop.txt new file mode 100644 index 0000000..9e648ed --- /dev/null +++ b/doc/lzop.txt @@ -0,0 +1,423 @@ +NAME + lzop - compress or expand files + +ABSTRACT + lzop is a file compressor very similar to gzip. lzop favors speed over + compression ratio. + +SYNOPSIS + lzop [ *command* ] [ *options* ] [ *filename* ... ] + + lzop [-dxlthIVL19] [-qvcfFnNPkU] [-o *file*] [-p[*path*]] [-S *suffix*] + [*filename* ...] + +DESCRIPTION + lzop reduces the size of the named files. Whenever possible, each file + is compressed into one with the extension .lzo, while keeping the same + ownership modes, access and modification times. If no files are + specified, or if a file name is "-", 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. + + If the compressed file name is too long for its file system, lzop + truncates it. + + Compressed files can be restored to their original form using lzop -d. + lzop -d takes a list of files on its command line and decompresses each + file whose name ends with .lzo and which begins with the correct magic + number to an uncompressed file without the original extension. lzop -d + also recognizes the special extension .tzo as shorthand for .tar.lzo. + When compressing, lzop uses the .tzo extension if necessary instead of + truncating a file with a .tar extension. + + lzop stores the original file name, mode and time stamp in the + compressed file. These can be used when decompressing the file with the + -d option. This is useful when the compressed file name was truncated or + when the time stamp was not preserved after a file transfer. + + lzop 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 -n, -N, --no-mode and + --no-time for more information. + + lzop always keeps original files unchanged unless you use the option -U. + + lzop uses the *LZO data compression library* 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 + gzip, but compression ratio is worse. + + COMPRESSION LEVELS + lzop offers the following compression levels of the LZO1X algorithm: + + -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. + + -1, --fast + can be even a little bit faster in some cases - but most times you + won't notice the difference + + -7, -8, -9, --best + these compression levels are mainly intended for generating + pre-compressed data - especially -9 can be somewhat slow + + Decompression is *very* fast for all compression levels, and + decompression speed is not affected by the compression level. + +MAIN COMMAND + If no other command is given then lzop defaults to compression (using + compression level -3). + + -#, --fast, --best + Regulate the speed of compression using the specified digit #, 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. + + -d, --decompress, --uncompress + Decompress. Each file will be placed into same the directory as the + compressed file. + + -x, --extract + Extract compressed files to the current working directory. This is + the same as '-dPp'. + + -t, --test + Test. Check the compressed file integrity. + + -l, --list + For each compressed file, list the following fields: + + 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 + + In combination with the --verbose option, the following fields are + also displayed: + + date & time: time stamp for the uncompressed file + + With --name, the uncompressed name, date and time are those stored + within the compress file if present. + + With --verbose, the size totals and compression ratio for all files + is also displayed. With --quiet, the title and totals lines are not + displayed. + + Note that lzop defines compression ratio as compressed_size / + uncompressed_size. + + --ls, --ls=*FLAGS* + List each compressed file in a format similar to ls -ln. + + 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. + + --info + For each compressed file, list the internal header fields. + + -I, --sysinfo + Display information about the system and quit. + + -L, --license + Display the lzop license and quit. + + -h, -H, --help + Display a help screen and quit. + + -V Version. Display the version number and compilation options and + quit. + + --version + Version. Display the version number and quit. + +OPTIONS + -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. + + -o *FILE*, --output=*FILE* + Write output to the file *FILE*. If there are several input files, + the output consists of a sequence of independently (de)compressed + members. + + -p, -p*DIR*, --path=*DIR* + Write output files into the directory *DIR* instead of the directory + determined by the input file. If *DIR* is omitted, then write to the + current working directory. + + -f, --force + Force lzop to + + - 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 + + Using -f two or more times forces things like + + - 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 + + Use with care. + + -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. + + -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 UNIX. + + -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 DOS, Windows and + OS/2. + + -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 archive mode - see + usage examples below. + + --no-mode + When decompressing, do not restore the original mode (permissions) + saved in the compressed file. + + --no-time + When decompressing, do not restore the original time stamp saved in + the compressed file. + + -S *.suf*, --suffix=*.suf* + Use suffix *.suf* instead of *.lzo*. The suffix must not contain + multiple dots and special characters like '+' or '*', and suffixes + other than *.lzo* should be avoided to avoid confusion when files + are transferred to other systems. + + -k, --keep + Do not delete input files. This is the default. + + -U, --unlink, --delete + Delete input files after succesfull compression or decompression. + Use this option to make lzop behave like gzip and bzip2. Note that + explicitly giving -k overrides -U. + + --crc32 + Use a crc32 checksum instead of a adler32 checksum. + + --no-warn + Suppress all warnings. + + --ignore-warn + Suppress all warnings, and never exit with exit status 2. + + -q, --quiet, --silent + Suppress all warnings and decrease the verbosity of some commands + like --list or --test. + + -v, --verbose + Verbose. Display the name for each file compressed or decompressed. + Multiple -v can be used to increase the verbosity of some commands + like --list or --test. + + -- Specifies that this is the end of the options. Any file name after + -- will not be interpreted as an option even if it starts with a + hyphen. + +OTHER OPTIONS + --no-stdin + Do not try to read standard input (but a file name "-" will still + override this option). In old versions of lzop, this option was + necessary when used in cron jobs (which do not have a controlling + terminal). + + --filter=*NUMBER* + Rarely useful. Preprocess data with a special "multimedia" filter + before compressing in order to improve compression ratio. *NUMBER* + 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. + + You can try --filter=1 with data like 8-bit sound samples, + --filter=2 with 16-bit samples or depth-16 images, etc. + + Un-filtering during decompression is handled automatically. + + -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. + + --no-color + Do not use any color escape sequences. + + --mono + Assume a mono ANSI terminal. This is the default under UNIX (if + console support is compiled in). + + --color + Assume a color ANSI terminal or try full-screen access. This is the + default under DOS and in a Linux virtual console (if console support + is compiled in). + +ADVANCED USAGE + lzop allows you to deal with your files in many flexible ways. Here are + some usage examples: + + backup mode + 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 + '--use-compress-program=XXX' option. + + single file mode: individually (de)compress each file + 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 + + pipe mode: (de)compress from stdin to stdout + 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 + + stdout mode: (de)compress to stdout + 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 + + archive mode: compress/extract multiple files into a single archive file + 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 + + 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 GNU tar + supports the --use-compress-program=lzop option to invoke lzop + transparently. lzop is designed as a complement to tar, not as a + replacement. + +ENVIRONMENT + The environment variable LZOP 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: + + for sh/ksh/zsh: LZOP="-1v --name"; export LZOP + for csh/tcsh: setenv LZOP "-1v --name" + for DOS/Windows: set LZOP=-1v --name + + On Vax/VMS, the name of the environment variable is LZOP_OPT, to avoid a + conflict with the symbol set for invocation of the program. + + Not all of the options are valid in the environment variable - lzop will + tell you. + +SEE ALSO + bzip2(1), gzip(1), tar(1) + + Precompiled binaries for some platforms are available from the lzop home + page. + + see http://www.oberhumer.com/opensource/lzop/ + + lzop uses the LZO data compression library for compression services. + + see http://www.oberhumer.com/opensource/lzo/ + +DIAGNOSTICS + Exit status is normally 0; if an error occurs, exit status is 1. If a + warning occurs, exit status is 2 (unless option --ignore-warn is in + effect). + + lzop's diagnostics are intended to be self-explanatory. + +BUGS + No bugs are known. Please report all problems immediately to the author. + +AUTHOR + Markus Franz Xaver Johannes Oberhumer <markus@oberhumer.com> + http://www.oberhumer.com/opensource/lzop/ + +COPYRIGHT + lzop and the LZO 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. + + lzop and the LZO library are distributed under the terms of the GNU + General Public License (GPL). + + Legal info: If want to integrate lzop into your commercial + (backup-)system please carefully read the GNU GPL FAQ at + http://www.gnu.org/licenses/gpl-faq.html about possible implications. + diff --git a/doc/magic b/doc/magic new file mode 100644 index 0000000..8ae8ae8 --- /dev/null +++ b/doc/magic @@ -0,0 +1,45 @@ +## +## Magic data for file(1) command. +## Add this to your /etc/magic or /usr/share/misc/magic files. +## + + +# lzop from Markus F.X.J. Oberhumer <markus@oberhumer.com> +0 string \x89\x4c\x5a\x4f\x00\x0d\x0a\x1a\x0a lzop compressed data +>9 beshort <0x0940 +>>9 byte&0xf0 =0x00 - version 0. +>>9 beshort&0x0fff x \b%03x, +>>13 byte 1 LZO1X-1, +>>13 byte 2 LZO1X-1(15), +>>13 byte 3 LZO1X-999, +## >>22 bedate >0 last modified: %s, +>>14 byte =0x00 os: MS-DOS +>>14 byte =0x01 os: Amiga +>>14 byte =0x02 os: VMS +>>14 byte =0x03 os: Unix +>>14 byte =0x05 os: Atari +>>14 byte =0x06 os: OS/2 +>>14 byte =0x07 os: MacOS +>>14 byte =0x0A os: Tops/20 +>>14 byte =0x0B os: WinNT +>>14 byte =0x0E os: Win32 +>9 beshort >0x0939 +>>9 byte&0xf0 =0x00 - version 0. +>>9 byte&0xf0 =0x10 - version 1. +>>9 byte&0xf0 =0x20 - version 2. +>>9 beshort&0x0fff x \b%03x, +>>15 byte 1 LZO1X-1, +>>15 byte 2 LZO1X-1(15), +>>15 byte 3 LZO1X-999, +## >>25 bedate >0 last modified: %s, +>>17 byte =0x00 os: MS-DOS +>>17 byte =0x01 os: Amiga +>>17 byte =0x02 os: VMS +>>17 byte =0x03 os: Unix +>>17 byte =0x05 os: Atari +>>17 byte =0x06 os: OS/2 +>>17 byte =0x07 os: MacOS +>>17 byte =0x0A os: Tops/20 +>>17 byte =0x0B os: WinNT +>>17 byte =0x0E os: Win32 + |