mirror of the now-defunct rocklinux.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

358 lines
7.2 KiB

  1. # --- ROCK-COPYRIGHT-NOTE-BEGIN ---
  2. #
  3. # This copyright note is auto-generated by ./scripts/Create-CopyPatch.
  4. # Please add additional copyright information _after_ the line containing
  5. # the ROCK-COPYRIGHT-NOTE-END tag. Otherwise it might get removed by
  6. # the ./scripts/Create-CopyPatch script. Do not edit this copyright text!
  7. #
  8. # ROCK Linux: rock-src/package/base/tar/tar-1.13.18-manpage.patch
  9. # ROCK Linux is Copyright (C) 1998 - 2005 Clifford Wolf
  10. #
  11. # This patch file is dual-licensed. It is available under the license the
  12. # patched project is licensed under, as long as it is an OpenSource license
  13. # as defined at http://www.opensource.org/ (e.g. BSD, X11) or under the terms
  14. # of the GNU General Public License as published by the Free Software
  15. # Foundation; either version 2 of the License, or (at your option) any later
  16. # version.
  17. #
  18. # --- ROCK-COPYRIGHT-NOTE-END ---
  19. --- ./tar.1.manpage Mon Oct 30 12:52:03 2000
  20. +++ ./tar.1 Mon Oct 30 12:56:15 2000
  21. @@ -0,0 +1,336 @@
  22. +.\" @(#)tar.1 1.13.14 2000/10/30 Bero;
  23. +.TH TAR 1 "30 October 2000"
  24. +.SH NAME
  25. +tar \- The GNU version of the tar archiving utility
  26. +.SH SYNOPSIS
  27. +.B tar
  28. +[
  29. +.B \-
  30. +]
  31. +.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
  32. +[
  33. +.B --atime-preserve
  34. +]
  35. +[
  36. +.B -b, --block-size N
  37. +]
  38. +[
  39. +.B -B, --read-full-blocks
  40. +]
  41. +[
  42. +.B -C, --directory DIR
  43. +]
  44. +[
  45. +.B --checkpoint
  46. +]
  47. +[
  48. +.B -f, --file [HOSTNAME:]F
  49. +]
  50. +[
  51. +.B --force-local
  52. +]
  53. +[
  54. +.B -F, --info-script F --new-volume-script F
  55. +]
  56. +[
  57. +.B -G, --incremental
  58. +]
  59. +[
  60. +.B -g, --listed-incremental F
  61. +]
  62. +[
  63. +.B -h, --dereference
  64. +]
  65. +[
  66. +.B -i, --ignore-zeros
  67. +]
  68. +[
  69. +.B -j, -I, --bzip
  70. +]
  71. +[
  72. +.B --ignore-failed-read
  73. +]
  74. +[
  75. +.B -k, --keep-old-files
  76. +]
  77. +[
  78. +.B -K, --starting-file F
  79. +]
  80. +[
  81. +.B -l, --one-file-system
  82. +]
  83. +[
  84. +.B -L, --tape-length N
  85. +]
  86. +[
  87. +.B -m, --modification-time
  88. +]
  89. +[
  90. +.B -M, --multi-volume
  91. +]
  92. +[
  93. +.B -N, --after-date DATE, --newer DATE
  94. +]
  95. +[
  96. +.B -o, --old-archive, --portability
  97. +]
  98. +[
  99. +.B -O, --to-stdout
  100. +]
  101. +[
  102. +.B -p, --same-permissions, --preserve-permissions
  103. +]
  104. +[
  105. +.B -P, --absolute-paths
  106. +]
  107. +[
  108. +.B --preserve
  109. +]
  110. +[
  111. +.B -R, --record-number
  112. +]
  113. +[
  114. +.B --remove-files
  115. +]
  116. +[
  117. +.B -s, --same-order, --preserve-order
  118. +]
  119. +[
  120. +.B --same-owner
  121. +]
  122. +[
  123. +.B -S, --sparse
  124. +]
  125. +[
  126. +.B -T, --files-from=F
  127. +]
  128. +[
  129. +.B --null
  130. +]
  131. +[
  132. +.B --totals
  133. +]
  134. +[
  135. +.B -v, --verbose
  136. +]
  137. +[
  138. +.B -V, --label NAME
  139. +]
  140. +[
  141. +.B --version
  142. +]
  143. +[
  144. +.B -w, --interactive, --confirmation
  145. +]
  146. +[
  147. +.B -W, --verify
  148. +]
  149. +[
  150. +.B --exclude FILE
  151. +]
  152. +[
  153. +.B -X, --exclude-from FILE
  154. +]
  155. +[
  156. +.B -Z, --compress, --uncompress
  157. +]
  158. +[
  159. +.B -z, --gzip, --ungzip
  160. +]
  161. +[
  162. +.B --use-compress-program PROG
  163. +]
  164. +[
  165. +.B --block-compress
  166. +]
  167. +[
  168. +.B -[0-7][lmh]
  169. +]
  170. +.TP
  171. +.I filename1 [ filename2, ... filenameN ]
  172. +.TP
  173. +.I directory1 [ directory2, ...directoryN ]
  174. +.SH DESCRIPTION
  175. +.LP
  176. +This manual page documents the GNU version of
  177. +.B tar
  178. +, an archiving program designed to store and extract files from
  179. +an archive file known as a
  180. +.IR tarfile.
  181. +A
  182. +.IR tarfile
  183. +may be made on a tape drive, however, it is also common
  184. +to write a
  185. +.IR tarfile
  186. +to a normal file.
  187. +The first argument to
  188. +.B tar
  189. +must be one of the options:
  190. +.BR Acdrtux ,
  191. +followed by any optional functions.
  192. +The final arguments to
  193. +.B tar
  194. +are the names of the files or directories which should be archived. The use
  195. +of a directory name always implies that the subdirectories below should be
  196. +included in the archive.
  197. +.SH "FUNCTION LETTERS"
  198. +.TP
  199. +.B One of the following options must be used:
  200. +.TP
  201. +.B -A, --catenate, --concatenate
  202. +append tar files to an archive
  203. +.TP
  204. +.B -c, --create
  205. +create a new archive
  206. +.TP
  207. +.B -d, --diff, --compare
  208. +find differences between archive and file system
  209. +.TP
  210. +.B --delete
  211. +delete from the archive (not for use on mag tapes!)
  212. +.TP
  213. +.B -r, --append
  214. +append files to the end of an archive
  215. +.TP
  216. +.B -t, --list
  217. +list the contents of an archive
  218. +.TP
  219. +.B -u, --update
  220. +only append files that are newer than copy in archive
  221. +.TP
  222. +.B -x, --extract, --get
  223. +extract files from an archive
  224. +.SH "OTHER OPTIONS"
  225. +.TP
  226. +.B --atime-preserve
  227. +don't change access times on dumped files
  228. +.TP
  229. +.B -b, --block-size N
  230. +block size of Nx512 bytes (default N=20)
  231. +.TP
  232. +.B -B, --read-full-blocks
  233. +reblock as we read (for reading 4.2BSD pipes)
  234. +.TP
  235. +.B -C, --directory DIR
  236. +change to directory DIR
  237. +.TP
  238. +.B --checkpoint
  239. +print directory names while reading the archive
  240. +.TP
  241. +.B -f, --file [HOSTNAME:]F
  242. +use archive file or device F (default /dev/rmt0)
  243. +.TP
  244. +.B --force-local
  245. +archive file is local even if has a colon
  246. +.TP
  247. +.B -F, --info-script F --new-volume-script F
  248. +run script at end of each tape (implies -M)
  249. +.TP
  250. +.B -G, --incremental
  251. +create/list/extract old GNU-format incremental backup
  252. +.TP
  253. +.B -g, --listed-incremental F
  254. +create/list/extract new GNU-format incremental backup
  255. +.TP
  256. +.B -h, --dereference
  257. +don't dump symlinks; dump the files they point to
  258. +.TP
  259. +.B -i, --ignore-zeros
  260. +ignore blocks of zeros in archive (normally mean EOF)
  261. +.TP
  262. +.B -j, -I, --bzip
  263. +filter the archive through bzip2. Note: -I is deprecated and may get a
  264. +different meaning in the near future.
  265. +.TP
  266. +.B --ignore-failed-read
  267. +don't exit with non-zero status on unreadable files
  268. +.TP
  269. +.B -k, --keep-old-files
  270. +keep existing files; don't overwrite them from archive
  271. +.TP
  272. +.B -K, --starting-file F
  273. +begin at file F in the archive
  274. +.TP
  275. +.B -l, --one-file-system
  276. +stay in local file system when creating an archive
  277. +.TP
  278. +.B -L, --tape-length N
  279. +change tapes after writing N*1024 bytes
  280. +.TP
  281. +.B -m, --modification-time
  282. +don't extract file modified time
  283. +.TP
  284. +.B -M, --multi-volume
  285. +create/list/extract multi-volume archive
  286. +.TP
  287. +.B -N, --after-date DATE, --newer DATE
  288. +only store files newer than DATE
  289. +.TP
  290. +.B -o, --old-archive, --portability
  291. +write a V7 format archive, rather than ANSI format
  292. +.TP
  293. +.B -O, --to-stdout
  294. +extract files to standard output
  295. +.TP
  296. +.B -p, --same-permissions, --preserve-permissions
  297. +extract all protection information
  298. +.TP
  299. +.B -P, --absolute-paths
  300. +don't strip leading `/'s from file names
  301. +.TP
  302. +.B --preserve
  303. +like -p -s
  304. +.TP
  305. +.B -R, --record-number
  306. +show record number within archive with each message
  307. +.TP
  308. +.B --remove-files
  309. +remove files after adding them to the archive
  310. +.TP
  311. +.B -s, --same-order, --preserve-order
  312. +list of names to extract is sorted to match archive
  313. +.TP
  314. +.B --same-owner
  315. +create extracted files with the same ownership
  316. +.TP
  317. +.B -S, --sparse
  318. +handle sparse files efficiently
  319. +.TP
  320. +.B -T, --files-from=F
  321. +get names to extract or create from file F
  322. +.TP
  323. +.B --null
  324. +-T reads null-terminated names, disable -C
  325. +.TP
  326. +.B --totals
  327. +print total bytes written with --create
  328. +.TP
  329. +.B -v, --verbose
  330. +verbosely list files processed
  331. +.TP
  332. +.B -V, --label NAME
  333. +create archive with volume name NAME
  334. +.TP
  335. +.B --version
  336. +print tar program version number
  337. +.TP
  338. +.B -w, --interactive, --confirmation
  339. +ask for confirmation for every action
  340. +.TP
  341. +.B -W, --verify
  342. +attempt to verify the archive after writing it
  343. +.TP
  344. +.B --exclude FILE
  345. +exclude file FILE
  346. +.TP
  347. +.B -X, --exclude-from FILE
  348. +exclude files listed in FILE
  349. +.TP
  350. +.B -Z, --compress, --uncompress
  351. +filter the archive through compress
  352. +.TP
  353. +.B -z, --gzip, --ungzip
  354. +filter the archive through gzip
  355. +.TP
  356. +.B --use-compress-program PROG
  357. +filter the archive through PROG (which must accept -d)