dbgmailr-2.0


==DESCRIPTION==================================================================
dbgmailr is a simple little Perl utility for 'debugging email'. It does this 
by showing (by default) the entire SMTP transaction of a given email, thus 
providing insight into any problems which you might otherwise remain unaware. 
It has a couple of unique features that make it useful as a quick-and-dirty 
mailer as well:

1. You can use it to send attachments (MIME-encoded).
2. You can send email directly to the destination SMTP host, sending SMTP 
   commands directly to it, alleviating the need to have an SMTP host to relay
   your message.

It was not intended as a spamming tool. I have used it on many occasions to
investigate the workings of mail systems or to track down problems, so in this 
context it becomes a useful sysadmin tool. I also advocate using it as an
educational device.

Now (as of version 2) dbgmailr uses a graphical interface via Tk.


==INSTALLATION=================================================================
You need to have Perl installed, as well as the following modules in order for
dbgmailr to work:

	Net::SMTP
	MIME::Types
	MIME::Lite
	Tk

These modules can be gotten from http://www.cpan.org. If you are using the
ActiveState Perl distribution on Win32, Net::SMTP is already installed, and 
you can get the other two by executing the following commands on the 
command-line of a computer that is connected to the Internet:

ppm install MIME-Types
ppm install MIME-Lite
ppm install Tk


==RUNNING======================================================================
To execute dbgmailr.pl run

	perl dbgmailr.pl

from a command-line. Also note that on a Windows platform you can simply run 
the file dbgmailr.bat in this archive.


==NOTES========================================================================
dbgmailr was developed in the Win32 environment. It has not been tested on a
*nix variant such as Linux. If you manage to do this and have any comments, 
please drop me a line at info at arbingersys dot com.