Index: /trunk/source/doc/ccl-documentation.html =================================================================== --- /trunk/source/doc/ccl-documentation.html (revision 13104) +++ /trunk/source/doc/ccl-documentation.html (revision 13105) @@ -158,4 +158,9 @@ 4.8. Floating Point Numbers + + +
+ + 4.9. Watched Objects
@@ -419,5 +424,5 @@
- 12.12. The Foreign-Function-Interface Dictionary + 12.12. The Foreign-Function-Interface Dictionary
@@ -2738,4 +2743,38 @@ +
+ + 4.9. Watched Objects + +
+
+
+
+ + 4.9.1. WATCH + +
+
+ + 4.9.2. UNWATCH + +
+
+ + 4.9.3. WRITE-TO-WATCHED-OBJECT + +
+
+ + 4.9.4. Notes + +
+
+ + 4.9.5. Examples + +
+
+
@@ -3216,15 +3255,15 @@

- + 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]

@@ -3234,5 +3273,5 @@

- + CCL:*TRACE-PRINT-LEVEL* [Variable]

@@ -3242,5 +3281,5 @@ explicit printing done by user code.

- + CCL:*TRACE-PRINT-LENGTH* [Variable]

@@ -3250,5 +3289,5 @@ explicit printing done by user code.

- + CCL:*TRACE-BAR-FREQUENCY* [Variable]

@@ -3374,5 +3413,5 @@
- +
Arguments and Values:

domain---This is used to indicate where the external @@ -3408,5 +3447,5 @@

- +
Description:

Despite the function's name, it doesn't necessarily create a @@ -3576,5 +3615,5 @@

-

4.3.4.1. Encoding Problems

+

4.3.4.1. Encoding Problems

@@ -3592,5 +3631,5 @@
-

4.3.4.2. Byte Order Marks

+

4.3.4.2. Byte Order Marks

@@ -3620,5 +3659,5 @@
-

4.3.4.3. DESCRIBE-CHARACTER-ENCODINGS

+

4.3.4.3. DESCRIBE-CHARACTER-ENCODINGS

@@ -3642,5 +3681,5 @@
- +
Description:

Writes descriptions of all defined character encodings @@ -3651,5 +3690,5 @@

- +
See Also:
Section 4.3.4, “Character Encodings”, Section 4.3.2, “External Formats”, Section 4.3.4.4, “Supported Character Encodings” @@ -4082,5 +4121,5 @@
-

4.3.4.5. Encoding and Decoding Strings

+

4.3.4.5. Encoding and Decoding Strings

@@ -4107,5 +4146,5 @@
- +
Description:

@@ -4138,5 +4177,5 @@

- +
Description:

@@ -4181,5 +4220,5 @@

- +
Description:

@@ -4227,5 +4266,5 @@

- +
Description:

@@ -4277,5 +4316,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 @@ -4381,5 +4420,5 @@ platforms.

- + CCL:MAP-FILE-TO-IVECTOR pathname @@ -4441,5 +4480,5 @@ a memory error.

- + CCL:UNMAP-IVECTOR displaced-array @@ -4453,5 +4492,5 @@ target is an empty vector (of length zero).

- + CCL:MAP-FILE-TO-OCTET-VECTOR pathname @@ -4463,5 +4502,5 @@ bytes.

- + CCL:UNMAP-OCTET-VECTOR displaced-array @@ -4502,5 +4541,5 @@ static.

- + DEFSTATIC var @@ -4556,5 +4595,5 @@

- +

Clozure CL provides the function CCL:SAVE-APPLICATION, which creates a file @@ -4636,5 +4675,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.

@@ -4647,5 +4686,5 @@ or opencml64 script.

- + SAVE-APPLICATION filename @@ -4784,5 +4823,5 @@

- +
Arguments and Values:

mode--- @@ -4792,5 +4831,5 @@

- +
Description:

@@ -4831,5 +4870,5 @@

- +
Arguments and Values:

rounding-mode--- @@ -4840,5 +4879,5 @@

- +
Description:

@@ -4851,4 +4890,435 @@

+
+
+
+
+
+

4.9. Watched Objects

+
+
+
+

