xref: /netbsd-src/usr.bin/gzip/zmore.1 (revision 54844dd551c21a4aceffb1fe0bf9c2da5c8d1a35)
1*54844dd5Spettai.\"	$NetBSD: zmore.1,v 1.4 2013/11/12 21:58:37 pettai Exp $
2*54844dd5Spettai.\"	$OpenBSD: zmore.1,v 1.10 2009/08/16 09:41:08 sobrado Exp $
35ddb4360Smrg.\"
45ddb4360Smrg.\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
55ddb4360Smrg.\"
65ddb4360Smrg.\" Permission to use, copy, modify, and distribute this software for any
75ddb4360Smrg.\" purpose with or without fee is hereby granted, provided that the above
85ddb4360Smrg.\" copyright notice and this permission notice appear in all copies.
95ddb4360Smrg.\"
105ddb4360Smrg.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
115ddb4360Smrg.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
125ddb4360Smrg.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
135ddb4360Smrg.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
145ddb4360Smrg.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
155ddb4360Smrg.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
165ddb4360Smrg.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
175ddb4360Smrg.\"
185ddb4360Smrg.\" Sponsored in part by the Defense Advanced Research Projects
195ddb4360Smrg.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
205ddb4360Smrg.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
215ddb4360Smrg.\"
22*54844dd5Spettai.Dd August 16, 2009
235ddb4360Smrg.Dt ZMORE 1
245ddb4360Smrg.Os
255ddb4360Smrg.Sh NAME
26*54844dd5Spettai.Nm zmore ,
27*54844dd5Spettai.Nm zless
28*54844dd5Spettai.Nd view compressed files
295ddb4360Smrg.Sh SYNOPSIS
305ddb4360Smrg.Nm zmore
315ddb4360Smrg.Op Ar flags
32*54844dd5Spettai.Op Ar
33*54844dd5Spettai.Nm zless
34*54844dd5Spettai.Op Ar flags
35*54844dd5Spettai.Op Ar
365ddb4360Smrg.Sh DESCRIPTION
375ddb4360Smrg.Nm
385ddb4360Smrgis a filter that allows the viewing of files compressed with Lempel-Ziv
395ddb4360Smrgencoding.
405ddb4360SmrgSuch files generally have a
415ddb4360Smrg.Dq Z
425ddb4360Smrgor
435ddb4360Smrg.Dq gz
445ddb4360Smrgextension (both the
455ddb4360Smrg.Xr compress 1
465ddb4360Smrgand
475ddb4360Smrg.Xr gzip 1
485ddb4360Smrgformats are supported).
495ddb4360SmrgAny
505ddb4360Smrg.Ar flags
515ddb4360Smrgthat are specified are passed to the user's preferred
525ddb4360Smrg.Ev PAGER
535ddb4360Smrg(which is
545ddb4360Smrg.Pa /usr/bin/more
555ddb4360Smrgby default).
565ddb4360Smrg.Pp
57*54844dd5Spettai.Nm zless
58*54844dd5Spettaiis equivalent to
59*54844dd5Spettai.Nm zmore
60*54844dd5Spettaibut uses
61*54844dd5Spettai.Xr less 1
62*54844dd5Spettaias a pager instead of
63*54844dd5Spettai.Xr more 1 .
64*54844dd5Spettai.Pp
655ddb4360SmrgWhen multiple files are specified,
665ddb4360Smrg.Nm
675ddb4360Smrgwill pause at the end of each file and present the following prompt to the user:
685ddb4360Smrg.Bd -literal -offset indent
695ddb4360Smrgprev_file (END) - Next: next_file
705ddb4360Smrg.Ed
715ddb4360Smrg.Pp
725ddb4360SmrgWhere
735ddb4360Smrg.Sy prev_file
745ddb4360Smrgis the file that was just displayed and
755ddb4360Smrg.Sy next_file
765ddb4360Smrgis the next file to be displayed.
775ddb4360SmrgThe following keys are recognized at the prompt:
785ddb4360Smrg.Bl -tag -width "e or q" -offset indent
795ddb4360Smrg.It Ic e No or Ic q
805ddb4360Smrgquit
815ddb4360Smrg.Nm zmore .
825ddb4360Smrg.It Ic s
835ddb4360Smrgskip the next file (or exit if the next file is the last).
845ddb4360Smrg.El
855ddb4360Smrg.Pp
865ddb4360SmrgIf no files are specified,
875ddb4360Smrg.Nm
885ddb4360Smrgwill read from the standard input.
895ddb4360SmrgIn this mode
905ddb4360Smrg.Nm
915ddb4360Smrgwill assume
925ddb4360Smrg.Xr gzip 1
935ddb4360Smrgstyle compression since there is no suffix on which to make a decision.
945ddb4360Smrg.Sh ENVIRONMENT
955ddb4360Smrg.Bl -tag -width "PAGER"
965ddb4360Smrg.It Ev PAGER
975ddb4360SmrgProgram used to display files.
985ddb4360SmrgIf unset,
995ddb4360Smrg.Pa /usr/bin/more
100*54844dd5Spettaiis used
101*54844dd5Spettai.Pq Nm zmore
102*54844dd5Spettaior
103*54844dd5Spettai.Pa /usr/bin/less
104*54844dd5Spettai.Pq Nm zless .
1055ddb4360Smrg.El
1065ddb4360Smrg.Sh SEE ALSO
1075ddb4360Smrg.Xr compress 1 ,
1085ddb4360Smrg.Xr less 1 ,
1095ddb4360Smrg.Xr more 1
110