home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / EFFO / pd2.lzh / TAR / tar.doc < prev    next >
Text File  |  1990-05-12  |  3KB  |  82 lines
  1.  
  2. USAGE
  3.     tar <function> <tarfile> [<file> . . .]
  4.  
  5. DESCRIPTION
  6.     Builds and extracts from Unix tape archive files.  The <function>
  7. parameter consists of a one-letter function specifier with one or more
  8. option characters.  <tarfile> is the file to be used for the archive.
  9. If <tarfile> is specified as -, then Stdin or Stdout will be used, as
  10. appropriate.  <file> is one or more filenames to be used by the extract
  11. or create operations.
  12.  
  13. FUNCTION SPECIFIERS
  14.     t   Output a table of all files in the archive.
  15.  
  16.         Recognized Options:
  17.         v  Verbose mode.  Display file permissions, sizes, 
  18.            and modification dates and times.
  19.  
  20.     x   Extract the named files from the archive.  Wildcard characters
  21.         * and ? may be used in filename specifications.
  22.  
  23.         Recognized Options:
  24.         v  Verbose mode.  Display a message for each file extracted.
  25.         m  Do not restore modification dates.  Instead, use current
  26.            date and time as modification date for each extracted file.
  27.         u  convert LF -> CR (for UNIX text files)
  28.         b  Set copy buffer size (number of tape blocks).
  29.            The number is specified directly after the options.
  30.  
  31.     c   Create a new archive file and include the named files.  A directory
  32.         name means to recursively include all files in that directory.
  33.  
  34.         Recognized Options:
  35.         v  Verbose mode.  Display a message for each file added to the archive.
  36.         u  convert CR -> LF (for UNIX text files)
  37.         b  Set copy buffer size (number of tape blocks).
  38.            The number is specified directly after the options.
  39.         d  copy contents of several floopy disks to one tar archive
  40.  
  41.     All of the functions will also accept an 'f' option, which is ignored
  42.     and included only for compatibility with the Unix 'tar' program.
  43.  
  44. EXAMPLES
  45.  
  46. 1)   tar c - /d0 >/t2
  47.     Archive all of the files on drive /d0, and send the resultant archive
  48.     to stdout, which is redirected to /t2.
  49.  
  50. 2)   tar tv sample.tar
  51.     Will produce a verbose listing of the files in the archive.
  52.  
  53. 3)   tar xmb 100 sample.tar a*.c text
  54.     Will extract 'text' and all files matching the pattern a*.c from
  55.     the archive sample.tar, ignoring the stored modification dates.
  56.     Use a buffer of 100 tape blocks.
  57.  
  58. 4)   tar xvb 50 sample.tar subdir
  59.     Will extract all files from the directory 'subdir'. If 'subdir' doesn't
  60.     exist it will be created. Buffer size is set to 50 blocks.
  61.  
  62. 5)   tar xu /mt0 test.c
  63.     Will extract the file test.c from a tape written on a UNIX machine,
  64.     all LF characters will be converted to CRs.
  65.  
  66. 6)   tar cu /mt0 test.c
  67.     Will write the file test.c to a tape streamer converting all CR to LF for
  68.     usage on a UNIX system.
  69.  
  70. BUGS
  71.     This program is much simpler than the standard Unix tar program, and
  72. lacks much of its functionality.   It cannot add files to a pre-existing
  73. archive.  It cannot extract anything but the last occurence when more than
  74. one copy of a file appears in the archive.  There may be problems
  75. with very long file names.
  76.  
  77. AUTHOR
  78.      Michael Huisjes
  79.      Ported to OS9/6809 by Simmy Turner(simmy@nu.cs.fsu.edu)
  80.      Ported to OS9/68k & improved by Stephan Paschedag 
  81.                                        (paschedag@strati.ethz.ch)
  82.