+ As of release 1.4, Clozure CL provides a way for lisp objects to + be watched so that a condition will be signaled when a thread + attempts to write to the watched object. For a certain class of + bugs (someone is changing this value, but I don't know who), this + can be extremely helpful. +

+
+
+
+
+

4.9.1. WATCH

+
+
+
+

+

+ + [Function] +

+ watch &optional object +
+
+ Monitor a lisp object for writes. +
+

+

+

+
+ +
Arguments and Values:
+

object--- + Any memory-allocated lisp object. +

+
+
+ +
Description:
+

+ The WATCH function arranges for the specified object to be + monitored for writes. This is accomplished by copying the + object to its own set of virtual memory pages, which are then + write-protected. This protection is enforced by the computer's + memory-management hardware; the write-protection does not slow + down reads at all. +

+

+ When any write to the object is attempted, a + WRITE-TO-WATCHED-OBJECT condition will be signaled. +

+

+ When called with no arguments, WATCH returns a freshly-consed + list of the objects currently being watched. +

+

+ WATCH returns NIL if the object cannot be watched (typically + because the object is in a static or pure memory area). +

+
+
+ +
DWIM:
+

+ WATCH operates at a fairly low level; it is not possible to + avoid the details of the internal representation of objects. + Nevertheless, as a convenience, WATCHing a standard-instance, + a hash-table, or a multi-dimensional or non-simple CL array + will watch the underlying slot-vector, hash-table-vector, or + data-vector, respectively. +

+
+
+ +
Discussion:
+

+ WATCH can monitor any memory-allocated lisp object. +

+

+ In Clozure CL, a memory-allocated object is either a cons cell + or a uvector. +

+

+ WATCH operates on cons cells, not lists. In order to watch a + chain of cons cells, each cons cell must be watched + individually. Because each watched cons cell takes up its own + own virtual memory page (4 Kbytes), it's only feasible to watch + relatively short lists. +

+

+ If a memory-allocated object isn't a cons cell, then it is a + vector-like object called a uvector. A uvector is a + memory-allocated lisp object whose first word is a header that + describes the object's type and the number of elements that it + contains. +

+

+ So, a hash table is a uvector, as is a string, a standard + instance, a double-float, a CL array or vector, and so forth. +

+

+ Some CL objects, like strings and other simple vectors, map in a + straightforward way onto the uvector representation. It is easy + to understand what happens in such cases. The uvector index + corresponds directly to the vector index: +

+ 
+
+? (defvar *s* "xxxxx")
+*S*
+? (watch *s*)
+"xxxxx"
+? (setf (char *s* 3) #\o)
+> Error: Write to watched uvector "xxxxx" at index 3
+>        Faulting instruction: (movl (% eax) (@ -5 (% r15) (% rcx)))
+> While executing: SET-CHAR, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+
+
+

+ In the case of more complicated objects (e.g., a hash-table, a + standard-instance, a package, etc.), the elements of the uvector + are like slots in a structure. It's necessary to know which one + of those "slots" contains the data that will be changed when the + object is written to. +

+

+ As mentioned above, watch knows about arrays, hash-tables, and + standard-instances, and will automatically watch the appropriate + data-containing element. +

+

+ An example might make this clearer. +

+ 
+
+? (defclass foo ()
+    (slot-a slot-b slot-c))
+#<STANDARD-CLASS FOO>
+? (defvar *a-foo* (make-instance 'foo))
+*A-FOO*
+? (watch *a-foo*)
+#<SLOT-VECTOR #xDB00D>
+;;; Note that WATCH has watched the internal slot-vector object
+? (setf (slot-value *a-foo* 'slot-a) 'foo)
+> Error: Write to watched uvector #<SLOT-VECTOR #xDB00D> at index 1
+>        Faulting instruction: (movq (% rsi) (@ -5 (% r8) (% rdi)))
+> While executing: %MAYBE-STD-SETF-SLOT-VALUE-USING-CLASS, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+
+
+

+ Looking at a backtrace would presumably show what object and + slot name were written. +

+

+ Note that even though the write was to slot-a, the uvector index + was 1 (not 0). This is because the first element of a + slot-vector is a pointer to the instance that owns the slots. We + can retrieve that to look at the object that was modified: +

+ 
+
+1 > (uvref (write-to-watched-object-object *break-condition*) 0)
+#<FOO #x30004113502D>
+1 > (describe *)
+#<FOO #x30004113502D>
+Class: #<STANDARD-CLASS FOO>
+Wrapper: #<CLASS-WRAPPER FOO #x300041135EBD>
+Instance slots
+SLOT-A: #<Unbound>
+SLOT-B: #<Unbound>
+SLOT-C: #<Unbound>
+1 >
+ 
+
+
+
+

+
+
+
+
+
+

4.9.2. UNWATCH

+
+
+
+

+

+ + [Function] +

+ unwatch object +
+
+ Stop monitoring a lisp object for writes. +
+

+

+

+
+ +
Description:
+

+ The UNWATCH function ensures that the specified object is in + normal, non-monitored memory. If the object is not currently + being watched, UNWATCH does nothing and returns NIL. Otherwise, + the newly unwatched object is returned. +

+
+
+

+
+
+
+
+
+

4.9.3. WRITE-TO-WATCHED-OBJECT

+
+
+
+

+

+ + [Condition] +

+ WRITE-TO-WATCHED-OBJECT +
+
+ Condition signaled when a write to a watched object is attempted. +
+

+

+

+
+ +
Discussion:
+

+ This condition is signaled when a watched object is written + to. There are three slots of interest: +

+

object--- + The actual object that was the destination of the write. +

+

offset--- + The byte offset from the tagged object pointer to the + address of the write. +

+

instruction--- + The disassembled machine instruction that attempted the write. +

+
+
+ +
Restarts:
+

+ A few restarts are provided: one will skip over the faulting + write instruction and proceed; another offers to unwatch the + object and continue. +

+

+ There is also an emulate restart. In some common cases, the + faulting write instruction can be emulated, enabling the write + to be performed without having to unwatch the object (and + therefore let other threads potentially write to it). If the + faulting instruction isn't recognized, the emulate restart will + not be offered. +

+
+
+

+
+
+
+
+
+

4.9.4. Notes

+
+
+
+

+ Although some care has been taken to minimize potential problems + arising from watching and unwatching objects from multiple + threads, there may well be subtle race conditions present that + could cause bad behavior. +

+

+ For example, suppose that a thread attempts to write to a watched + object. This causes the operating system to generate an + exception. The lisp kernel figures out what the exception is, and + calls back into lisp to signal the write-to-watched-object + condition and perhaps handle the error. +

+

+ Now, as soon lisp code starts running again (for the callback), + it's possible that some other thread could unwatch the very + watched object that caused the exception, perhaps before we even + have a chance to signal the condition, much less respond to it. +

+

+ Having the object unwatched out from underneath a handler may at + least confuse it, if not cause deeper trouble. Use caution with + unwatch. +

+
+
+
+
+
+

4.9.5. Examples

+
+
+
+

+ Here are a couple more examples in addition to the above examples + of watching a string and a standard-instance. +

+
+
+
+
+

4.9.5.1. Fancy arrays

+
+
+
+ 
+?  (defvar *f* (make-array '(2 3) :element-type 'double-float))
+*F*
+? (watch *f*)
+#(0.0D0 0.0D0 0.0D0 0.0D0 0.0D0 0.0D0)
+;;; Note that the above vector is the underlying data-vector for the array
+? (setf (aref *f* 1 2) pi)
+> Error: Write to watched uvector #<VECTOR 6 type DOUBLE-FLOAT, simple> at index 5
+>        Faulting instruction: (movq (% rax) (@ -5 (% r8) (% rdi)))
+> While executing: ASET, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+1 > 
+
+

+ In this case, uvector index in the report is the row-major index + of the element that was written to. +

+
+
+
+
+
+

4.9.5.2. Hash tables

+
+
+
+

+ Hash tables are surprisingly complicated. The representation of a + hash table includes an element called a hash-table-vector. The + keys and values of the elements are stored pairwise in this + vector. +

+

+ One problem with trying to monitor hash tables for writes is that + the underlying hash-table-vector is replaced with an entirely new + one when the hash table is rehashed. A previously-watched + hash-table-vector will not be the used by the hash table after + rehashing, and writes to the new vector will not be caught. +

+ 
+? (defvar *h* (make-hash-table))
+*H*
+? (setf (gethash 'noise *h*) 'feep)
+FEEP
+? (watch *h*)
+#<HASH-TABLE-VECTOR #xDD00D>
+;;; underlying hash-table-vector
+? (setf (gethash 'noise *h*) 'ding)
+> Error: Write to watched uvector #<HASH-TABLE-VECTOR #xDD00D> at index 35
+>        Faulting instruction: (lock)
+>          (cmpxchgq (% rsi) (@ (% r8) (% rdx)))
+> While executing: %STORE-NODE-CONDITIONAL, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+;;; see what value is being replaced...
+1 > (uvref (write-to-watched-object-object *break-condition*) 35)
+FEEP
+;;; backtrace shows useful context
+1 > :b
+*(1A109F8) : 0 (%STORE-NODE-CONDITIONAL ???) NIL
+ (1A10A50) : 1 (LOCK-FREE-PUTHASH NOISE #<HASH-TABLE :TEST EQL size 1/60 #x30004117D47D> DING) 653
+ (1A10AC8) : 2 (CALL-CHECK-REGS PUTHASH NOISE #<HASH-TABLE :TEST EQL size 1/60 #x30004117D47D> DING) 229
+ (1A10B00) : 3 (TOPLEVEL-EVAL (SETF (GETHASH # *H*) 'DING) NIL) 709
+ ...
+
+
+
+
+
+
+

4.9.5.3. Lists

+
+
+
+

+ As previously mentioned, WATCH only watches individual cons cells. +

+ 
+? (defun watch-list (list)
+    (maplist #'watch list))
+WATCH-LIST
+? (defvar *l* (list 1 2 3))
+*L*
+? (watch-list *l*)
+((1 2 3) (2 3) (3))
+? (setf (nth 2 *l*) 'foo)
+> Error: Write to the CAR of watched cons cell (3)
+>        Faulting instruction: (movq (% rsi) (@ 5 (% rdi)))
+> While executing: %SETNTH, in process listener(1).
+> Type :POP to abort, :R for a list of available restarts.
+> Type :? for other options.
+
+
+
@@ -5070,5 +5540,5 @@
-

5.4.2.1. Checking for Updates

+

5.4.2.1. Checking for Updates

@@ -5202,5 +5672,5 @@ the required subsystems, if necessary.

- + BUILD-APPLICATION &key (name "MyApplication") @@ -5502,5 +5972,5 @@

- 6.3.2. As of August 2003: + 6.3.2. As of August 2003:
@@ -5753,5 +6223,5 @@
-

6.3.2.  As of August 2003:

+

6.3.2.  As of August 2003:

@@ -6205,5 +6675,5 @@
- +
Values:

result---a list of all lisp processes (threads) @@ -6211,5 +6681,5 @@

- +
Description:

Returns a list of all lisp processes (threads) known @@ -6223,5 +6693,5 @@

- +
See Also:
@@ -6251,5 +6721,5 @@
- +
Arguments and Values:

name---a string, used to identify the process.

@@ -6290,5 +6760,5 @@
- +
Description:

Creates and returns a new lisp process (thread) with the @@ -6311,5 +6781,5 @@

- +
See Also:
process-preset, process-enable, process-run-function @@ -6330,5 +6800,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6340,5 +6810,5 @@
- +
Description:

Suspends process, preventing it from @@ -6362,10 +6832,10 @@

- +
See Also:
process-resume, process-suspend-count
- +
Notes:

process-suspend was previously called @@ -6393,5 +6863,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -6404,5 +6874,5 @@
- +
Description:

Undoes the effect of a previous call to @@ -6415,10 +6885,10 @@

- +
See Also:
process-suspend, process-suspend-count
- +
Notes:

@@ -6446,5 +6916,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -6456,5 +6926,5 @@
- +
Description:

An "outstanding" process-suspend call @@ -6471,5 +6941,5 @@

- +
See Also:
process-suspend, process-resume @@ -6492,5 +6962,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6503,5 +6973,5 @@
- +
Description:

Typically used to initialize a newly-created or newly-reset @@ -6517,5 +6987,5 @@

- +
See Also:
make-process, process-enable, process-run-function @@ -6538,5 +7008,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6547,5 +7017,5 @@
- +
Description:

Tries to begin the execution of process. @@ -6564,10 +7034,10 @@

- +
See Also:
make-process, process-preset, process-run-function
- +
Notes:

It would be nice to have more discussion of what it means @@ -6590,5 +7060,5 @@

- +
Arguments and Values:

name---a string, used to identify the process. @@ -6612,5 +7082,5 @@

- +
Description:

Creates a lisp process (thread) via @@ -6625,5 +7095,5 @@

- +
See Also:
make-process, process-preset, process-enable @@ -6646,5 +7116,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6659,5 +7129,5 @@
- +
Description:

Arranges for process @@ -6690,5 +7160,5 @@

- +
See Also:
@@ -6699,5 +7169,5 @@
- +
Notes:

It would probably be better for result @@ -6729,10 +7199,10 @@

- +
Value Type:

A lisp process (thread).

- +
Initial Value:

Bound separately in each process, to that process itself. @@ -6740,5 +7210,5 @@

- +
Description:

Used when lisp code needs to find out what process it is @@ -6746,5 +7216,5 @@

- +
See Also:
@@ -6770,5 +7240,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6777,5 +7247,5 @@
- +
Description:

Causes process to cleanly exit @@ -6804,5 +7274,5 @@

- +
See Also:
process-kill, process-abort @@ -6824,5 +7294,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6830,5 +7300,5 @@
- +
Description:

Entirely equivalent to calling @@ -6837,5 +7307,5 @@

- +
See Also:
process-reset, process-abort @@ -6859,5 +7329,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -6865,5 +7335,5 @@
- +
Description:

Entirely equivalent to calling @@ -6879,5 +7349,5 @@

- +
See Also:
process-reset, process-kill @@ -6898,10 +7368,10 @@
- +
Value Type:

A positive integer.

- +
Initial Value:

The clock resolution of the OS scheduler. Currently, @@ -6910,5 +7380,5 @@

- +
Description:

This value is ordinarily of marginal interest at best, @@ -6918,5 +7388,5 @@

- +
See Also:
@@ -6942,5 +7412,5 @@
- +
Description:

This information is primarily for the benefit of @@ -6956,10 +7426,10 @@

- +
See Also:
process-wait, process-wait-with-timeout, with-terminal-input
- +
Notes:

This should arguably be SETFable, but doesn't seem to @@ -6985,5 +7455,5 @@

- +
Description:

Advises the OS scheduler that the current thread has nothing @@ -6994,10 +7464,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

This is a holdover from the days of cooperative @@ -7022,5 +7492,5 @@

- +
Arguments and Values:

whostate---a string, which will be the value of @@ -7035,5 +7505,5 @@

- +
Description:

Causes the current lisp process (thread) to repeatedly @@ -7052,5 +7522,5 @@

- +
See Also:
process-whostate, process-wait-with-timeout, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7072,5 +7542,5 @@
- +
Arguments and Values:

whostate---a string, which will be the value of @@ -7090,5 +7560,5 @@

- +
Description:

If ticks is NIL, behaves exactly like @@ -7107,5 +7577,5 @@

- +
See Also:
*ticks-per-second*, process-whostate, process-wait, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7127,5 +7597,5 @@
- +
Arguments and Values:

body---an implicit progn.

@@ -7134,5 +7604,5 @@
- +
Description:

Executes body @@ -7149,5 +7619,5 @@

- +
See Also:
@@ -7173,5 +7643,5 @@
- +
Arguments and Values:

name---any lisp object; saved as part of @@ -7183,5 +7653,5 @@

- +
Description:

Creates and returns a lock object, which can @@ -7193,5 +7663,5 @@

- +
See Also:
with-lock-grabbed, grab-lock, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7213,5 +7683,5 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

@@ -7221,5 +7691,5 @@
- +
Description:

Waits until lock is either free or @@ -7232,5 +7702,5 @@

- +
See Also:
make-lock, grab-lock, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7251,10 +7721,10 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

- +
Description:

Blocks until lock is owned by the @@ -7267,5 +7737,5 @@

- +
See Also:
make-lock, with-lock-grabbed, release-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7285,10 +7755,10 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

- +
Description:

Signals an error of type CCL:LOCK-NOT-OWNER if @@ -7303,5 +7773,5 @@

- +
See Also:
make-lock, with-lock-grabbed, grab-lock, try-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7322,5 +7792,5 @@
- +
Arguments and Values:

lock---an object of type CCL:LOCK.

@@ -7329,5 +7799,5 @@
- +
Description:

Tests whether lock @@ -7342,5 +7812,5 @@

- +
See Also:
make-lock, with-lock-grabbed, grab-lock, release-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7362,5 +7832,5 @@
- +
Arguments and Values:

read-write-lock---a newly-allocated object of type @@ -7368,5 +7838,5 @@

- +
Description:

Creates and returns an object of type CCL::READ-WRITE-LOCK. @@ -7379,10 +7849,10 @@

- +
See Also:
with-read-lock, with-write-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

There probably should be some way to @@ -7407,5 +7877,5 @@

- +
Arguments and Values:

read-write-lock---an object of type @@ -7416,5 +7886,5 @@

- +
Description:

Waits until read-write-lock has no @@ -7430,5 +7900,5 @@

- +
See Also:
make-read-write-lock, with-write-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7450,5 +7920,5 @@
- +
Arguments and Values:

read-write-lock---an object of type @@ -7459,5 +7929,5 @@

- +
Description:

Waits until read-write-lock has no @@ -7474,5 +7944,5 @@

- +
See Also:
make-read-write-lock, with-read-lock, make-lock, make-semaphore, process-input-wait, process-output-wait, with-terminal-input @@ -7494,10 +7964,10 @@
- +
Arguments and Values:

semaphore---a newly-allocated object of type CCL:SEMAPHORE.

- +
Description:

Creates and returns an object of type CCL:SEMAPHORE. @@ -7508,5 +7978,5 @@

- +
See Also:
signal-semaphore, wait-on-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input @@ -7528,5 +7998,5 @@
- +
Arguments and Values:

semaphore---an object of type CCL:SEMAPHORE.

@@ -7535,5 +8005,5 @@
- +
Description:

Atomically increments semaphore's @@ -7542,10 +8012,10 @@

- +
See Also:
make-semaphore, wait-on-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

result should probably be interpreted @@ -7570,5 +8040,5 @@

- +
Arguments and Values:

semaphore---an object of type CCL:SEMAPHORE.

@@ -7577,5 +8047,5 @@
- +
Description:

Waits until semaphore @@ -7585,10 +8055,10 @@

- +
See Also:
make-semaphore, signal-semaphore, timed-wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input
- +
Notes:

result should probably be interpreted @@ -7614,5 +8084,5 @@

- +
Arguments and Values:

semaphore---An object of type CCL:SEMAPHORE.

@@ -7627,5 +8097,5 @@
- +
Description:

Waits until semaphore @@ -7636,5 +8106,5 @@

- +
See Also:
make-semaphore, wait-on-semaphore, make-lock, make-read-write-lock, process-input-wait, process-output-wait, with-terminal-input @@ -7656,5 +8126,5 @@
- +
Arguments and Values:

fd---a file descriptor, which is a non-negative integer @@ -7664,5 +8134,5 @@

- +
Description:

Wait until input is available on fd. @@ -7680,10 +8150,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-output-wait, with-terminal-input
- +
Notes:

@@ -7710,5 +8180,5 @@

- +
Arguments and Values:

fd---a file descriptor, which is a non-negative integer @@ -7718,5 +8188,5 @@

- +
Description:

Wait until output is possible on fd or until timeout, if @@ -7731,10 +8201,10 @@

- +
See Also:
make-lock, make-read-write-lock, make-semaphore, process-input-wait, with-terminal-input
- +
Notes:

@@ -7761,5 +8231,5 @@

- +
Arguments and Values:

body---an implicit progn.

@@ -7768,5 +8238,5 @@
- +
Description:

Requests exclusive read access to the standard terminal @@ -7776,5 +8246,5 @@

- +
See Also:
*request-terminal-input-via-break*, :y, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -7795,15 +8265,15 @@
- +
Value Type:

A boolean.

- +
Initial Value:

NIL.

- +
Description:

Controls how attempts to obtain ownership of terminal input @@ -7817,5 +8287,5 @@

- +
See Also:
with-terminal-input, :y, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -7836,5 +8306,5 @@
- +
Arguments and Values:

p---a lisp process (thread), designated either by @@ -7845,5 +8315,5 @@

- +
Description:

:Y is a toplevel command, not a function. As such, it @@ -7856,5 +8326,5 @@

- +
See Also:
with-terminal-input, *request-terminal-input-via-break*, make-lock, make-read-write-lock, make-semaphore, process-input-wait, process-output-wait @@ -7877,5 +8347,5 @@
- +
Arguments and Values:

process---a process, typically created by process-run-function or by make-process

@@ -7887,5 +8357,5 @@
- +
Description:

Waits for the specified process to terminate. If the @@ -8028,5 +8498,5 @@

- +
Arguments and Values:

address-family---The address/protocol family of this socket. Currently @@ -8127,5 +8597,5 @@

- +
Description:

Creates and returns a new socket

@@ -8146,5 +8616,5 @@
- +
Arguments and Values:

socket---The listener-socket to listen on.

@@ -8154,5 +8624,5 @@
- +
Description:

Extracts the first connection on the queue of pending @@ -8180,5 +8650,5 @@

- +
Arguments and Values:

dotted---A string representing an IP address in the @@ -8188,5 +8658,5 @@

- +
Description:

Converts a dotted-string representation of a host address to @@ -8208,5 +8678,5 @@

- +
Arguments and Values:

ipaddr---A 32-bit integer representing an internet host address

@@ -8217,5 +8687,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into octets.

@@ -8236,5 +8706,5 @@
- +
Arguments and Values:

ipaddr---a 32-bit integer representing an internet host address

@@ -8243,5 +8713,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into a host name @@ -8263,5 +8733,5 @@

- +
Arguments and Values:

host---Specifies the host. It can be either a host name @@ -8271,5 +8741,5 @@

- +
Description:

Converts a host spec in any of the acceptable formats into a @@ -8291,5 +8761,5 @@

- +
Arguments and Values:

port---Specifies the port. It can be either a string, such as @@ -8300,5 +8770,5 @@

- +
Description:

Finds the port number for the specified port and protocol

@@ -8320,5 +8790,5 @@
- +
Arguments and Values:

socket---The socket to read from

@@ -8337,5 +8807,5 @@
- +
Description:

Reads a UDP packet from a socket. If no packets are @@ -8374,5 +8844,5 @@

- +
Arguments and Values:

socket---The socket to write to

@@ -8390,5 +8860,5 @@
- +
Description:

Send a UDP packet over a socket.

@@ -8409,5 +8879,5 @@
- +
Arguments and Values:

socket---The socket to shut down (typically a tcp-stream)

@@ -8416,5 +8886,5 @@
- +
Description:

Shuts down part of a bidirectional connection. This is @@ -8437,10 +8907,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the native OS's representation of the socket, or @@ -8467,10 +8937,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the 32-bit unsigned IP address of the remote host, @@ -8492,10 +8962,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the remote port number, or NIL if the socket is not @@ -8517,10 +8987,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns 32-bit unsigned IP address of the local host.

@@ -8541,10 +9011,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the local port number

@@ -8565,10 +9035,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :internet or :file, as appropriate.

@@ -8589,10 +9059,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :active for tcp-stream, :passive for @@ -8614,10 +9084,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the socket format as specified by the :format @@ -8639,10 +9109,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

returns :stream for tcp-stream and listener-socket, and @@ -8663,10 +9133,10 @@

- +
Description:

The class of OS errors signaled by socket functions

- +
Superclasses:

simple-error

@@ -8687,10 +9157,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

The OS error code of the error

@@ -8711,10 +9181,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

A symbol representing the error code in a more @@ -8740,10 +9210,10 @@

- +
Arguments and Values:

socket-error---the condition

- +
Description:

A string describing the context where the error happened. On @@ -8766,5 +9236,5 @@

- +
Arguments and Values:

socket---The socket to close

@@ -8777,5 +9247,5 @@
- +
Description:

The close generic function can be applied to sockets. It @@ -8798,5 +9268,5 @@

- +
Arguments and Values:

var---variable to bind

@@ -8805,5 +9275,5 @@
- +
Description:

executes body with var bound to the result of applying @@ -8936,5 +9406,5 @@

- +
Arguments and Values:

program---A string or pathname which denotes an executable file. @@ -8982,5 +9452,5 @@

- +
Description:

Runs the specified program in an external (Unix) process, @@ -9002,5 +9472,5 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

@@ -9008,5 +9478,5 @@
- +
Description:

Sends the specified "signal" to the specified @@ -9031,10 +9501,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the process id assigned to @@ -9058,10 +9528,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the input argument to @@ -9084,10 +9554,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the output argument to @@ -9111,10 +9581,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns the stream created when the error argument to @@ -9138,10 +9608,10 @@

- +
Arguments and Values:

proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.

- +
Description:

Returns, as multiple values, a keyword denoting the status @@ -9173,5 +9643,5 @@

- 9.1.1. Stream External Encoding + 9.1.1. Stream External Encoding
@@ -9241,5 +9711,5 @@
-

9.1.1. Stream External Encoding

+

9.1.1. Stream External Encoding

@@ -9402,10 +9872,10 @@
- - - - - - + + + + + +

A stream that is associated with a file descriptor has attributes and accessors: @@ -9460,5 +9930,5 @@

- +
Values:

stream-list---A list of open file streams. This is a copy of @@ -9467,10 +9937,10 @@

- +
Description:

Returns a list of open file streams.

- +
See Also:
note-open-file-stream, remove-open-file-stream @@ -9495,10 +9965,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Adds a file stream to the internal list of open @@ -9509,5 +9979,5 @@

- +
See Also:
open-file-streams, remove-open-file-stream @@ -9532,10 +10002,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Remove file stream from the internal list of open file @@ -9546,5 +10016,5 @@

- +
See Also:
open-file-streams, note-open-file-stream @@ -9979,5 +10449,5 @@
- +
Arguments and Values:

stream---a stream, presumably a fundamental-input-stream.

@@ -9990,5 +10460,5 @@
- +
Description:

Should try to read up to count elements from stream into the @@ -10011,5 +10481,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-output-stream.

@@ -10022,5 +10492,5 @@
- +
Description:

should try to write the first count elements of list to @@ -10042,5 +10512,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-input-stream

@@ -10058,5 +10528,5 @@
- +
Description:

should try to read successive elements from stream into @@ -10081,5 +10551,5 @@

- +
Arguments and Values:

stream---a stream, presumably a fundamental-output-stream

@@ -10097,5 +10567,5 @@
- +
Description:

should try to write successive elements of vector to stream, @@ -10119,5 +10589,5 @@

- +
Method Signatures:
ccl::stream-device @@ -10125,5 +10595,5 @@
- +
Arguments and Values:

s---a stream.

@@ -10136,5 +10606,5 @@
- +
Description:

Returns the file descriptor associated with @@ -10160,5 +10630,5 @@

- +
Description:

Reads up to max-octets octets from stream into ivector, @@ -10167,5 +10637,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -10192,5 +10662,5 @@

- +
Description:

Writes max-octets octets to stream from ivector, starting at @@ -10198,5 +10668,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -10208,5 +10678,5 @@

- +
Examples:
@@ -11374,5 +11844,5 @@

- + CHUD:*SHARK-CONFIG-FILE* [Variable]

@@ -11380,5 +11850,5 @@ configuration file created by the "Config Editor" in Shark.app.

- + CHUD:METER form &key (reset nil) (debug-output nil) [Macro]

@@ -11642,5 +12112,5 @@
- 12.12. The Foreign-Function-Interface Dictionary + 12.12. The Foreign-Function-Interface Dictionary
@@ -12470,5 +12940,5 @@
-

12.3.2.4. %int-to-ptr [Function]

+

12.3.2.4. %int-to-ptr [Function]

@@ -12511,5 +12981,5 @@
-

12.3.2.5. %inc-ptr [Function]

+

12.3.2.5. %inc-ptr [Function]

@@ -12561,5 +13031,5 @@
-

12.3.2.6. %ptr-to-int [Function]

+

12.3.2.6. %ptr-to-int [Function]

@@ -12603,5 +13073,5 @@
-

12.3.2.7. %null-ptr [Macro]

+

12.3.2.7. %null-ptr [Macro]

@@ -12628,5 +13098,5 @@
-

12.3.2.8. %null-ptr-p [Function]

+

12.3.2.8. %null-ptr-p [Function]

@@ -12670,5 +13140,5 @@
-

12.3.2.9. %setf-macptr [Function]

+

12.3.2.9. %setf-macptr [Function]

@@ -12718,5 +13188,5 @@
-

12.3.2.10. %incf-ptr [Macro]

+

12.3.2.10. %incf-ptr [Macro]

@@ -12766,5 +13236,5 @@
-

12.3.2.11. with-macptrs [Macro]

+

12.3.2.11. with-macptrs [Macro]

@@ -12816,5 +13286,5 @@
-

12.3.2.12. %stack-block [Macro]

+

12.3.2.12. %stack-block [Macro]

@@ -12867,5 +13337,5 @@
-

12.3.2.13. make-cstring [Function]

+

12.3.2.13. make-cstring [Function]

@@ -12910,5 +13380,5 @@
-

12.3.2.14. with-cstrs [Macro]

+

12.3.2.14. with-cstrs [Macro]

@@ -12960,5 +13430,5 @@
-

12.3.2.15. with-encoded-cstrs [Macro]

+

12.3.2.15. with-encoded-cstrs [Macro]

@@ -13023,5 +13493,5 @@
-

12.3.2.16. %get-cstring [Function]

+

12.3.2.16. %get-cstring [Function]

@@ -13065,5 +13535,5 @@
-

12.3.2.17. %str-from-ptr [Function]

+

12.3.2.17. %str-from-ptr [Function]

@@ -14495,5 +14965,5 @@
-

12.12. The Foreign-Function-Interface Dictionary

+

12.12. The Foreign-Function-Interface Dictionary

@@ -14512,5 +14982,5 @@
- +
Description:

Reads a symbol from the current input stream, with *PACKAGE* @@ -14564,5 +15034,5 @@

- +
Description:

In CCL 1.2 and later, the #& reader macro can be used to @@ -14623,5 +15093,5 @@

- +
Description:

In CCL 0.14.2 and later, the #? reader macro can be used @@ -14670,5 +15140,5 @@

- +
Description:

In CCL 1.2 and later, the #/ reader macro can be used to @@ -14773,5 +15243,5 @@

- +
Description:

In CCL 1.2 and later, the #> reader macro reads @@ -14802,5 +15272,5 @@

- +
Values:

library---either an object of type SHLIB, or a string which @@ -14809,5 +15279,5 @@

- +
Description:

If completely is T, sets the @@ -14838,5 +15308,5 @@

- +
Values:

name---A symbol which can be made into a special variable

@@ -14855,5 +15325,5 @@
- +
Description:

Proclaims name @@ -14891,5 +15361,5 @@

- +
Values:

name---NIL or a keyword; the keyword may contain @@ -14899,5 +15369,5 @@

- +
Description:

If name is non-NIL, defines name to be an alias for the @@ -14933,5 +15403,5 @@

- +
Values:

name--- @@ -14946,5 +15416,5 @@

- +
Description:

If there is already an EXTERNAL-ENTRY-POINT for @@ -14974,5 +15444,5 @@

- +
Values:

name---A lisp string. See external, above.

@@ -14987,5 +15457,5 @@
- +
Description:

Calls the foreign function at the address obtained by @@ -15014,5 +15484,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -15025,5 +15495,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -15051,5 +15521,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -15064,5 +15534,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -15089,10 +15559,10 @@

- +
Values:

name---A lisp string.

- +
Description:

Tries to resolve the address of the foreign symbol @@ -15117,10 +15587,10 @@

- +
Values:

name---A lisp string.

- +
Description:

Tries to resolve the address of the foreign symbol name. If @@ -15144,5 +15614,5 @@

- +
Values:

ptr---A MACPTR that points to a block of @@ -15150,5 +15620,5 @@

- +
Description:

In CCL 1.2 and later, the CCL:FREE @@ -15182,5 +15652,5 @@

- +
Values:

element-count---A positive integer.

@@ -15197,5 +15667,5 @@
- +
Description:

@@ -15232,5 +15702,5 @@

- +
Values:

typespec---A foreign type specifier, or a keyword which is used @@ -15249,5 +15719,5 @@

- +
Description:

@@ -15298,5 +15768,5 @@

- +
Values:

typespec---A foreign type specifier, or a keyword which is used @@ -15312,5 +15782,5 @@

- +
Description:

@@ -15353,5 +15823,5 @@

- +
Notes:

@@ -15386,5 +15856,5 @@

- +
Values:

name---A SIMPLE-STRING which is presumed to be the so-name of @@ -15394,5 +15864,5 @@

- +
Description:

If the library denoted by name can @@ -15405,5 +15875,5 @@

- +
Examples:
;;; Try to do something simple.
@@ -15440,5 +15910,5 @@
- +
Notes:

It would be helpful to describe what an soname is and give @@ -15463,5 +15933,5 @@

- +
Values:

ptr---a MACPTR.

@@ -15471,5 +15941,5 @@
- +
Description:

References an instance of a foreign type (or a component of @@ -15497,5 +15967,5 @@

- +
Values:

eep---An EXTERNAL-ENTRY-POINT, as obtained by the EXTERNAL @@ -15503,5 +15973,5 @@

- +
Description:

Tries to resolve the address of the EXTERNAL-ENTRY-POINT @@ -15526,5 +15996,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -15534,5 +16004,5 @@
- +
Description:

Executes body @@ -15564,5 +16034,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -15571,5 +16041,5 @@
- +
Description:

Executes body in an environment in which each var is @@ -15598,5 +16068,5 @@

- +
Values:

object---A CLOS object of a class for which there exists @@ -15606,5 +16076,5 @@

- +
Description:

@@ -15643,5 +16113,5 @@

- +
Example:
@@ -15657,5 +16127,5 @@
- +
See Also:
@@ -15679,5 +16149,5 @@
- +
Values:

dir-id---A keyword whose pname, mapped to lower case, names a @@ -15686,5 +16156,5 @@

- +
Description:

Tells CCL to remove the interface directory denoted by @@ -15710,5 +16180,5 @@

- +
Values:

dir-id---A keyword whose pname, mapped to lower case, names a @@ -15717,5 +16187,5 @@

- +
Description:

Tells CCL to add the interface directory denoted by @@ -15739,5 +16209,5 @@

- +
Examples:

One typically wants interface information to be @@ -15842,10 +16312,10 @@

- 13.6.1. Using define-objc-method + 13.6.1. Using define-objc-method
- 13.6.2. Using objc:defmethod + 13.6.2. Using objc:defmethod
@@ -16453,5 +16923,5 @@
-

13.6.1. Using define-objc-method

+

13.6.1. Using define-objc-method

@@ -16570,5 +17040,5 @@
-

13.6.2. Using objc:defmethod

+

13.6.2. Using objc:defmethod

@@ -17394,5 +17864,5 @@
- +
Arguments and Values:

name---a string which is the name of an existing @@ -17404,5 +17874,5 @@

- +
Description:

@@ -17425,5 +17895,5 @@

- +
Arguments and Values:

name---a string which is the name of a new or existing @@ -17438,5 +17908,5 @@

- +
Description:

@@ -17462,5 +17932,5 @@

- +
Values:

path---a string, an absolute pathname in Posix format - with @@ -17468,5 +17938,5 @@

- +
Description:

@@ -17490,5 +17960,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -17496,5 +17966,5 @@

- +
Description:

@@ -17516,5 +17986,5 @@

- +
Arguments and Values:

uid---a non-negative integer, identifying a specific user @@ -17525,5 +17995,5 @@

- +
Description:

@@ -17548,5 +18018,5 @@

- +
Arguments and Values:

gid---a non-negative integer, identifying a specific @@ -17557,5 +18027,5 @@

- +
Description:

@@ -17580,10 +18050,10 @@

- +
Values:

pid---a non-negative integer, identifying an OS process

- +
Description:

@@ -17606,5 +18076,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -17614,5 +18084,5 @@

- +
Description:

@@ -17639,5 +18109,5 @@

- +
Values:

command-line---a string, obeying all the whitespace and @@ -17648,5 +18118,5 @@

- +
Description:

@@ -17664,5 +18134,5 @@

- +
Notes:

@@ -17689,5 +18159,5 @@

- +
Arguments and Values:

class-name---a string which denotes an existing class name, or a @@ -17696,5 +18166,5 @@

- +
Description:

Used to refer to a known ObjC class by name. (Via the use @@ -17721,5 +18191,5 @@

- +
Arguments and Values:

string---a string constant, used to canonically refer to an @@ -17727,5 +18197,5 @@

- +
Description:

Used to refer to an ObjC method selector (method name). Uses @@ -17749,5 +18219,5 @@

- +
Arguments and Values:

name-and-result-type---either an Objective-C message name, for methods @@ -17771,5 +18241,5 @@

- +
Description:

Defines an Objective-C-callable method which implements @@ -17796,5 +18266,5 @@

- +
Arguments and Values:

selector---either a string which represents the name of the @@ -17811,5 +18281,5 @@

- +
Description:

Defines an ObjC-callable method which implements the @@ -17832,10 +18302,10 @@

- +
Arguments and Values:

As per DEFINE-OBJC-METHOD

- +
Description:

Like DEFINE-OBJC-METHOD, only used to define methods on the @@ -17879,5 +18349,5 @@

- +
Description:

This variable is currently only used by the standard reader macro @@ -17914,5 +18384,5 @@

- +
Description:

Per ANSI CL, Clozure CL supports the :EXTERNAL-FORMAT keyword @@ -17958,5 +18428,5 @@

- +
Description:

The value of this variable is used when :EXTERNAL-FORMAT is @@ -17982,10 +18452,10 @@

- +
Superclasses:

NS:NS-STRING

- +
Initargs:

:string--- @@ -17995,5 +18465,5 @@

- +
Description:

@@ -18013,5 +18483,5 @@

- +
Examples:

@@ -18044,5 +18514,5 @@

- +
Notes:

@@ -18384,5 +18854,5 @@

- +
Arguments and Values:

type---The type of population, one of :LIST (the default) or :ALIST

@@ -18392,5 +18862,5 @@
- +
Description:

Creates a new population of the specified type.

@@ -18410,5 +18880,5 @@
- +
Description:

returns the type of population, one of :LIST or :ALIST

@@ -18428,5 +18898,5 @@
- +
Description:

returns the list encapsulated in population. @@ -18451,5 +18921,5 @@

- +
Description:

Sets the list encapsulated in population to @@ -18484,5 +18954,5 @@

- +
Description:

Returns the value of the kernel variable that specifies the @@ -18505,10 +18975,10 @@

- +
Arguments and Values:

new-threshold---The requested new lisp-heap-gc-threshold.

- +
Description:

Sets the value of the kernel variable that specifies the @@ -18534,5 +19004,5 @@

- +
Description:

Tries to grow or shrink lisp's heap space, so that the @@ -18554,10 +19024,10 @@

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Enables the EGC if arg is non-nil, disables the EGC @@ -18585,5 +19055,5 @@

- +
Description:

Returns T if the EGC was enabled at the time of the call, @@ -18608,5 +19078,5 @@

- +
Description:

Returns T if the EGC was active at the time of the call, NIL @@ -18633,5 +19103,5 @@

- +
Description:

Returns, as multiple values, the sizes in kilobytes of the @@ -18655,5 +19125,5 @@

- +
Arguments and Values:

generation-0-size---the requested threshold size of the youngest @@ -18665,5 +19135,5 @@

- +
Description:

Puts the indicated threshold sizes in effect. @@ -18689,10 +19159,10 @@

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Tries to influence the GC to retain/recycle the pages @@ -18719,5 +19189,5 @@

- +
Description:

Returns T if the GC tries to retain pages between full GCs @@ -18874,5 +19344,5 @@

- 16.7.2. Recommended Reading + 16.7.2. Recommended Reading
@@ -20150,5 +20620,5 @@

  • To support a feature called GCTWA - [1] + [1] , the vector that contains the internal symbols of the current package is marked on entry to the @@ -20283,5 +20753,5 @@

    -

    [1] I believe that the acronym comes from MACLISP, +

    [1] I believe that the acronym comes from MACLISP, where it stood for "Garbage Collection of Truly Worthless Atoms".

    @@ -20343,5 +20813,5 @@ generations looking for such intergenerational references, the runtime system must note all such intergenerational references - at the point where they're created (via Setf).[2] The + at the point where they're created (via Setf).[2] The set of pointers that may contain intergenerational references is sometimes called the remembered set.

    @@ -20390,5 +20860,5 @@ that might introduce an intergenerational reference must be memoized. - [3] It's always safe to + [3] It's always safe to push any cons cell or gvector locative onto the memo stack; it's never safe to push anything else. @@ -20411,5 +20881,5 @@
    -

    [2] This is +

    [2] This is sometimes called "The Write Barrier": all assignments which might result in intergenerational references must be noted, as @@ -20417,5 +20887,5 @@

    -

    [3] Note that the implicit setfs that occur when +

    [3] Note that the implicit setfs that occur when initializing an object - as in the case of a call to cons or vector - can't introduce intergenerational references, since @@ -20533,5 +21003,5 @@

    -

    16.7.2. Recommended Reading

    +

    16.7.2. Recommended Reading

    @@ -20946,5 +21416,5 @@
    - +
    Description:

    When true, attempts to redefine (via DEFUN or DEFMETHOD) @@ -20971,5 +21441,5 @@

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -20995,5 +21465,5 @@

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -21018,5 +21488,5 @@

    - +
    Description:

    This variable is initialized each time an Clozure CL session @@ -21043,5 +21513,5 @@

    - +
    Description:

    Returns non-NIL if AltiVec is available.

    @@ -21061,5 +21531,5 @@
    - +
    Description:

    Intended to control the expansion of certain lap macros. @@ -21083,5 +21553,5 @@

    - +
    Arguments and Values:

    reglist---A list of vector register names (vr0 .. vr31).

    @@ -21089,5 +21559,5 @@
    - +
    Description:

    Specifies the set of AltiVec registers used in body. If @@ -21115,5 +21585,5 @@

    - +
    Arguments and Values:

    base---Any available general-purpose register.

    @@ -21124,5 +21594,5 @@
    - +
    Description:

    Generates code which allocates a 16-byte aligned buffer @@ -21749,4 +22219,5 @@

    unuse-interface-dir, Function UNUSE-INTERFACE-DIR
    +
    unwatch, Function UNWATCH
    use-interface-dir, Function USE-INTERFACE-DIR
    use-lisp-heap-gc-threshold, Function USE-LISP-HEAP-GC-THRESHOLD
    @@ -21757,4 +22228,5 @@
    wait-on-semaphore, Function WAIT-ON-SEMAPHORE
    +
    watch, Function WATCH
    with-altivec-registers, LAP Macro WITH-ALTIVEC-REGISTERS
    with-lock-grabbed, Macro WITH-LOCK-GRABBED
    @@ -21765,4 +22237,5 @@
    with-write-lock, Macro WITH-WRITE-LOCK
    without-interrupts, Macro WITHOUT-INTERRUPTS
    +
    write-to-watched-object, Condition WRITE-TO-WATCHED-OBJECT
    @@ -21773,5 +22246,5 @@ Symbol Index
    -

    This document was last modified at 21:0 on October 20, 2009, in UTC.

    It uses version 1.72.0 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 13059

    Using libxml 20629, libxslt 10121 and libexslt 813.

    +

    This document was last modified at 17:0 on October 27, 2009, in UTC.

    It uses version 1.72.0 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 13104

    Using libxml 20629, libxslt 10121 and libexslt 813.