home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / tapeutils.zip / tuvwtahlp.txt < prev   
Text File  |  1988-08-16  |  3KB  |  86 lines

  1. .help wtar Dec85 softools
  2. .ih
  3. NAME
  4. wtar -- write TAR format archive file
  5. .ih
  6. USAGE
  7. wtar [-flags] [-f archive] [files]
  8. .ih
  9. ARGUMENTS
  10. .ls 12 -d
  11. Print debug messages.
  12. .le
  13. .ls 12 -o
  14. Omit binary files.
  15. .le
  16. .ls 12 -t
  17. Print the name of each file as it is written or omitted.
  18. .le
  19. .ls 12 -v
  20. Verbose mode; print more information about each file.
  21. .le
  22. .ls 12 -f archive
  23. The tar format file to be written, i.e., "stdout", a magtape specification
  24. (e.g., "mta"), or the IRAF virtual filename of a disk file.  The default
  25. is the standard output.
  26. .le
  27. .ls 12 files
  28. The names of the files or root directories of directory trees to be written
  29. to the archive file.  If no files are specified "." (the directory tree rooted
  30. at the current directory) is assumed.
  31. .le
  32. .ih
  33. DESCRIPTION
  34. The named files and directories are written to the indicated UNIX "tar" format
  35. output file.  Any directories in the file list are recursively descended.
  36. The named directories should be subdirectories of the current directory when
  37. \fIwtar\fR is called.  Binary files may be omitted if desired, e.g., when
  38. transporting software to a different host, or when making a backup of a large
  39. system which would otherwise exceed the capacity of a single reel of tape.
  40. All file, directory, and magtape names conform to the IRAF standard.
  41.  
  42. The output file is normally either a disk file (e.g., if the transport medium
  43. is an electronic network), or a magtape file.  If the output file is a magtape
  44. the tape is rewound before the archive is written, only one file may be written
  45. on a single reel of tape, and the entire file must fit on a single reel of
  46. tape.  The blocking factor is fixed at 10240 bytes per record.  Note that a
  47. disk archive file can be encoded and pushed through a modem to transport
  48. modest size directories to a remote site with minimum delay.
  49.  
  50. The TAR format file written by \fIwtar\fR conforms to the UNIX standard except
  51. that [1] no link information is preserved, [2] the user and group numbers
  52. may not be preserved (they are preserved in the UNIX version of \fIwtar\fR),
  53. and [3] some versions of \fIwtar\fR (e.g., VMS) pad text files at the end
  54. with extra blank lines.
  55.  
  56. All \fIwtar\fR filename arguments are IRAF virtual filenames (or host
  57. filenames).  Magtape devices may be specified by their IRAF logical device
  58. name (if the "dev$devices" file is in place and is up to date), or by the
  59. host device name, prefixed with a "mt.", e.g., "mt.MUA1" or "mt./dev/rmt9".
  60. .ih
  61. EXAMPLES
  62. 1. Make a source-only archive of the IRAF system on drive B at the default
  63. density.
  64.  
  65. .nf
  66.     cl> cd iraf
  67.     cl> wtar -of mtb
  68. .fi
  69.  
  70. 2. Make a disk archive of the LIB and PKG directory trees in your home
  71. directory.
  72.  
  73.     cl> wtar -f home$pkgarc lib pkg 
  74.  
  75. 3. Examine the resultant file to make sure everything worked correctly.
  76.  
  77.     cl> rtar -tvf home$pkgarc
  78.  
  79.  
  80. 4. Make a disk archive, using a host filename for the output file.
  81.  
  82.     cl> wtar -f /tmp2/arc lib pkg sys
  83. .ih
  84. SEE ALSO
  85. rtar, rmbin
  86.