Scieneer Common Lisp 1.3.9 online documentation

AMD64 Solaris (64 bit)

Introduction

The 64 bit AMD64 port is built for the Solaris 10 01/06 release.

The port supports 80 bit extended precision floating point numbers via the Common Lisp 'long-float type. Double and single precision floating point numbers exploit the SSE extension which provides 16 floating pointer registers in 64 bit mode.

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 -m64 -fPIC -D_REENTRANT -D_POSIX_PTHREAD_SEMANTICS -c tst.c
ld -64 -G -o tst.so tst.o -L/mylibs/amd64 -R/mylibs/amd64 -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 AMD64 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 AMD64 port.

Over 64 GB of memory may be allocated to the lisp heap. The default size is 512MB, which may be overridden using the command line option -dynamic-space-size followed by the size in MBytes.

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.