/usr.bin/gzip/zmore.1

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 94 lines · 94 code · 0 blank · 0 comment · 0 complexity · 33e642f01c48f2e3ba24929fbd8dd1a4 MD5 · raw file 

    

  1. .\"	$NetBSD: zmore.1,v 1.3 2003/12/28 12:47:52 wiz Exp $
    2. 

  2. .\"	$OpenBSD: zmore.1,v 1.3 2003/06/23 21:00:48 deraadt Exp $
    3. 

  3. .\"
    4. 

  4. .\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
    5. 

  5. .\"
    6. 

  6. .\" Permission to use, copy, modify, and distribute this software for any
    7. 

  7. .\" purpose with or without fee is hereby granted, provided that the above
    8. 

  8. .\" copyright notice and this permission notice appear in all copies.
    9. 

  9. .\"
    10. 

  10. .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
    11. 

  11. .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
    12. 

  12. .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
    13. 

  13. .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    14. 

  14. .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
    15. 

  15. .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
    16. 

  16. .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
    17. 

  17. .\"
    18. 

  18. .\" Sponsored in part by the Defense Advanced Research Projects
    19. 

  19. .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
    20. 

  20. .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
    21. 

  21. .\"
    22. 

  22. .\" $FreeBSD$
    23. 

  23. .Dd February 6, 2011
    24. 

  24. .Dt ZMORE 1
    25. 

  25. .Os
    26. 

  26. .Sh NAME
    27. 

  27. .Nm zmore
    28. 

  28. .Nd view compressed files
    29. 

  29. .Sh SYNOPSIS
    30. 

  30. .Nm zmore
    31. 

  31. .Op Ar flags
    32. 

  32. .Op Ar file ...
    33. 

  33. .Sh DESCRIPTION
    34. 

  34. .Nm
    35. 

  35. is a filter that allows the viewing of files compressed with Lempel-Ziv
    36. 

  36. encoding.
    37. 

  37. Such files generally have a
    38. 

  38. .Dq Z
    39. 

  39. or
    40. 

  40. .Dq gz
    41. 

  41. extension (both the
    42. 

  42. .Xr compress 1
    43. 

  43. and
    44. 

  44. .Xr gzip 1
    45. 

  45. formats are supported).
    46. 

  46. Any
    47. 

  47. .Ar flags
    48. 

  48. that are specified are passed to the user's preferred
    49. 

  49. .Ev PAGER
    50. 

  50. (which is
    51. 

  51. .Pa /usr/bin/more
    52. 

  52. by default).
    53. 

  53. .Pp
    54. 

  54. When multiple files are specified,
    55. 

  55. .Nm
    56. 

  56. will pause at the end of each file and present the following prompt to the user:
    57. 

  57. .Bd -literal -offset indent
    58. 

  58. prev_file (END) - Next: next_file
    59. 

  59. .Ed
    60. 

  60. .Pp
    61. 

  61. Where
    62. 

  62. .Sy prev_file
    63. 

  63. is the file that was just displayed and
    64. 

  64. .Sy next_file
    65. 

  65. is the next file to be displayed.
    66. 

  66. The following keys are recognized at the prompt:
    67. 

  67. .Bl -tag -width "e or q" -offset indent
    68. 

  68. .It Ic e No or Ic q
    69. 

  69. quit
    70. 

  70. .Nm zmore .
    71. 

  71. .It Ic s
    72. 

  72. skip the next file (or exit if the next file is the last).
    73. 

  73. .El
    74. 

  74. .Pp
    75. 

  75. If no files are specified,
    76. 

  76. .Nm
    77. 

  77. will read from the standard input.
    78. 

  78. In this mode
    79. 

  79. .Nm
    80. 

  80. will assume
    81. 

  81. .Xr gzip 1
    82. 

  82. style compression since there is no suffix on which to make a decision.
    83. 

  83. .Sh ENVIRONMENT
    84. 

  84. .Bl -tag -width "PAGER"
    85. 

  85. .It Ev PAGER
    86. 

  86. Program used to display files.
    87. 

  87. If unset,
    88. 

  88. .Pa /usr/bin/more
    89. 

  89. is used.
    90. 

  90. .El
    91. 

  91. .Sh SEE ALSO
    92. 

  92. .Xr compress 1 ,
    93. 

  93. .Xr less 1 ,
    94. 

  94. .Xr more 1
    95.