This utility has been superseeded, we now recommend

https://netwinsite.com/easyform

This is a CGI program that collects information that a user has submitted in a web page form, and then emails it to someone, and optionally can CC to another address. This could be used for collecting information, or for help requests or bug reports etc...

Please read this page, it should contain everything you need to know about setting up CGIMAIL, only then if you still cannot figure it out, you should email your problem, explaining exactly how you have it set up to cgimail-support@netwinsite.com

Yes, we do not charge for the use of this software. You may copy and distribute it as you wish. As such, it comes with no guarantee of any sort. If you find any bugs, please report them to cgimail-support@netwinsite.com as we do like to have bug free programs :-)

Let me know of you need it compiled on another platform: cgimail-support@netwinsite.com

UNIX Install Notes:
Download, uncompress it (type in "uncompress cgimail...tar.Z"), then untar it (type in "tar -xvf cgimail....tar), then copy cgimail.cgi into your cgi-bin directory. If it does not work, create the .log file, and make sure all of its files have the permissions of 'nobody' (use chown and chgrp commands).

Windows Install Notes:
Download, copy it into your cgi-bin directory (this file is not compressed) you should rename it to "cgimail.exe"

MAC OSX Install Notes:
Download and install like for UNIX Install above, but you want to have the ownership owner:group settings set to root:staff so that cgimail has the correct ownership for executing correctly.

Once it is in your cgi-bin directory, you can run it by typing
"./cgimail.cgi make_ini_file".
(or on windows type in ".\cgimail.exe make_ini_file")
It will ask you if you want to make a demo .ini file, type in "y". edit the file ./cgimail10.ini and correct the incorrect lines. Or you can copy the examples and ini file from below, and modify them from there. On unix servers, if you are not installing on a local machine, then you have to have telnet access to change the permissions or run the program (to make the demo ini file).
On windows machines, if you are not installing on a local machine, then you have to have some means of installing like PCAnywhere or Control IT.
On some unix servers you cant change the permissions to "nobody" unless you are the superuser "root", if you dont have "root" access you'll have to ask someone in charge to set it for you.
You cannot run programs or change permissions through an FTP client! :-)

For unix systems, you need to make sure that you have the correct access permissions set on the cgimail files, the account "nobody" is usually used for web access, and that is what you should set it to.
You also need to make sure that the cgimail file you are installing matches the platform that you are installing it to.

Are you getting 404 or 405 errors when you click on the Submit button? The 404 means that the cgimail.exe file is not where you thought it was. You'll need to check that the "action" variable inside the "<form>" tag is pointing at the right file, and that the file is in the right place.
The 405 error means that the post cant be sent to the cgimail.exe file, because it either has the wrong permissions set on it (unix only problem so far), or that the web server doesnt think that that particular directory is valid for executable files, in this case you need to find the right directory, and put the cgimail files there, or consult your web server documentation to see how you are supposed to have cgi compiled script files run.

You can copy the program file to an alternative name, to be able to run multiple configurations from the same directory. The program uses an .ini and .log file of the same name. So if you rename it to "mailer.exe" it would use "mailer.ini" and mailer.log" files.

The program is run when a form submission occurs, this can come from any html page that points to your cgi program. You make a HTML page that has a form in it, and make the form action value point to the cgi on your server. Set action value of the form variable like this: action="/cgi-bin/cgimail10.exe", make sure that you get the name of the cgi program correct, as you can rename it to be anything you want.
The form must point to the cgi program for the post action to succeed.
The form must, of course, have a submit button in it!
All of the form elements that are submitted do not have to be emailed, you must name all of the form elements that are to be included in the email, in the INI file (see ini settings below), you can specify that all form elements are to be sent.

Here is a sample html file that has a form in it that shows how you might set it up:

<HTML>
<HEAD>
<BODY BACKGROUND="/samples/images/backgrnd.gif">
<TITLE>Sample HTML FIle</TITLE>
</HEAD>
<BODY>
<CENTER>
<h2>Tell me your interests</h2>
<form method="POST" action="/cgi-bin/cgimail.exe" name="emaildata" >
<TABLE spacing=0 border=0>
<tr><td>Your Name:</TD><TD><input type="text" name="Name:" value="Someone?"></TD></TR>
<tr><td>Your Email:</TD><TD><input type="text" name="Email:" value="Someone@somewhere"></TD></TR>
<tr><td>What kind of a request is this?</TD><TD><SELECT name="Subject:">This is a Bug Report<OPTION>This is a feature request</SELECT>
<tr><td>Comments:</TD><TD><TEXTAREA name="Comments:" rows=5 cols=20>some
lines</TEXTAREA></TD></TR>
</TABLE>
<input type="submit" name="action" value="SEND"><br>
</form>
</CENTER>
</BODY>
</HTML>

You can, of course, put the form on any of your web pages.
Once you have done this, the form would contain the variables "Name:". "Email:", "Interests:".
These must be specified in the ini file if you wish them to be included in the email.

Here is an example .ini file:
(see below for meanings of ini settings):

smtp smtp.MyISP.com
logging errors
sendall false
success_html_page /http/docs/sent.html
failure_html_page /http/docs/notsent.html
headerline To: "Joe Bloggs" <JoeBlogggs@MyISP.com>
headerline From: "CGIMAIL" <JoeBlogggs@MyISP.com>
use_submitted_variable_for_headerline Subject:
bodycontent_line Here are the users details:
use_submitted_variable_for_bodycontent Name:
use_submitted_variable_for_bodycontent Email:
use_submitted_variable_for_bodycontent Comments:

Here is a sample output email, based on the sample html and ini files above:

To:  "Joe Bloggs" <JoeBloggs@MyIsp.com>
From:  "Joe Bloggs" <JoeBloggs@MyIsp.com>
Subject:  This is a Bug Report
Date:  Wed, 22 Mar 2000 11:39:39 +1200

 Here are the users details: 
 Name: Joe
 Email: JoeBloggs@MyIsp.com
 Comments: It doesn't work when I click
           on the submit button.
           A window comes up with
           "Access Violation at 0x004529EC"
           how do I fix it?

There must be no spaces before an ini file setting, one space after it, and the value for the setting goes directly after that space.