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