CheckIP Program V1.3 Documentation

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 Win7, Win8 & Win10. 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 Windows10.


                                 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.





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.

Return to Main page