home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / MSDOS / WATTCP / PISA_TAR.TAR / tar / readme < prev    next >
Encoding:
Text File  |  1992-06-30  |  4.8 KB  |  125 lines

  1.     --- README File for Remote TAR ---
  2.  
  3. This program has been put together by:
  4.  
  5.     Luigi Rizzo
  6.     Dip. di Ingegneria dell'Informazione, Univ. di Pisa
  7.     via Diotisalvi 2, 56126 PISA (ITALY)
  8.     email: luigi@iet.unipi.it
  9.     tel: +39-50-568533    fax: +39-50-568511
  10.  
  11.  
  12. This is a modified version of GNU TAR, running on MSDOS and able to
  13. access the Unix file system via "rsh". The network support is a
  14. modified version of WATTCP libraries (originally created by Erick
  15. Engelke, Univ. of Waterloo, CA, ee@development.uwaterloo.ca) which
  16. compiles under MS-C 6.00 and MASM 5.0.
  17.  
  18. I have included the full sources for TAR, plus my version of the WATTCP
  19. library. The modified WATTCP sources will be available shortly (mainly
  20. because of the lack of documentation!).
  21.  
  22. You can use this program as a normal tar, with standard options. If you
  23. want to read/write to a Unix file (or device), you can specify the
  24. target file (the one after the -f option) as follows:
  25.  
  26.     host:user:password:target_file
  27.     
  28. (the password can be omitted, in which case it will be requested at run
  29. time; an empty password must be specified as a minus sign, '-').
  30.  
  31. The remote host is accessed via rexec to execute
  32.  
  33.     "cat - >target_file"    (when writing)
  34.  
  35. or
  36.  
  37.     "cat target_file"    (when reading)
  38.     
  39. so that tar can access the actual archive. The "-z" option will execute
  40. compress or zcat on the remote system, so that you end up with a
  41. compressed archive. As an additional option, you can specify the 
  42. "-r" flag on the command line so that the target_file is interpreted as
  43. the command to be executed on the remote system. Thus, the following are
  44. equivalent:
  45.  
  46.     tar zcvf host:user:password:file.tar    .
  47.  
  48.     tar rcvf "host:user:password: compress - > file.tar.Z" .
  49.  
  50.  
  51. The tar executing on the DOS machine will read from / write to the
  52. output/input of the command running on Unix.
  53.  
  54. The whole thing might still have bugs, and it has not been thoroughly
  55. tested (take it as an 'alpha' version). If you find a bug or a fix,
  56. please send me a note.
  57.  
  58. DISCLAIMER about possible bugs
  59. ==============================
  60.  
  61. I wrote this program by merging an old version of GNU TAR, some
  62. routines to do directory searches (msd_dir), Erick Engelke's version of
  63. rsh and my version of WATTCP libraries. Thus I have not a complete
  64. knowledge of all of the sources.  Nevertheless, I've done some backups
  65. and the program appears to work reasonably well.  Among possible
  66. problems are the following:
  67.  
  68. - Compilation has only been tried in SMALL model. I suspect the msd_dir
  69.   routines have problems in large model.
  70.  
  71. - I'm not quite sure on how wildcard in filenames are handled (but
  72.   useful things like "tar tvf file.tar ." do work).
  73.  
  74. - There might be problems with stack overflows with deep directory trees.
  75. ================================
  76.  
  77.  
  78. (Here follows the original README coming with the GNU TAR I used)
  79. ===========================================================
  80.  
  81. This is a public domain tar(1) replacement.  It implements the 'c',
  82. 'x', and 't' commands of Unix tar, and many of the options.  It creates
  83. P1003 "Unix Standard" [draft 6] tapes by default, and can read and
  84. write both old and new formats.  It can decompress tar archives when
  85. reading them from disk files (using the 'z' option), but cannot do so
  86. when writing, or when reading from a tape drive.  Its verbose output
  87. looks more like "ls -l" than the Unix tar, and even lines up the
  88. columns.  It is a little better at reading damaged tapes than Unix tar.
  89.  
  90. It is designed to be a lot more efficient than the standard Unix tar;
  91. it does as little bcopy-ing as possible, and does file I/O in large
  92. blocks.  On the other hand, it has not been timed or performance-tuned;
  93. it's just *designed* to be faster.
  94.  
  95. On the Sun, the tar archives it creates under the 'old' option are
  96. byte-for-byte the same as those created by /bin/tar, except the trash
  97. at the end of each file and at the end of the archive.
  98.  
  99. It was written and initially debugged on a Sun Workstation running
  100. 4.2BSD.  It has been run on Xenix, Unisoft, Vax 4.2BSD, V7, and USG
  101. systems.  I'm interested in finding people who will port it to other
  102. types of (Unix and non-Unix) systems, use it, and send back the
  103. changes; and people who will add the obscure tar options that they
  104. happen to use and I don't.  In particular, VMS, MSDOS, Mac, Atari and
  105. Amiga versions would be handy.
  106.  
  107. It still has a number of loose ends, marked by "FIXME" comments in the
  108. source.  For example, it does not chown() extracted files.  Fixes to
  109. these things are also welcome.
  110.  
  111. I am the author of all the code in this program.  I hereby place it in
  112. the public domain.  If you modify it, or port it to another system,
  113. please send me back a copy, so I can keep a master source.
  114.  
  115.     John Gilmore
  116.     Nebula Consultants
  117.     1504 Golden Gate Ave.
  118.     San Francisco, California, USA  94115
  119.     +1 415 931 4667        voice
  120.     hoptoad!gnu        data
  121.     jgilmore@lll-crg.arpa    data
  122. Hoptoad talks to sun, ptsfa, well, lll-crg, ihnp4, cbosgd, ucsfcgl, pyramid.
  123.  
  124. @(#)README 1.5    86/10/29
  125.