T-EXEC TRANSFER EXEC DLL 


========================





(For use with Serv-U32.exe v2.2a and later only!)





This DLL makes Serv-U run a program of your choice at the completion of 


a file transfer (upload or download). This program can also be a batch 


file, and various transfer parameters can be passed to it.





The setup info needed by this DLL should be put in a file named T-EXEC.INI. 


The file should have the following form (example):





              [EXEC]


              UploadSuccess=c:\program files\vscan\scan.exe %f


              DownloadSuccess=c:\command.com /c c:\batch\countdown.bat %f


              UploadFailed=c:\logs\error.exe %f %h %i %u %c %d


              DownloadFailed=c:\logs\error.exe %f %h %i %u %c %d





The syntax should speak for itself. Supported are separate programs 


after a successful upload or download, as well as after an unsuccessful 


upload or download. If only certain events are needed, just leave out 


the additional lines in the .ini file. A number of meta-characters are 


supported which are replaced when the program is executed. The 


supported meta characters are:





              %f = full path/file name of file transferred


              %d = duration of transfer in ms.


              %c = sub-event code number


              %u = user name that transferred the file


              %i = IP address of FTP client


              %h = server home IP address





Since the system's directory at the moment of execution is not known 


only full path names should be used for both programs and any arguments 


that are files. To invoke a batch file the "c:\command.com /c" command 


should work for Win95/98, as shown in the sample .ini file. In NT 


"c:\winnt\system32\cmd.exe /c" should work equally well, but this has 


not been tested.





The file T-EXEC.DLL should be placed in the Serv-U directory, and the 


SERV-U.INI file should be updated to make it load the DLL upon startup.


This is done by adding a section to the .ini file reading (if it doesn't 


exist already):





	[EXTERNAL]


	EventHookDLL1=T-EXEC.DLL





If other event hooking DLL's are already present in this section a new 


line like the above one should be added with the proper sequential number.





The files are:





	T-EXEC.DLL	- 32-bit transfer program exec DLL


	T-EXEC.INI	- sample .ini file for the T-Exec DLL


	README.TXT	- this file








SOURCE CODE


===========





The full source code of the DLL is provided as an example of an 


event hooking DLL for Serv-U. It can be found in the file SOURCE.ZIP


and was made for Borland C++ v5.02 (But no Borland specific extensions


were used, so it should be easily portable to other compilers). 


The files are:





	T-EXEC.CPP	- WU_FTP log file format DLL source code


	T-EXEC.H	- header file for log DLL


	T-EXEC.DEF	- module definition file for DLL


	T-EXEC.IDE	- borland project file for DLL





NOTE


====





As is usual with shareware: No warranty or support is provided with 


this DLL or the source code. Use is *completely* at your own risk. For 


feedback, bug reports or other comments please contact the author at 


Rob@cat-soft.com.