xref: /freebsd/usr.bin/gzip/zmore.1 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1*060ea80eSXin LI.\"	$NetBSD: zmore.1,v 1.4 2013/11/12 21:58:37 pettai Exp $
2*060ea80eSXin LI.\"	$OpenBSD: zmore.1,v 1.10 2009/08/16 09:41:08 sobrado Exp $
39a9ea25fSXin LI.\"
49a9ea25fSXin LI.\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
59a9ea25fSXin LI.\"
69a9ea25fSXin LI.\" Permission to use, copy, modify, and distribute this software for any
79a9ea25fSXin LI.\" purpose with or without fee is hereby granted, provided that the above
89a9ea25fSXin LI.\" copyright notice and this permission notice appear in all copies.
99a9ea25fSXin LI.\"
109a9ea25fSXin LI.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
119a9ea25fSXin LI.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
129a9ea25fSXin LI.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
139a9ea25fSXin LI.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
149a9ea25fSXin LI.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
159a9ea25fSXin LI.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
169a9ea25fSXin LI.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
179a9ea25fSXin LI.\"
189a9ea25fSXin LI.\" Sponsored in part by the Defense Advanced Research Projects
199a9ea25fSXin LI.\" Agency (DARPA) and Air Force Research Laboratory, Air Force
209a9ea25fSXin LI.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
21*060ea80eSXin LI.Dd October 22, 2014
229a9ea25fSXin LI.Dt ZMORE 1
239a9ea25fSXin LI.Os
249a9ea25fSXin LI.Sh NAME
25*060ea80eSXin LI.Nm zmore ,
26*060ea80eSXin LI.Nm zless
27252b39bfSGlen Barber.Nd view compressed files
289a9ea25fSXin LI.Sh SYNOPSIS
299a9ea25fSXin LI.Nm zmore
309a9ea25fSXin LI.Op Ar flags
31*060ea80eSXin LI.Op Ar
32*060ea80eSXin LI.Nm zless
33*060ea80eSXin LI.Op Ar flags
34*060ea80eSXin LI.Op Ar
359a9ea25fSXin LI.Sh DESCRIPTION
369a9ea25fSXin LI.Nm
379a9ea25fSXin LIis a filter that allows the viewing of files compressed with Lempel-Ziv
389a9ea25fSXin LIencoding.
399a9ea25fSXin LISuch files generally have a
409a9ea25fSXin LI.Dq Z
419a9ea25fSXin LIor
429a9ea25fSXin LI.Dq gz
439a9ea25fSXin LIextension (both the
449a9ea25fSXin LI.Xr compress 1
459a9ea25fSXin LIand
469a9ea25fSXin LI.Xr gzip 1
479a9ea25fSXin LIformats are supported).
489a9ea25fSXin LIAny
499a9ea25fSXin LI.Ar flags
509a9ea25fSXin LIthat are specified are passed to the user's preferred
519a9ea25fSXin LI.Ev PAGER
529a9ea25fSXin LI(which is
539a9ea25fSXin LI.Pa /usr/bin/more
549a9ea25fSXin LIby default).
559a9ea25fSXin LI.Pp
56*060ea80eSXin LI.Nm zless
57*060ea80eSXin LIis equivalent to
58*060ea80eSXin LI.Nm zmore
59*060ea80eSXin LIbut uses
60*060ea80eSXin LI.Xr less 1
61*060ea80eSXin LIas a pager instead of
62*060ea80eSXin LI.Xr more 1 .
63*060ea80eSXin LI.Pp
649a9ea25fSXin LIWhen multiple files are specified,
659a9ea25fSXin LI.Nm
669a9ea25fSXin LIwill pause at the end of each file and present the following prompt to the user:
679a9ea25fSXin LI.Bd -literal -offset indent
689a9ea25fSXin LIprev_file (END) - Next: next_file
699a9ea25fSXin LI.Ed
709a9ea25fSXin LI.Pp
719a9ea25fSXin LIWhere
729a9ea25fSXin LI.Sy prev_file
739a9ea25fSXin LIis the file that was just displayed and
749a9ea25fSXin LI.Sy next_file
759a9ea25fSXin LIis the next file to be displayed.
769a9ea25fSXin LIThe following keys are recognized at the prompt:
779a9ea25fSXin LI.Bl -tag -width "e or q" -offset indent
789a9ea25fSXin LI.It Ic e No or Ic q
799a9ea25fSXin LIquit
809a9ea25fSXin LI.Nm zmore .
819a9ea25fSXin LI.It Ic s
829a9ea25fSXin LIskip the next file (or exit if the next file is the last).
839a9ea25fSXin LI.El
849a9ea25fSXin LI.Pp
859a9ea25fSXin LIIf no files are specified,
869a9ea25fSXin LI.Nm
879a9ea25fSXin LIwill read from the standard input.
889a9ea25fSXin LIIn this mode
899a9ea25fSXin LI.Nm
909a9ea25fSXin LIwill assume
919a9ea25fSXin LI.Xr gzip 1
929a9ea25fSXin LIstyle compression since there is no suffix on which to make a decision.
939a9ea25fSXin LI.Sh ENVIRONMENT
949a9ea25fSXin LI.Bl -tag -width "PAGER"
959a9ea25fSXin LI.It Ev PAGER
969a9ea25fSXin LIProgram used to display files.
979a9ea25fSXin LIIf unset,
989a9ea25fSXin LI.Pa /usr/bin/more
99*060ea80eSXin LIis used
100*060ea80eSXin LI.Pq Nm zmore
101*060ea80eSXin LIor
102*060ea80eSXin LI.Pa /usr/bin/less
103*060ea80eSXin LI.Pq Nm zless .
1049a9ea25fSXin LI.El
1059a9ea25fSXin LI.Sh SEE ALSO
1069a9ea25fSXin LI.Xr compress 1 ,
1079a9ea25fSXin LI.Xr less 1 ,
1089a9ea25fSXin LI.Xr more 1
109