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.

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