home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / gnu / gtarbin / readme.st < prev    next >
Encoding:
Text File  |  1993-07-27  |  4.3 KB  |  85 lines
  1. GNU Tar 1.10 Port for the Atari ST with MiNT (and without)
  2. ==========================================================
  3.  
  4. Well, I decided it was time I had a full fledged TAR that could handle 
  5. compressed archives rather than uncompressing and then untaring. So, I got
  6. the latest version of GNU Tar I could, which is v1.10, and started to port it
  7. to the Atari. 
  8.  
  9. I essentially use this program with MiNT, as MiNT provides all the facilities
  10. neccessary for me to use this program successfully. Supporting pipes are
  11. essential for the compress/uncompress function of GNU Tar to work, otherwise
  12. all the other functions should work under standard TOS.
  13.  
  14. Included in the binaries part of the this port is also my own compiled version
  15. of compress v4.0. All other versions of compress that I found opened the
  16. stdin/stdout functions in ASCII mode rather than binary and confused GNU Tar
  17. when using compressed archives. The one included has been tested to great
  18. length and shouldn't cause any problems, just make sure that its in your 
  19. default PATH statement in your environment.
  20.  
  21. There is also an environmental variable within GNU Tar to set a default 
  22. archive. By default through compiling this is set to 'tar.out', but you can
  23. change this by setting the environmental variable 'TAPE' to anything.
  24.  
  25. This version has been compiled with GNU GCC v1.40 and the MiNT libraries at
  26. patchlevel 19. To take full advantage of GNU Tar, use MiNT v0.9x, which has
  27. the ability to support symbolic links within the kernel.
  28.  
  29. I must pass a lot of credit onto Eric Smith for all the work he has put into
  30. making MiNT, for which without this and the libraries, this port would have
  31. been so much harder to do.
  32.  
  33. Release Additions for SCSI Tape Streamer Extensions (18/03/92)
  34. ==============================================================
  35.  
  36. With this port of GNU Tar it is now possible to talk to SCSI tape
  37. streamers connected through the DMA bus(via a host adapter). To access such
  38. a streamer a bios driver must be installed, this driver is called TapeBIOS.
  39. TapeBIOS is a totally separate package, that contains programmers docs, include
  40. files, library code and support programs to help programmers use the new bios
  41. device, through standard trap function calls. In all the package is about 190K
  42. of code, so if you need SCSI streamer support then get TapeBIOS.
  43.  
  44. In this version there is only one problem I know of so far. This is the ability
  45. to use any of GNU Tar's append or update features on SCSI Tape Streamers.
  46. The sole reason for this is that not all tape drives support backspacing the
  47. tape drive, and mine doesn't. So I couldn't test even if I did implement it.
  48. If anyone is willing to supply a fix please let me know.
  49.  
  50. Using Compressed archives on the Tape Streamer is not yet supported, if you
  51. execute any command that requires this, GNU Tar will hang. If you want an
  52. explanation why, then check out number 1. in the BUGS file.
  53.  
  54. To access the Tape Drive from GNU Tar use '=tape' as the output archive.
  55. First you must install the TapeBIOS device driver. Then use commands
  56. like this to access the tape drive.
  57. i.e.
  58.         gtar cvf =tape *    
  59.  
  60. Will create, and verbosely list, the archive on the tape and all files in the
  61. current directory and subdirectories will be put into the archive on tape.
  62.  
  63. NOTE: If the devicename '=tape' has any string whatsoever before it then GNU
  64. tar will assume access to the tape drive. (i.e. if device is 'atari=tape', then
  65. gtar will treat this device as though you want to access the tape unit.)
  66.  
  67. You may like to set the environmental variable 'TAPE' to '=tape', so that a
  68. simple command like 'gtar vt' would list the archive on the tape drive
  69. verbosely. BE CAREFUL when setting this, you must say 'setenv TAPE="=tape"',
  70. or what ever the equivalent of your shell is. i.e. you must enclose '=tape'
  71. within quotes.
  72.  
  73. The TapeBIOS installs an XBRA id of 'TAPE' into trap #10, and also a cookie
  74. in the cookie jar with an id again of 'TAPE' with the version number. When
  75. writing your own code for use with TapeBIOS, best method is to check the
  76. cookie jar for the presence of the driver or you can make a trap #10 call with
  77. command $ACE. If the return code is $ACE, then the driver isn't present.
  78.  
  79. Please let me know of any inconsistencies you find using GNU Tar and I'll 
  80. attempt to fix them.
  81.  
  82. Alan Hourihane
  83. email: alanh@logitek.co.uk
  84. 18/3/92
  85.