The Socket library for SICStus & Quintus Prolog
-----------------------------------------------

Written by:	K.Y. Hui
Version:	1.01
Date:		11 November 1997


This is the socket library module for both SICStus & Quintus Prolog
with automatic detection of machine platform and Prolog system.



Files
-----

This release comes with the following files:

README				-	this file
Makefile.sgi_sicstus		-	Makefile for SGI/SICStus
Makefile.sparc_quintus		-	Makefile for Sparc/Quintus
Makefile.sparc_sicstus		-	Makefile for Sparc/SICStus
sockets.pl			-	the main Prolog module file
machine_type.pl			-	machine platform mapping file
sgi_sicstus_sockets.c		-	C source for SGI/SICStus
sgi_sicstus_sockets.pl		-	Prolog source for SGI/SICStus
sparc_quintus_sockets.c		-	C source for Sparc/Quintus
sparc_quintus_sockets.pl	-	Prolog source for Sparc/Quintus
sparc_sicstus_sockets.c		-	C source for Sparc/SICStus
sparc_sicstus_sockets.pl	-	Prolog source for Sparc/SICStus


Installation
------------

1.	Edit "Makefile.inc" to suit your local configuration.
	The major option will be the location of SICStus/Quintus Prolog.
	For example, if your SICStus Prolog is installed in the
	directory "/usr/local/sicstus", make the following change
	to the corresponding Makefile:

	SICSTUS_HOME=/usr/local/sicstus

2.	Type:

		make <platform>

	to make the corresponding *.o object file.
	For example:

		make sgi_sicstus

	will make the SGI-SICStus version of the library.

3.	Edit the machine mapping file "machine_map.pl".
	It contains mappings from the machine name to the platform type.
	For example, the machine "finch" is mapped to an SGI by
	the entry:

	host_map(finch,sgi)

	*** NOTE:	You will surely have to modify the
			"../machine_map.pl" file to tailor for
			your local environment.

4.	The automatic platform detecting feature uses the environment
	variable "HOST". If you use the shell "csh" (or tcsh), you
	can check your setting by the command:

		setenv | grep HOST

	If your environment is not properly set, you can do it
	by editing your shell resource file. For "csh" (or tcsh),
	you can edit the file "~/.cshrc" and add the following line:

		setenv HOST `hostname`

	and then type the following to refresh your environment:

		source ~/.cshrc

	*** Notice the single-quote is the inverted one!


Porting to other systems
------------------------

To port the library to another system requires porting the
C and Prolog source code. For example, if you are porting
it to HPUX, you may have to create the two files:

	hpux_sicstus_sockets.pl
	hpux_sicstus_sockets.o (from the C source)

Usually, the Prolog part depends on the Prolog system
that you are using and does not need any modification
(unless you are using something other than SICStus & Quintus).

For the C part, you may not have to modify the source code
but compiling the *.o for your platform is essential.

(NB:	The HPUX version is already included in this release.)

 Name                     Last modified      Size  Description
 Makefile                 1998-07-09 17:19  651   
 Makefile.hpux_sicstus    1998-07-09 17:19  184   
 Makefile.sgi_sicstus     1998-07-09 17:19  166   
 Makefile.sparc_quintus   1998-07-09 17:19  168   
 Makefile.sparc_sicstus   1998-07-09 17:19  187   
 README                   1998-07-09 17:19  2.9K  
 VERSION                  1998-07-09 17:19  233   
 hpux_sicstus_sockets.c   1998-07-09 17:19   11K  
 hpux_sicstus_sockets.pl  1998-07-09 17:19  6.6K  
 sgi_sicstus_sockets.c    1998-07-09 17:19   11K  
 sgi_sicstus_sockets.pl   1998-07-09 17:19  6.6K  
 so_locations             1998-07-10 15:15  1.0K  
 sockets.pl               1998-07-09 17:19  912   
 sparc_quintus_sockets.c  1998-07-09 17:19  9.0K  
 sparc_quintus_sockets.pl 1998-07-09 17:19  7.4K  
 sparc_sicstus_sockets.c  1998-07-09 17:19   11K  
 sparc_sicstus_sockets.pl 1998-07-09 17:19  6.6K