Scieneer Common Lisp 1.3.9 online documentation

x86 Solaris

Introduction

The i586 Solaris port is designed to work with Intel Pentium or compatible processors. The port has been built for the Sun Solaris 10 01/06 release.

The port comes with two variants supporting different representations for the Common Lisp long-float type. The first variant represents the long-float type using a 64 bit double precision floating point format, and the second 'long-float' variant represents the long-float type using a 80 bit extended precision floating point format.

Installation

SCL is intended to be installed in the directory: /opt/scl/. If installed elsewhere then the location of the lisp core file will need to be specified on the command line or the SCLLIB environment variable set to the directory containing the lisp core file.

Foreign code

When compiling foreign C code to be loaded into SCL, define _REENTRANT so that the code is built for thread safety, such as thread safe errno handling.

Foreign code may be compiled into a shared object to speed the loading of the object, see ext:load-dynamic-object. The code should be compiled to be position independent, and the shared object must resolve all dependent libraries. Below is an example of compiling the C code in the file tst.c into a shared object that may be loaded by ext:load-dynamic-object where the shared object uses a library named libmylib.

gcc -fPIC -D_REENTRANT -D_POSIX_PTHREAD_SEMANTICS -c tst.c
ld -G -o tst.so tst.o -L/mylibs -R/mylibs -lmylib -lc

Character encoding conversion.

For character format converstion, between the internal UCS-2 format, the libiconv library is used. This libraray is available under the terms of the LGPL license and the source code may be downloaded from ftp://ftp.gnu.org/pub/gnu/libiconv/. A precompiler binary of libiconv is provided with SCL and is installed under /opt/scl/. If recompiling libiconv for SCL, be sure to compile for thread safety by defining the C flag -D_REENTRANT.

Memory management

The x86 port uses a conservative garbage collector. Objects that might otherwise be garbage may be kept alive due to the conservative nature of the garbage collector.

The control stack and the number stack are shared on the x86 port.

The standard memory map supports up to 3556M bytes of memory allocated to the lisp heap, using a contiguous segment of the address map starting at address 0x10000000. The default size is 512MB, which may be overridden using the command line option -dynamic-space-size followed by the size in MBytes. For SCL builds with custom address maps please contact us.

License keys

The license keys for the Solaris port are locked to the machine hostname and the machine hostid. These can be found using the commands: hosthname and hostid respectively.These are also output by SCL as part of the machine configuration if SCL fails to find a valid key.

Known issues

Tracing and breakpoints are not thread safe but should be fine so long as only a single thread touches the code with a breakpoint.