home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / SLAKWARE / A8 / TAR.TGZ / TAR.tar / usr / info / tar.info-1.gz / tar.info-1 (.txt)
GNU Info File  |  1995-06-17  |  49KB  |  993 lines
  1. This is Info file tar.info, produced by Makeinfo-1.61 from the input
  2. file tar.texinfo.
  3. START-INFO-DIR-ENTRY
  4. * tar: (tar).            Making tape (or disk) archives.
  5. END-INFO-DIR-ENTRY
  6.    This file documents GNU `tar', a utility used to store, backup, and
  7. transport files.
  8.    Copyright (C) 1992, 1994, 1995 Free Software Foundation, Inc.
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided that
  14. the entire resulting derived work is distributed under the terms of a
  15. permission notice identical to this one.
  16.    Permission is granted to copy and distribute translations of this
  17. manual into another language, under the above conditions for modified
  18. versions, except that this permission notice may be stated in a
  19. translation approved by the Foundation.
  20. File: tar.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
  21. GNU tar
  22. *******
  23.    This file documents `tar', a utility used to store, backup, and
  24. transport files.  It is a rudimentary documentation for the GNU tape
  25. (or disk) archiver.  It covers the release 1.11.8.
  26.    This document has been quickly assembled from random notes and
  27. sources.  I will of course accept documentation bug reports, but please
  28. do not torture yourself into systematically reporting all inadequacies
  29. for unrevised nodes.
  30. * Menu:
  31. * Introduction::
  32. * Tutorial::
  33. * Invoking tar::
  34. * Basic tar Operations::
  35. * Specifying Names to tar::
  36. * Being Careful::
  37. * Format Control::
  38. * Media::
  39. * Backups and Restoration::
  40. * Date input formats::
  41. * Archive Format::
  42. * Index::
  43.  -- The Detailed Node Listing --
  44. Introduction
  45. * What tar Does::
  46. * Authors::
  47. * Bug reports::
  48. * Support::
  49. Support considerations
  50. * Stability::
  51. * Rewriting::
  52. * Why maintaining::
  53. * MSDOS::
  54. Tutorial Introduction to `tar'
  55. * How to Create Archives::
  56. * How to List Archives::
  57. * How to Extract Members from an Archive::
  58. * How to Add Files to Existing Archives::
  59. * How to Delete Members from Archives::
  60. How to Create Archives
  61. * Creating Archives of Files bis::
  62. * Using tar in Verbose Mode bis::
  63. * How to Archive Directories::
  64. * Creating an Archive of a Subdirectory bis::
  65. * Compare bis::
  66. * Using Compare from the Superior Directory bis::
  67. How to Archive Directories
  68. * Creating an Archive of a Subdirectory bis::
  69. How to List Archives
  70. * Listing files in an archive bis::
  71. * Getting Additional File Information bis::
  72. * List A Specific File in an Archive bis::
  73. * Listing the Contents of a Stored Directory ter::
  74. How to Extract Members from an Archive
  75. * Extracting Files bis::
  76. * Extracting Files from an Archive ter::
  77. * Extracting Specific Files ter::
  78. * Extracting Directories ter::
  79. How to Add Files to Existing Archives
  80. * Append bis::
  81. * Update bis::
  82. * Concatenate bis::
  83. Invoking GNU `tar'
  84. * Synopsis::
  85. * Option Styles::
  86. * Options::
  87. Many Styles for Options
  88. * Mnemonic Options::
  89. * Short Options::
  90. * Old Options::
  91. * Mixing Styles::
  92. All Available Options
  93. * Device Options::
  94. * Blocking Options::
  95. * Classification Options::
  96. Basic `tar' Operations
  97. * Creating a New Archive::
  98. * Adding to an Existing Archive::
  99. * Updating an Archive::
  100. * Combining Archives::
  101. * Removing Archive Members::
  102. * Listing Archive Members::
  103. * Extracting Archive Members::
  104. * Comparing Archives Members with Files::
  105. * Matching Format Parameters::
  106. Extracting Archive Members
  107. * Archive Reading Options::
  108. * File Writing Options::
  109. * Scarce Disk Space::
  110. Specifying Names to `tar'
  111. * Changing the Archive Name::
  112. * Characteristics::
  113. * Selection Options::
  114. Selecting Files by Characteristic
  115. * Reading Names from a File::
  116. * Excluding Some Files::
  117. * Operating Only on New Files::
  118. * Crossing Filesystem Boundaries::
  119. Local file selection
  120. * Changing Directory::
  121. * Absolute File Names::
  122. Being Even More Careful
  123. * Documentation::
  124. * Checking Progress::
  125. * Interactive Operation::
  126. * Write Verification::
  127. * Comparing::
  128. * Portability::
  129. * Write Protection::
  130. Making `tar' Archives More Portable
  131. * Portable Names::
  132. * Symbolic Links::
  133. * Old V7 and POSIX::
  134. * Checksumming Problems::
  135. Controlling the Archive Format
  136. * Attributes Options::
  137. * Type Options::
  138. * Compression::
  139. * Special Options for Archiving::
  140. * Archive Structure::
  141. * Modifiers Options::
  142. Using Less Space through Compression
  143. * Compressed Archives::
  144. * Dealing with Compressed Archives::
  145. * Sparse Files::
  146. Tapes and Other Archive Media
  147. * Device::
  148. * Blocking::
  149. * Many::
  150. * Using Multiple Tapes::
  151. * Archive Label::
  152. Blocking
  153. * Format Variations::
  154. * Blocking Factor::
  155. Many archives on one tape
  156. * Tape Positioning::
  157. * mt::
  158. Using Multiple Tapes
  159. * Multi-Volume Archives::
  160. * Tape Files::
  161. Performing Backups and Restoring Files
  162. * Full Dumps::
  163. * Inc Dumps::
  164. * incremental and listed-incremental::
  165. * Backup Levels::
  166. * Backup Parameters::
  167. * Scripted Backups::
  168. * Scripted Restoration::
  169. Setting Parameters for Backups and Restoration
  170. * backup-specs example::
  171. * Script Syntax::
  172. Date input formats
  173. * General date syntax::
  174. * Calendar date item::
  175. * Time of day item::
  176. * Timezone item::
  177. * Day of week item::
  178. * Relative item in date strings::
  179. * Pure numbers in date strings::
  180. * Authors of getdate::
  181. Format of `tar' archives
  182. * Standard::
  183. * Extensions::
  184. * cpio::
  185. File: tar.info,  Node: Introduction,  Next: Tutorial,  Prev: Top,  Up: Top
  186. Introduction
  187. ************
  188.    This chapter introduces of a few words which will recur all over
  189. this manual, like "archive", "member", "name", "unpack", etc.  It then
  190. explains who wrote GNU `tar' and its documentation, and says where to
  191. send bug reports or comments.
  192. * Menu:
  193. * What tar Does::
  194. * Authors::
  195. * Bug reports::
  196. * Support::
  197. File: tar.info,  Node: What tar Does,  Next: Authors,  Prev: Introduction,  Up: Introduction
  198. What `tar' Does
  199. ===============
  200.    The `tar' program is used to create and manipulate `tar' archives.
  201. An "archive" is a single file which contains within it the contents of
  202. many files.  In addition, the archive identifies the names of the
  203. files, their owner, and so forth.  (Archives record access permissions,
  204. user and group, size in bytes, and last modification time.  Some
  205. archives also record the file names in each archived directory, as well
  206. as other file and directory information.)
  207.    The files inside an archive are called "members".  Within this
  208. manual, we use the term "file" to refer only to files accessible in the
  209. normal ways (by `ls', `cat', and so forth), and the term "members" to
  210. refer only to the members of an archive.  Similarly, a "file name" is
  211. the name of a file, as it resides in the filesystem, and a "member
  212. name" is the name of an archive member within the archive.
  213.    Initially, `tar' archives were used to store files conveniently on
  214. magnetic tape.  The name `tar' comes from this use; it stands for:
  215. `t'ape `ar'chiver.  Despite the utility's name, `tar' can direct its
  216. output to any available device, as well as store it in a file or direct
  217. it to another program via a pipe.  `tar' may even access, as archives,
  218. remote devices or files.
  219.    You can use `tar' archives in many ways.  We want to stress a few of
  220. them: storage, backup or transportation.
  221. Storage
  222.      Often, `tar' archives are used to store related files for
  223.      convenient file transfer over a network.  For example, the GNU
  224.      Project distributes its software bundled into `tar' archives, so
  225.      that all the files relating to a particular program (or set of
  226.      related programs) can be transferred as a single unit.
  227.      A magnetic tape can store several files in sequence, but has no
  228.      names for them, just relative position on the tape.  A `tar'
  229.      archive or something like it is one way to store several files on
  230.      one tape and retain their names.  Even when the basic transfer
  231.      mechanism can keep track of names, as FTP can, the nuisance of
  232.      handling multiple files, directories, and multiple links, makes
  233.      `tar' archives an attractive method.
  234.      Archive files are also used for long-term storage, which you can
  235.      think of as transportation from one time to another.
  236. Backup
  237.      Because the archive created by `tar' is capable of preserving file
  238.      information and directory structure, `tar' is commonly used for
  239.