OpenSDE Packages Database (without history before r20070)
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.

356 lines
7.1 KiB

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