*********************************************************
*                          CEKIP                        *
*           IP Address Finder Library to DJGPP.         *
*      Copyright (c) 2000 by Cristian EmmericK (CEK)    *
*                E-mail: cek@mailbr.com.br              *
*                   ICQ(UIN): 52438873                  *
*                http://cekpage.tripod.com              *
*********************************************************


***********************
     INTRODUCTION
***********************

	CEKIP is a IP Address Finder Library to DJGPP, 
created by Cristian EmmericK (CEK) in Saturday, October
7, 2000. CEKIP was created in order to help DJGPP users 
that do Network Programming. It only works with Windows 
95, Windows 98 and others. I only could test it with 
Windows 95/98, if you have another Operation System, and
used CEKIP on it, tell me the results by e-mail please.
	


***********************
       COPYRIGHT
***********************

	CEKIP is FREEWARE. You can use it in your pro-
gram and you don't have to pay anything. But I would be
grateful if you mentioned CEKIP in the credits. :)  

                     ** DISCLAIMER **
 " I, Cristian EmmericK, do not accept responsibility for
 any effects, adverse or otherwise, that this library may
 have on you, your computer, or elsewhere and anything
 else that you can think of. Use it at your own risk."
                     ** DISCLAIMER **


***********************
      INSTALLING
***********************

	To intall CEKIP you have to unzip the file: 
CEKIP11.ZIP, into any directory you want.



	
***********************
         FILES
***********************

	The CEKIP files are:

\README.TXT		- CEKIP Readme Information
\MAKEFILE		- CEKIP Makefile
\LIB\LIBCEKIP.A         - CEKIP Library
\EXAMPLES\EX01.C        - Example 01
 


***********************
       COMPILING
***********************

	To compile, you have to enter in the directory
that CEKIP were unzipped and type:

  MAKE ALL       - Compile the library and the examples 
  MAKE INSTALL   - Install CEKIP to your DJGPP directory 
  MAKE CLEAN     - Delete the compiled examples and the 
                   library 
  MAKE UNINSTALL - Uninstall the CEKIP from your DJGPP
                   directory 
  MAKE EXAMPLES  - Compile the examples 




***********************
         USING
***********************

	When you make a program that uses CEKIP, you ha-
ve to link the program with LIBCEKIP.A. 
	You can do this like:


  - When compiled in the command line or makefiles add 
"-lcekip" to the end of gcc command, like:

  gcc myprg.c -o myprg.exe -lcekip 


  - If you are using RHIDE, go to the Options/Libraries
menu, type 'cekip' into any empty space, and make sure
the box next to it is checked.

 



***********************
       FUNCTIONS
***********************

	Here is the list of all functions of CEKIP 
library: 

 
unsigned long CEKIP_GetLocalIPAddress(void);




***********************
         TESTS
***********************


	Here is the list of all Operation Systems and 
Libraries tests of CEKIP library: 

 

Microsoft® Windows 95 - Successful.

Microsoft® Windows 98 - Successful.

Microsoft® Windows Millennium (ME) - Successful. 
- Thanks to Jason Boudreault

Microsoft® Windows Millennium (ME) with 2 Networks - 
Successful, but bugs were found. 
- Thanks to Jason Boudreault

Allegro v3.12 Game Programming Library - Successful,
but bugs were found.




***********************
         BUGS
***********************


	Here is the list of all BUGS found: 

 

2 Networks Machine - This doesn't seems to be a bug but
when you're using 2 Networks you have 2 IP Addresses 
e.g.: 200.26.132.56 and 166.76.213.42. CEKIP will only 
takes the first given IP Address, in this case it will be
200.26.132.56.

Allegro Game Programming Library - When you're using Mouse
routines, after calling CEKIP, Mouse Pointer breaks and
stops moving. I could not find solutions, but if you 
remove the mouse routines before calling CEKIP it will
works, after then you can re-install mouse routines 
without any problem.

 

If you found any bug or solutions, contact me by e-mail,
I'll be glad to know it.



 
***********************
        HISTORY
***********************


  Saturday, October 7, 2000 - First release of CEKIP is 
ready. Avaliable to download CEKIP v1.0. 

  Saturday, October 14, 2000 - New version released, CEKIP
v1.1. LIBCEKIP.A was reduced to 40KB. It was tested in 
others Operation Systems. And BUGS were found. Two topics
were added to CEKIP's Page, Bugs and Tests. Also avaliable 
to download CEKIP v1.1. 




***********************
        CREDITS
***********************

  PROGRAMMING:

  Cristian EmmericK (CEK)


  SPECIAL THANKS TO:

  DJ Delorie (DJGPP)  




***********************
        CONTACT
***********************

  You can contact me for any question at:

  URL: http://cekpage.tripod.com
  E-mail: cek@mailbr.com.br
  ICQ(UIN): 52438873