+ If you don't have a C compiler toolchain installed, the
+ rebuild-ccl will not work. Please
+ refer to Chapter 3, Building Clozure CL from its Source Code for
+ addtional details.
+
The following terms are used in subsequent sections; it may be helpful to refer to these definitions.
-fasl
+ fasl
files are the object files produced
by The Lisp
+ The Lisp
kernel is a C program with a fair amount of
platform-specific assembly language code. Its basic job is to
@@ -2004,9 +2010,9 @@
files on different platforms; see
Table 3.1, âPlatform-specific filename conventionsâ. A heap
+ A heap
image is a file that can be quickly mapped into a
- process' address space. Conceptually, it's not too different
+ process's address space. Conceptually, it's not too different
from an executable file or shared library in the OS's native
- format (ELF orMach-O/dyld format); for historical reasons,
+ format (ELF or Mach-O/dyld format); for historical reasons,
Clozure CL's own heap images are in their own (fairly simple)
format. The term A bootstrapping image is a minimal
+ A bootstrapping image is a minimal
heap image used in the process of building Clozure CL itself. The
bootstrapping image contains just enough code to load the rest
@@ -2027,5 +2033,5 @@
as-yet-unsupported ones) has a uniquely named subdirectory of
compile-file. fasl files store the
@@ -1994,5 +2000,5 @@
see
Table 3.1, âPlatform-specific filename conventionsâ full heap image refers to a
@@ -2015,5 +2021,5 @@
standard full heap image files on different platforms; see
Table 3.1, âPlatform-specific filename conventionsâ.ccl/lisp-kernel/; each such
-
+
contains a Makefile and may contain some auxiliary files (linker
scripts, etc.) that are used to build the lisp kernel on a
@@ -2194,75 +2200,58 @@
There are currently three versions of Clozure CL that you - might want to use (and therefore might want to build from +
At a given time, there are generally two versions of Clozure CL that + you might want to use (and therefore might want to build from source):
Version 1.0 - the more stable version
+The released version
Version 1.1 - the more recent version, which - runs on more platforms (including x86-64 platforms) and - supports Unicode
-Version 1.2 - supports (at least) all of the - features and platforms of 1.1, but is distributed and updated - differently
+The development version, called the "trunk", which + may contain both interesting new features and interesting new bugs +
All versions are available for download from the Clozure CL - website in the form of archives that contain everything you need - to work with Clozure CL, including the complete sources, a full - heap image, and the foreign-function interface database.
-Version 1.0 archives are named
- openmcl-platform-all-1.0.tar.gz,
- where platform is either
- darwinppc, darwinppc64, or
- linuxppc. Because version 1.0 is no longer
- undergoing active development, you won't ever need to update
- these sources.
Version 1.1 archives are named
- openmcl-platform-snapshot-yymmdd.tar.gz,
- where platform is either
- darwinppc, darwinx8664,
- linuxppc, linuxx8664, or
- freebsdx8664, and where
- yymmdd is the year, month, and day
- the snapshot was released.
Because version 1.1 is undergoing active development, - there may be times when you want to get sources that are more - recent than the most recent snapshot and use them to build - yourself a new bleeding-edge Clozure CL. In that case, you should - download and install the latest snapshot, and then update your - sources via CVS. At that point you can rebuild and you'll have - the latest and greatest Clozure CL. The snapshot has CVS - working-copy information in it, so all you need to do to update - is
+All versions are available for download from svn.clozure.com via + the Subversion source control system.
++ For example, to get a released version (1.3 in this example), + use a command like: +
-$ cd ccl -$ cvs login # password is "cvs" -# this step only needs to be done once, -# that'll store the trivially encrypted -# password in ~/.cvspas -$ cvs update --
Unless you tell it to, cvs won't delete ("prune") empty - directories or create new ones when the repository changes. - It's generally a good habit to use
+ svn co http://svn.clozure.com/publicsvn/openmcl/release/1.3/xxx/ccl + ++
++ To get the trunk version, use: +
-$ cvs update -d -P # create dirs as needed, prune empty ones --
Version 1.2 archives follow naming conventions that are - similar to those used by 1.0 (though more platforms are supported.) - However, rather than containing CVS working-copy information, the - 1.2 (and, presumably, later) archives contain metainformation used - by the Subversion (svn) source-code control system.
-Subversion client programs are pre-installed on OSX 10.5 and + svn co http://svn.clozure.com/publicsvn/openmcl/trunk/xxx/ccl + +
+
+
+ Change the "xxx" to one of the following names:
+ darwinx86,
+ linuxx86,
+ freebsdx86,
+ solarisx86,
+ window,
+ linuxppc,
+ or
+ darwinppc.
+
+ In the case of released versions, there may also be tar archives + available. See the Clozure CL + Trac for details. +
+Subversion client programs are pre-installed on Mac OS X 10.5 and later and are typically either pre-installed or readily available on Linux and FreeBSD platforms. The Subversion web page contains links to subversion client programs - for many platforms; users of OSX versions 10.4 and earlier can also + for many platforms; users of Mac OS X 10.4 can also install Subversion clients via Fink or MacPorts.
@@ -2392,6 +2381,6 @@ tools, the better; some versions of gcc 3.x on Linux have difficulty compiling some of the kernel source code correctly - (so gcc 4.0 should be used, if possible.) On OSX, the - versions of the tools distributed with XCode should work fine; + (so gcc 4.0 should be used, if possible.) On Mac OS X, the + versions of the tools distributed with Xcode should work fine; on Linux, the versions of the tools installed with the OS (or available through its package management system) should work @@ -2401,6 +2390,11 @@ GNU version of the m4 macroprocessor (calledgm4 on FreeBSD) should be installed.
-
+ In order to build the lisp kernel on Mac OS X + 10.6 Snow Leopard, you must install the optional 10.4 + support when installing Xcode.
+- + CCL:*TRACE-LEVEL* [Variable]
Variable bound to the current nesting level during execution of before and after trace actions. The default printing actions use it to determine the amount of indentation.
- + CCL:*TRACE-MAX-INDENT* [Variable]
The default before and after print actions will not indent by more than the value of ccl:*trace-max-indent* regardless of the current trace level.
-
+
CCL:TRACE-FUNCTION spec &key {keyword value}* [Function]
- + CCL:*TRACE-PRINT-LEVEL* [Variable]
@@ -3248,5 +3242,5 @@ explicit printing done by user code.- + CCL:*TRACE-PRINT-LENGTH* [Variable]
@@ -3256,5 +3250,5 @@ explicit printing done by user code.- + CCL:*TRACE-BAR-FREQUENCY* [Variable]
@@ -3380,5 +3374,5 @@domain---This is used to indicate where the external @@ -3414,5 +3408,5 @@
Despite the function's name, it doesn't necessarily create a @@ -3582,5 +3576,5 @@
@@ -3598,5 +3592,5 @@ @@ -3626,5 +3620,5 @@ @@ -3648,5 +3642,5 @@@@ -4144,5 +4138,5 @@
@@ -4187,5 +4181,5 @@
@@ -4233,5 +4227,5 @@
Clozure CL sets up logical pathname translations for logical hosts: ccl and home
The CCL logical host should point to the
ccl directory. It is used for a variety of
@@ -4387,5 +4381,5 @@
platforms.
-
+
CCL:MAP-FILE-TO-IVECTOR
pathname
@@ -4447,5 +4441,5 @@
a memory error.
-
+
CCL:UNMAP-IVECTOR
displaced-array
@@ -4459,5 +4453,5 @@
target is an empty vector (of length zero).
-
+
CCL:MAP-FILE-TO-OCTET-VECTOR
pathname
@@ -4469,5 +4463,5 @@
bytes.
-
+
CCL:UNMAP-OCTET-VECTOR
displaced-array
@@ -4508,5 +4502,5 @@
static.
Clozure CL provides the
function CCL:SAVE-APPLICATION, which creates a file
@@ -4642,5 +4636,5 @@
converted, because address 0 can always be relied upon to refer to
the same thing.
As of Clozure CL 1.2, the constant CCL:+NULL-PTR+
refers to a MACPTR object that points to address 0.
opencml64 script.
-
+
SAVE-APPLICATION
@@ -4837,5 +4831,5 @@
@@ -5076,5 +5070,5 @@
-
+
BUILD-APPLICATION &key
( process-suspend was previously called
@@ -6399,5 +6393,5 @@
@@ -6452,5 +6446,5 @@
It would be nice to have more discussion of what it means
@@ -6596,5 +6590,5 @@
It would probably be better for result
@@ -6735,10 +6729,10 @@
This should arguably be SETFable, but doesn't seem to
@@ -6991,5 +6985,5 @@
Advises the OS scheduler that the current thread has nothing
@@ -7000,10 +6994,10 @@
This is a holdover from the days of cooperative
@@ -7028,5 +7022,5 @@
Creates and returns an object of type CCL::READ-WRITE-LOCK.
@@ -7385,10 +7379,10 @@
There probably should be some way to
@@ -7413,5 +7407,5 @@
result should probably be interpreted
@@ -7576,5 +7570,5 @@
result should probably be interpreted
@@ -7620,5 +7614,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -7670,5 +7664,5 @@
@@ -7716,5 +7710,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -7724,5 +7718,5 @@
@@ -7767,5 +7761,5 @@
process---a process, typically created by process-run-function or by make-process Waits for the specified process to terminate. If the
@@ -8034,5 +8028,5 @@
address-family---The address/protocol family of this socket. Currently
@@ -8133,5 +8127,5 @@
Creates and returns a new socket Extracts the first connection on the queue of pending
@@ -8186,5 +8180,5 @@
Converts a dotted-string representation of a host address to
@@ -8214,5 +8208,5 @@
ipaddr---A 32-bit integer representing an internet host address Converts a 32-bit unsigned IP address into octets. ipaddr---a 32-bit integer representing an internet host address Converts a 32-bit unsigned IP address into a host name
@@ -8269,5 +8263,5 @@
host---Specifies the host. It can be either a host name
@@ -8277,5 +8271,5 @@
Converts a host spec in any of the acceptable formats into a
@@ -8297,5 +8291,5 @@
port---Specifies the port. It can be either a string, such as
@@ -8306,5 +8300,5 @@
Finds the port number for the specified port and protocol Reads a UDP packet from a socket. If no packets are
@@ -8380,5 +8374,5 @@
Send a UDP packet over a socket. socket---The socket to shut down (typically a tcp-stream) Shuts down part of a bidirectional connection. This is
@@ -8443,10 +8437,10 @@
Returns the native OS's representation of the socket, or
@@ -8473,10 +8467,10 @@
Returns the 32-bit unsigned IP address of the remote host,
@@ -8498,10 +8492,10 @@
Returns the remote port number, or NIL if the socket is not
@@ -8523,10 +8517,10 @@
Returns 32-bit unsigned IP address of the local host. Returns the local port number Returns :internet or :file, as appropriate. Returns :active for tcp-stream, :passive for
@@ -8620,10 +8614,10 @@
Returns the socket format as specified by the :format
@@ -8645,10 +8639,10 @@
returns :stream for tcp-stream and listener-socket, and
@@ -8669,10 +8663,10 @@
simple-error The OS error code of the error A symbol representing the error code in a more
@@ -8746,10 +8740,10 @@
A string describing the context where the error happened. On
@@ -8772,5 +8766,5 @@
The close generic function can be applied to sockets. It
@@ -8804,5 +8798,5 @@
executes body with var bound to the result of applying
@@ -8942,5 +8936,5 @@
program---A string or pathname which denotes an executable file.
@@ -8988,5 +8982,5 @@
Runs the specified program in an external (Unix) process,
@@ -9008,5 +9002,5 @@
proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM. Sends the specified "signal" to the specified
@@ -9037,10 +9031,10 @@
Returns the process id assigned to
@@ -9064,10 +9058,10 @@
Returns the stream created when the input argument to
@@ -9090,10 +9084,10 @@
Returns the stream created when the output argument to
@@ -9117,10 +9111,10 @@
Returns the stream created when the error argument to
@@ -9144,10 +9138,10 @@
Returns, as multiple values, a keyword denoting the status
@@ -9179,5 +9173,5 @@
A stream that is associated with a file descriptor has
attributes and accessors:
@@ -9466,5 +9460,5 @@
stream---a stream, presumably a fundamental-input-stream. Should try to read up to count elements from stream into the
@@ -10017,5 +10011,5 @@
stream---a stream, presumably a fundamental-output-stream. should try to write the first count elements of list to
@@ -10048,5 +10042,5 @@
stream---a stream, presumably a fundamental-input-stream should try to read successive elements from stream into
@@ -10087,5 +10081,5 @@
stream---a stream, presumably a fundamental-output-stream should try to write successive elements of vector to stream,
@@ -10125,5 +10119,5 @@
Returns the file descriptor associated with
@@ -10166,5 +10160,5 @@
stream---An input stream. The method defined on
@@ -10198,5 +10192,5 @@
Writes max-octets octets to stream from ivector, starting at
@@ -10204,5 +10198,5 @@
-
+
CHUD:*SHARK-CONFIG-FILE* [Variable]
-
+
CHUD:METER form &key (reset nil) (debug-output nil) [Macro]
Reads a symbol from the current input stream, with *PACKAGE*
@@ -14570,5 +14564,5 @@
In In In In If completely is T, sets the
@@ -14844,5 +14838,5 @@
Proclaims name
@@ -14897,5 +14891,5 @@
If name is non-NIL, defines name to be an alias for the
@@ -14939,5 +14933,5 @@
If there is already an EXTERNAL-ENTRY-POINT for
@@ -14980,5 +14974,5 @@
Calls the foreign function at the address obtained by
@@ -15020,5 +15014,5 @@
Calls the foreign function at address entrypoint passing the
@@ -15057,5 +15051,5 @@
Calls the foreign function at address entrypoint passing the
@@ -15095,10 +15089,10 @@
Tries to resolve the address of the foreign symbol
@@ -15123,10 +15117,10 @@
Tries to resolve the address of the foreign symbol name. If
@@ -15150,5 +15144,5 @@
In
@@ -15238,5 +15232,5 @@
@@ -15304,5 +15298,5 @@
@@ -15392,5 +15386,5 @@
It would be helpful to describe what an soname is and give
@@ -15469,5 +15463,5 @@
References an instance of a foreign type (or a component of
@@ -15503,5 +15497,5 @@
Tries to resolve the address of the EXTERNAL-ENTRY-POINT
@@ -15532,5 +15526,5 @@
Executes body
@@ -15570,5 +15564,5 @@
Executes body in an environment in which each var is
@@ -15604,5 +15598,5 @@
Tells One typically wants interface information to be
@@ -15848,10 +15842,10 @@
@@ -17431,5 +17425,5 @@
name---a string which is the name of a new or existing
@@ -17444,5 +17438,5 @@
@@ -17468,5 +17462,5 @@
@@ -17496,5 +17490,5 @@
@@ -17522,5 +17516,5 @@
uid---a non-negative integer, identifying a specific user
@@ -17531,5 +17525,5 @@
filename
@@ -4790,5 +4784,5 @@
name "MyApplication")
@@ -5508,5 +5502,5 @@
CCL 1.2 and later, the #& reader macro can be used to
@@ -14629,5 +14623,5 @@
CCL 0.14.2 and later, the #? reader macro can be used
@@ -14676,5 +14670,5 @@
CCL 1.2 and later, the #/ reader macro can be used to
@@ -14779,5 +14773,5 @@
CCL 1.2 and later, the #> reader macro reads
@@ -14808,5 +14802,5 @@
CCL 1.2 and later, the CCL:FREE
@@ -15188,5 +15182,5 @@
CCL to remove the interface directory denoted by
@@ -15716,5 +15710,5 @@
define-objc-method
+ 13.6.1. Using define-objc-method
objc:defmethod
+ 13.6.2. Using objc:defmethod