The CO4 protocol has been developed with KAPI and C. It is thus made of a set of C programs that should be compilable with any C compiler as soon as KAPI libraries are available.
In order to use KAPI and its extension, there must be a HTTP server running somewhere for which the installer has the privilege to add new cgi-scripts and new directories.
The CO4 protocol and its documentation are available for public distribution under the terms of the COPYRIGHT file provided with the distribution. They can be retrieved through anonymous FTP (file transfer protocol) on the machine ftp.inrialpes.fr under the names:
/pub/sherpa/rapports/co4-manual.ps.gz /pub/sherpa/logiciels/co4/current.tar.gzOur HTTP server provides various information (among which the latest release and the on-line manual). The URLs are:
Do not hesitate to browse anywhere on our site (beginning with http://co4.inrialpes.fr); a lot of information about new developments is available there.
The CO4 protocol can be installed anywhere in your system provided that you follow the instructions below. The files can be obtained by:
$ gunzip co4-manual.ps.gz $ gunzip co4.tar.gz | tar xf -In the following, let $CO4DIR be the location of CO4 directory created by this installation. The content of the $CO4DIR (so the content of the tar-file) consists in the following files and directories:
INRIA Copyright notice;
name says it;
some sample repositories (useful for building your own);
C sources and libraries for SunOS 4.3/4.4 port;
C sources and libraries for SunOS 5.4/5.5 (Solaris) port with the gnu compiler;
the C sources for the CO4 protocol library;
the complete package for the KQML Application Programming Interface release
2.6e from EIT/Lockheed (see inside LICENSE notice);
configuration files for compilation;
and developers last minute documentation;
There are two specific installation steps since they can be carried out on independent different machines.
HTTP_DOC_ROOT to the document path of the HTTP server, where the CO4 directory containing all data will be created.
$ cd $CO4DIR/src $ make httpThe required cgi-scripts are then compiled and copyied to the CGI directory and the CO4 directory is created under the server root.
$ cd $CO4DIR/src $ make libco4
The scripts are provided in a following appendix 3.
$ cd $CO4DIR/examples/basic/src $ make $ cd .. $ ./run-script <CO4_ANS_URL> SCRIPTS/<file>The system will open several X-terminals for displaying the result of each repository execution (in the trace format, see p.).
$ cd $CO4DIR/examples/server/src $ make $ cd .. $ ./create-server <CO4_ANS_URL> server_name or $ ./wakeup-server <CO4_ANS_URL> server_nameSeveral repositories can be created with these actions. The system provide the URLS of the created repositories. These repositories contain an integer value as content. They can be manipulated through a HTTP client (see Interface).
The CO4 protocol can be used from an alien language (C, C++, etc.). For that purpose, the CO4 protocol is supplied with several libraries (libkapi, libKapi2 and libCo4) along with the corresponding include file (co4.h) which enables its use from these languages.
This can be done preferably through mail to email@example.com.