Index of /download/contributed/web100Kylix

 Name                    Last modified      Size  Description
 Parent Directory                             -   
 web100_kylix.tar.gz     02-Oct-2003 23:23  6.1K  

			Kylix Module For Web100

			       Written By,
       	         Chris Hessing (chessing@chpc.utah.edu)

(c) Copyright 2001, University of Utah Center for High Performance Computing.


LEGAL
-----

All code in this release is released under the GPL license version 2 or later. 
A copy of the License can be found at:http://www.borland.com/kylix/gpl.html



GETTING KYLIX
-------------

This code was developed with Kylix Open Edition.  Kylix OE can be obtained from
from the Kylix portion of the Borland website.  The URL is:
http://www.borland.com/kylix


USING THE MODULE
----------------

This module consists of two parts.  The first part is a dynamic version of the
web100lib module.  There are two ways to create this module.  

(1) You may copy the modified Makefile from the utils_src directory over the 
one in the web100/utils/src directory, and then execute "make dlib".  The 
resulting library file should be called libweb100.so.0.  You can use the 
library by putting it in your /lib, or /usr/lib, or by changing your 
LD_LIBRARY_PATH to include the directory the library is located in.

(2) You can generate the library file by hand.  To do so, change in to the
/web100/util/src directory, and execute the following command :

gcc -shared -W1,-soname,libweb100.so.0.2001052311 -o libweb100.so.0 web100lib.o -lc

This should create the libweb100.so.0 library.  This library should be copied 
to /lib, or /usr/lib, or your LD_LIBRARY_PATH should be updated to reflect the
location of the library.


Once you have the library built, you are ready to use the Kylix unit.  To use
the unit, create a new project, and on the "uses" line, add "web100".  When you
try to build your program, if it complains about not knowing where the web100 
unit is, try appending "in 'web100.pas'" after the web100 on the uses line.  
Also, be sure that the web100.pas source file is in the same directory as your
project.

API DIFFERENCES
---------------

My goal was to keep the API as close to the original 'C' API as possible.
I feel that I was fairly successful, however, there are a few differences.  
Structures that were defined as external in the web100.h file do not exist in
the Kylix version.  (I am working on this for the next release.)  Also, in some
places #define macros were used to alias names to other functions.  In the 
Kylix port, these aliases are actual functions, that return the same values.
(See the end of the web100.pas unit for the implementation.)  Finally, when 
using a pointer to a structure, the Kylix unit has defined Pweb100_xxx to be
a pointer to a structure.  So, instead of declareing a variable like this in 
'C':

web100_agent *agent;

It would be delcared like this in Kylix :

agent:Pweb100_agent;


SOFTWARE INCLUDED
-----------------

In testing out this unit, I ported the readvar, writevar, and deltavar programs
from the original web100 code.  I have included the source for these programs
so that they can be used as a reference.  


CONTACTING ME
-------------

I can be reached at chessing@chpc.utah.edu for questions, comments, flames, or
other forms of abuse.