|
Documentation Freeware License Change Log Return to Main page |
|
CheckIp v1.3
Copyright 2006 by M Ranks
Monitors your IP address at regular intervals & reports via email
when your IP address has changed. Can use either a specific URL on
the internet or a Router to obtain the IP address. Will run from the
console or can be installed as a Service on WinNT, Win2000, WinXP, Win2003,
Vista, or Windows7. Runs from console on all Win98 or higher systems. The program
is FREE for non commercial use
(Read license for further details). Supports sending email via your ISP or with
GMail.
Installation is easy, just unzip the file and run the program.
This program does not contain
spyware, ads, beg screens, or any other annoyances.
New... Tested on Windows7.
Installation
When you unzip CheckIP.zip, all the files will placed in the
c:\CheckIP directory.
Important files:
CheckIP.exe - IP Monitor (this is run as a service)
CheckIPC.exe - IP Monitor (this is run from console)
CheckIPCfg.exe - Program to test checkip.ini file
checkip.ini - configuration file
checkiplog.txt - log file
ReadME.txt - this file
changelog.txt - change log
Configuration
To configure the monitor edit the checkip.ini file:
Change "your-smtp-server.com" to your isp's SMTP server address.
Change "from@emailaddress.com" to the email address you want to see
in the from line.
Change "to@emailaddress.com" to the email address you want to send
address change alerts to.
You can change the monitor interval(timedelay). It is currently set a
60 minutes between address checks.
You can either use the router or an external url to obtain your ip address.
You can change the 'ctype' parameter to use the
router (ctype = router) or a dns (ctype = dns).
If you use the routerURL, you must change the password value to the password
you use to access the router. Also change the ip address if necessary.
If you use the checkURL, you can use any one of the 5 urls(or others you find)
listed in the .ini file. (Note.. these sites are not affilated, so they may
change from time to time. Use these at your own risk.)
Use the link below to find url's that you can use in the checkURL parameter:
http://www.google.com/search?hl=en&q=%22my+ip+address%22&btnG=Google+Search
EXAMPLE 1:
From the checkip.ini file:
mailserver = your-smtp-server.com
fromaddr = from@emailaddress.com
toaddr = to@emailaddress.com
smtptype = N
smtpauth = N
smtpuser = user
smtppass = password
timedelay = 15
ctype = dns
checkURL = http://ipchicken.com
EXAMPLE 2(for sending email via GMail):
From the checkip.ini file:
mailserver = smtp.gmail.com
fromaddr = your-GMail-address@gmail.com
toaddr = to@emailaddress.com
smtptype = E
smtpauth = Y
smtpuser = your-GMail-address@gmail.com
smtppass = your-GMail-password
timedelay = 15
ctype = router
routerURL = http://admin:password@192.168.1.1/Status.htm
*Note about routers. This program was tested using a Linksys BEFSR41 on firmware
version 1.45.7, a Linksys WRT54G on firmware version v200.8.3sv, and a
Motorola VT100v Vonage internet phone access device. (plus other listed below)
Settings for Linksys BEFSR41:
routerURL = http://admin:password@192.168.1.1/Status.htm
routerIndex = 2
Settings for Linksys WRT54G:
routerURL = http://admin:password@192.168.1.1/Status_Router.asp
routerIndex = 0
Settings for Linksys RT31P2:
routerURL = http://admin:password@192.168.15.1/RouterStatus.htm
routerIndex = 0
Settings for Linksys RT300:
routerURL = http://admin:password@192.168.15.1/cgi-bin/webcm?getpage=/usr/www_safe/html/status/Router.html
routerIndex = 0
Setting for Motorola VT100v, this is a Vonage internet phone device that
can also act as a router:
routerURL = http://192.168.102.1/startupdata.html
routerIndex = 0
Setting for SmoothWall Express 2.0, Linux software that turns a computer
with 2 NIC's into a firewall & NAT:
routerURL = http://admin:password@192.168.2.1:81/cgi-bin/advstatus.cgi
routerIndex = 3
Settings for Netgear RP614v2 Web Safe Router:
routerURL = http://admin:password@192.168.0.1/sysstatus.html
routerIndex = 0
Settings for Netgear WGR614 Wireless Router:
routerURL = http://admin:password@10.0.0.1/RST_status.htm
routerIndex = 0
Settings for D-Link DI-604:
routerURL = http://admin:password@192.168.0.1/st_devic.html
routerIndex = 2
Settings for Ericsson HM210di:
routerURL = http://admin:password@192.168.1.1/MainPage?id=6
routerIndex = 0
Other routers may work, but will require some research & experimentation. First
bring up your routers admin page in the browser. Find the status page that has
the routers current IP address. You should be able to copy the last part
of the url after the HTTP:// on the browser url line and paste it after the @ in
routerURL line in the checkip.ini file. Find the current IP address is on the
page. There will be several IP addresses on the page. On the BEFSR41 the current
IP address is the 3rd one on the page so the routerIndex is set to 2, the WRT54G's
current IP address was the first one, so the routerIndex is set to 0 for it. Now
run CheckIPCfg in a command box and the configuration will be tested and an email
will be sent. You will also see a list of IP addresses from the router. The following
is from a Linksys BEFSR41 router:
C:\CHECKIP>CheckIPCfg
Aug 09, 2006 11:27:53 Checking CheckIP.ini file settings
Aug 09, 2006 11:27:53 Current IP address- 68.205.208.157
Aug 09, 2006 11:27:53 Url source- router
Aug 09, 2006 11:27:53 Wait time interval- 00015
Aug 09, 2006 13:29:22 # of IP addresses found- 07
IP table:
0 = 192.168.1.1
1 = 255.255.255.0
2 = 68.205.208.157
3 = 255.255.252.0
4 = 68.205.174.1
5 = 24.94.228.34
6 = 24.94.228.35
7 = 65.33.10.70
Send a test eMail? (y or n):y
Aug 09, 2006 11:27:53 Sending eMail to- To: to@emailaddress.com
Aug 09, 2006 11:27:53 SMTP server used- your-smtp-server.com
Send a test FTP? (y or n):n
Press the ENTER key to exit
As you can see, the WAN IP address is the 3rd parameter, so the routerIndex parameter
is set to 2, and is displaying the correct address.
Operation
You can either run the program from the console or install it as a
system service. To install the service type in the following from
on a command line:
c:\CheckIP\CheckIP -install
For more service options type c:\CheckIP\CheckIP -h
Then go to the system services to start and control the program.
Note... you may need to tag CheckIP program with Administration Privileges to install
as a service.
To run the program on the console, run CheckIPC. This version will work on
any win98, WinME or NT system.
To test the system, change the "tdebug" in the checkip.ini file to 1 and run
the console version. The system will run 2 cycles then send an email. Remember
to reset the "tdebug" back to 0 after the test.
Email
You will receive an email when the IP address has changed. The body of the email
will look like this:
Aug 09, 2006 11:55:37
New IP address is - 68.204.193.156
Previous IP address was - 68.205.208.157
Cycle count 00013
The Cycle count is the number of times the program has checked the IP address
since it was started.
Logging
The program will log actions to a log file called checkiplog.txt in the c:\checkip
directory. This is the default name & location, you can change this by changing the
iplog parameter in the checkip.ini file. A sample from a log file:
Aug 09, 2006 11:45:37 CheckIP v1.3 started as a service
Aug 09, 2006 11:45:37 Current IP address- 68.205.208.157
Aug 09, 2006 11:45:37 Url source- router
Aug 09, 2006 11:45:37 Wait time interval- 1
.
Aug 09, 2006 11:55:37 IP address changed to- 68.204.193.156
Aug 09, 2006 11:55:37 eMail sent- To: to@emailaddress.com
Aug 09, 2006 11:55:37 SMTP server used- your-smtp-server.com
.
Aug 09, 2006 11:55:38 FTP web page to- your-ftp-server.com
.
Aug 09, 2006 12:16:50 CheckIP service stopped
Other entires you may see in log file:
Each day the following entry is logged:
Aug 10, 2006 00:13:25 New day - IP address- 68.204.193.156
If debugging is on you will see this message every cycle:
Aug 09, 2006 11:49:37 (debug) IP address- 68.204.193.156
If the program cannot communicate with the router or web site,
you will see the following messages:
Aug 09, 2006 12:06:40 HTTP client, urlopen error using router
or
Aug 09, 2006 12:13:41 HTTP client, urlopen error using dns
If the program is unable to contact your smtp server, you will see the following message:
Aug 12, 2006 16:44:38 SMTP open error on your-smtp-server.com - failed to send email
If the program is unable to contact your ftp server, you will see the following message:
Aug 12, 2006 16:44:38 FTP open error on your-ftp-server.com - failed to send web page
Freeware license For: CheckIP CheckIPC CheckIPCfg Copyright 2006 by M Ranks This software is being distributed as Freeware. It may be freely used, copied and distributed as long as it is not sold or used for commercial gain, and all original files are included, including this license. By using this software, you agree to these terms and the terms of the Disclaimer below: THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Inquiries about commercial licensing of this software should be directed to
CheckIP change log Copyright 2006 by M Ranks Monitors your IP address at regular intervals & reports via email when your IP address has changed. Can use either a specific URL on the internet or a Router to obtain the IP address. Will run from the console or can be installed as a Service on WinNT, Win2000, WinXP, Win2003 or Vista. Runs from console on all Win98 or higher systems. v1.3 - 01/22/2006 Add support for sending email via GMail v1.2 - 08/17/2004 Fixed email crash when smtp server does not connect. Added ability to FTP a redirect page to a web site. Program will check last stored IP address on startup. v1.1 - 08/09/2004 Added support for obtaining IP address from a router. Fixed program crash when url not obtained. Cleaned up email. Added system logging. Stop service now supported. Added CheckIPCfg program to check configuration. Subject line is changeable. Time delay now in minutes.