This is a Windows Encapsulation for GNU TAR for DOS. GNU TAR for DOS is written by: First version, 1992-1993, known as RTAR or Pisa TAR, Luigi Rizzo, F. Rosellini & G. Mercaldo, University of Pisa Later versions, 1993-1994, known as GNU TAR for DOS Les Mikesell, (les@mcs.com) Windows Encapsulation, 1994, known as GNU TAR for Windows Will van Geest, University of Delft (W.J.M.vGeest@ET.TUDelft.NL) This program is free software; you can redistribute it and/or modify it, but you may not sell it. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability ir fitness for a particular purpose. GNU TAR, GNU TAR for DOS and GNU TAR for Windows are protected by the GNU GENERAL PUBLIC LICENSE, see the file COPYING. NOTE: Not all options of NTAR has been tested in WTAR, mainly due to lack of time and equipment (e.g. the tape functionality). This file is written for WTAR version 0.06. All options described in NTAR.DOC should work in WTAR too, with the following restrictions and additions. Restrictions: The program will not prompt for missing host, user, password or command fields in the network devices. Both --rshd and --wait on the command line can be used to restart WTAR after a backup, but sometimes the rsh command on the remote host will end with a "broken pipe" message. The resulting tar file seems to be okay though. Additions: There is a new command line option --keep-window. This will always leave the WTAR window on screen, even if the backup succeeded without errors. The windows is anyway left on screen if an error occured. Without --keep-window the window is removed if the backup finished without errors. WTAR tries to find the file WTAR.INI, first in the directory where WTAR.EXE is located, then somewhere along the path. In WTAR.INI the following settings are allowed (section [GNU TAR]). DefaultDevice is the default for the -f argument. This may be one of the network devices too. The default DefaultDevice is tar.out. Servers is a list of IP addresses. If WTAR is receiving a request from a remote host (when using --rshd, --wait, /dev/r*), WTAR tries to locate the remote's IP address in the Servers list. If the IP address is not in the list, the request is refused. If the Servers list is empty, or not defined at all, any host can access WTAR. People is a list of Unix user names. If the remote user name in the incoming request is on this list, access is granted. If not, the access is denied. If the People list is empty or not defined, any user can access WTAR. SendSize sets the size of the send buffer size. Data is send to the TCP/IP stack in chunks of this size. If SendSize is set to -1, WTAR asks the stack which size is good for it. Some stacks report an incorrect value for this. Therefore, if SendSize is 0 (default), WTAR determines a good value itself, based on which stack is being used. If SendSize is greater than 0, this value is used as the buffer size. DisableNagle can be 0 or 1. If this is 0, the TCP/IP stack tries to pack buffers together in one maximum sized IP packet, if DisableNagle is 1, every buffer is send as a seperate IP packet. The packing operation takes time, but it saves time if the buffers are small. Sending one large IP packet is more efficient than many small packets. The highest throughput is achieved by setting DisableNagle to 1 AND selecting a good SendSize. (I know this is technically incorrect, but it is sufficiently close close to the truth, and easier to explain.) Example WTAR.INI [GNU TAR] ; Every buffer is an TCP/IP packet DisableNagle=1 ; Let WTAR find the best buffer size SendSize=0 ; Save the tar file on host apeman, if not explicitly given DefaultDevice=/dev/rsh/apeman:johny:cat -> backup.tar ; The only servers which are allowed access Servers=100.100.100.2,100.100.100.1 ; The only people who are allowed access People=johny,root Compilation: If you want to recompile this version, use the Borland C++ compiler, version 3.1. First load WTARANSI.PRJ with Project|Load and execute Compile|Make or press function key F9. This generates a lot of warnings, but no errors. Load the project file WTAR.PRJ and execute make. This also generates warnings, but no errors. Exit Borland C++. That's it.