/usr.bin/gzip/zdiff.1

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 142 lines · 142 code · 0 blank · 0 comment · 0 complexity · 5d5bcdb7bdd6532e2e7e81c820b1456e MD5 · raw file

  1. .\" $NetBSD: zdiff.1,v 1.5 2010/04/14 19:52:05 wiz Exp $
  2. .\" $OpenBSD: zdiff.1,v 1.2 2003/07/13 17:39:14 millert Exp $
  3. .\"
  4. .\" Copyright (c) 2003 Todd C. Miller <Todd.Miller@courtesan.com>
  5. .\" Copyright (c) 2010 Joerg Sonnenberger <joerg@NetBSD.org>
  6. .\"
  7. .\" Permission to use, copy, modify, and distribute this software for any
  8. .\" purpose with or without fee is hereby granted, provided that the above
  9. .\" copyright notice and this permission notice appear in all copies.
  10. .\"
  11. .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  12. .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  13. .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  14. .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  15. .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  16. .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  17. .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  18. .\"
  19. .\" Sponsored in part by the Defense Advanced Research Projects
  20. .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
  21. .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
  22. .\"
  23. .\" $FreeBSD$
  24. .Dd May 23, 2011
  25. .Dt ZDIFF 1
  26. .Os
  27. .Sh NAME
  28. .Nm zcmp ,
  29. .Nm zdiff
  30. .Nd compare compressed files
  31. .Sh SYNOPSIS
  32. .Nm zcmp
  33. .Op Ar options
  34. .Ar file
  35. .Op Ar file2
  36. .Nm zdiff
  37. .Op Ar options
  38. .Ar file
  39. .Op Ar file2
  40. .Sh DESCRIPTION
  41. .Nm zcmp
  42. and
  43. .Nm zdiff
  44. are filters that invoke
  45. .Xr cmp 1
  46. or
  47. .Xr diff 1
  48. respectively to compare compressed files.
  49. Any
  50. .Ar options
  51. that are specified are passed to
  52. .Xr cmp 1
  53. or
  54. .Xr diff 1 .
  55. .Pp
  56. If only
  57. .Ar file1
  58. is specified, it is compared against a file with the same name, but
  59. with the extension removed.
  60. When both
  61. .Ar file1
  62. or
  63. .Ar file2
  64. are specified, either file may be compressed.
  65. .Pp
  66. Extensions handled by
  67. .Xr gzip 1 :
  68. .Bl -bullet -compact
  69. .It
  70. z, Z,
  71. .It
  72. gz,
  73. .It
  74. taz,
  75. .It
  76. tgz.
  77. .El
  78. .Pp
  79. Extensions handled by
  80. .Xr bzip2 1 :
  81. .Bl -bullet -compact
  82. .It
  83. bz,
  84. .It
  85. bz2,
  86. .It
  87. tbz,
  88. .It
  89. tbz2.
  90. .El
  91. .Pp
  92. Extensions handled by
  93. .Xr xz 1 :
  94. .Bl -bullet -compact
  95. .It
  96. lzma,
  97. .It
  98. xz,
  99. .It
  100. tlz,
  101. .It
  102. txz.
  103. .El
  104. .Sh ENVIRONMENT
  105. .Bl -tag -width "TMPDIR"
  106. .It Ev TMPDIR
  107. Directory in which to place temporary files.
  108. If unset,
  109. .Pa /tmp
  110. is used.
  111. .El
  112. .Sh FILES
  113. .Bl -tag -width "/tmp/zdiff.XXXXXXXXXX" -compact
  114. .It Pa /tmp/zcmp.XXXXXXXXXX
  115. Temporary file for
  116. .Nm zcmp .
  117. .It Pa /tmp/zdiff.XXXXXXXXXX
  118. Temporary file for
  119. .Nm zdiff .
  120. .El
  121. .Sh SEE ALSO
  122. .Xr bzip2 1 ,
  123. .Xr cmp 1 ,
  124. .Xr diff 1 ,
  125. .Xr gzip 1 ,
  126. .Xr xz 1
  127. .Sh CAVEATS
  128. .Nm zcmp
  129. and
  130. .Nm zdiff
  131. rely solely on the file extension to determine what is, or is not,
  132. a compressed file.
  133. Consequently, the following are not supported as arguments:
  134. .Bl -dash
  135. .It
  136. directories
  137. .It
  138. device special files
  139. .It
  140. filenames indicating the standard input
  141. .Pq Dq \-
  142. .El