Index: /trunk/source/doc/ccl-documentation.html =================================================================== --- /trunk/source/doc/ccl-documentation.html (revision 14474) +++ /trunk/source/doc/ccl-documentation.html (revision 14475) @@ -6,5 +6,5 @@ Clozure CL Documentation - + @@ -14,5 +14,5 @@
-

Clozure CL Documentation

+

Clozure CL Documentation

@@ -1745,5 +1745,5 @@

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 compile-file. fasl files store the @@ -1756,5 +1756,5 @@ see Table 3.1, “Platform-specific filename conventions”

-

The Lisp +

The Lisp kernel is a C program with a fair amount of platform-specific assembly language code. Its basic job is to @@ -1766,5 +1766,5 @@ 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's address space. Conceptually, it's not too different @@ -1777,5 +1777,5 @@ standard full heap image files on different platforms; see Table 3.1, “Platform-specific filename conventions”.

-

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 @@ -1789,5 +1789,5 @@ as-yet-unsupported ones) has a uniquely named subdirectory of 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 @@ -2606,5 +2606,5 @@

- + TRACE {keyword global-value}* {spec | @@ -3050,15 +3050,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]

@@ -3068,5 +3068,5 @@

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

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

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

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

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

@@ -3133,5 +3133,5 @@
- +
Arguments and Values:

spec--- @@ -3168,5 +3168,5 @@

- +
Examples:

@@ -3213,5 +3213,5 @@

- +
Description:

@@ -3228,5 +3228,5 @@

- +
Arguments and Values:

@@ -3252,5 +3252,5 @@

- +
Description:

@@ -3264,5 +3264,5 @@

- +
Arguments and Values:

@@ -3431,5 +3431,5 @@

- +
Arguments and Values:

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

- +
Description:

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

-

4.5.4.1. Encoding Problems

+

4.5.4.1. Encoding Problems

@@ -3649,5 +3649,5 @@
-

4.5.4.2. Byte Order Marks

+

4.5.4.2. Byte Order Marks

@@ -3677,5 +3677,5 @@
-

4.5.4.3. DESCRIBE-CHARACTER-ENCODINGS

+

4.5.4.3. DESCRIBE-CHARACTER-ENCODINGS

@@ -3699,5 +3699,5 @@
- +
Description:

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

- +
See Also:
Section 4.5.4, “Character Encodings”, Section 4.5.2, “External Formats”, Section 4.5.4.4, “Supported Character Encodings” @@ -4139,5 +4139,5 @@
-

4.5.4.5. Encoding and Decoding Strings

+

4.5.4.5. Encoding and Decoding Strings

@@ -4164,5 +4164,5 @@
- +
Description:

@@ -4195,5 +4195,5 @@

- +
Description:

@@ -4238,5 +4238,5 @@

- +
Description:

@@ -4284,5 +4284,5 @@

- +
Description:

@@ -4334,5 +4334,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 @@ -4438,5 +4438,5 @@ platforms.

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

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

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

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

- + DEFSTATIC var @@ -4613,5 +4613,5 @@

- +

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

@@ -4704,5 +4704,5 @@ or opencml64 script.

- + SAVE-APPLICATION filename @@ -4828,5 +4828,5 @@

- +
Arguments and Values:

out-file--- @@ -4842,5 +4842,5 @@

- +
Description:

@@ -4902,5 +4902,5 @@

- +
Arguments and Values:

mode--- @@ -4910,5 +4910,5 @@

- +
Description:

@@ -4949,5 +4949,5 @@

- +
Arguments and Values:

rounding-mode--- @@ -4958,5 +4958,5 @@

- +
Description:

@@ -5007,5 +5007,5 @@

- +
Arguments and Values:

object--- @@ -5014,5 +5014,5 @@

- +
Description:

@@ -5181,5 +5181,5 @@

- +
Description:

@@ -5215,5 +5215,5 @@

- +
Discussion:

@@ -5233,5 +5233,5 @@

- +
Restarts:

@@ -5301,5 +5301,5 @@

-

4.12.5.1. Fancy arrays

+

4.12.5.1. Fancy arrays

@@ -5328,5 +5328,5 @@
-

4.12.5.2. Hash tables

+

4.12.5.2. Hash tables

@@ -5376,5 +5376,5 @@
-

4.12.5.3. Lists

+

4.12.5.3. Lists

@@ -5545,5 +5545,5 @@
- +
Arguments and Values:

html--- @@ -5567,5 +5567,5 @@

- +
Example:

@@ -5601,5 +5601,5 @@

- +
Summary:

@@ -5623,5 +5623,5 @@

- +
Summary:

@@ -5649,5 +5649,5 @@

- +
Summary:

@@ -5675,5 +5675,5 @@

- +
Summary:

@@ -5706,5 +5706,5 @@

- +
Summary:

@@ -5733,5 +5733,5 @@

- +
Summary:

@@ -5756,5 +5756,5 @@

- +
Summary:

@@ -5783,5 +5783,5 @@

- +
Summary:

@@ -5810,5 +5810,5 @@

- +
Summary:

@@ -5977,5 +5977,5 @@

- +
Summary:

@@ -6002,5 +6002,5 @@

- +
Summary:

@@ -6038,5 +6038,5 @@

- +
Summary:

@@ -6073,5 +6073,5 @@

- +
Summary:

@@ -6307,5 +6307,5 @@

-

5.4.2.1. Checking for Updates

+

5.4.2.1. Checking for Updates

@@ -6439,5 +6439,5 @@ the required subsystems, if necessary.

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

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

6.3.2.  As of August 2003:

+

6.3.2.  As of August 2003:

@@ -7005,5 +7005,5 @@

It has traditionally been possible to reset and enable a process that's "exhausted" . (As used here, the - term"exhausted" means that the process's initial function + term "exhausted" means that the process's initial function has run and returned and the underlying native thread has been deallocated.) One of the principal uses of PROCESS-RESET @@ -7442,5 +7442,5 @@

- +
Values:

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

- +
Description:

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

- +
See Also:
@@ -7488,5 +7488,5 @@
- +
Arguments and Values:

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

@@ -7527,5 +7527,5 @@
- +
Description:

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

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

process---a lisp process (thread).

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

Suspends process, preventing it from @@ -7599,10 +7599,10 @@

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

process-suspend was previously called @@ -7630,5 +7630,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -7641,5 +7641,5 @@
- +
Description:

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

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

@@ -7683,5 +7683,5 @@

- +
Arguments and Values:

process---a lisp process (thread).

@@ -7693,5 +7693,5 @@
- +
Description:

An "outstanding" process-suspend call @@ -7708,5 +7708,5 @@

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

process---a lisp process (thread).

@@ -7740,5 +7740,5 @@
- +
Description:

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

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

process---a lisp process (thread).

@@ -7784,5 +7784,5 @@
- +
Description:

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

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

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

- +
Arguments and Values:

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

- +
Description:

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

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

process---a lisp process (thread).

@@ -7896,5 +7896,5 @@
- +
Description:

Arranges for process @@ -7927,5 +7927,5 @@

- +
See Also:
@@ -7936,5 +7936,5 @@
- +
Notes:

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

- +
Value Type:

A lisp process (thread).

- +
Initial Value:

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

- +
Description:

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

- +
See Also:
@@ -8007,5 +8007,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -8014,5 +8014,5 @@
- +
Description:

Causes process to cleanly exit @@ -8041,7 +8041,42 @@

- +
See Also:
process-kill, process-abort +
+
+

+

+

+ + [Function] +

+ process-reset-and-enable + process => result +
+
Reset and enable the specified process, which + may not be the current process.
+

+

+

+
+ +
Arguments and Values:
+

process---a lisp process (thread), which + may not be the current process.

+

result---undefined.

+
+
+ +
Description:
+

+ Equivalent to calling (process-reset process) and + (process-enable process). +

+
+
+ +
See Also:
+ process-reset, process-enable
@@ -8061,5 +8096,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -8067,12 +8102,13 @@
- +
Description:
-

Entirely equivalent to calling - (PROCESS-RESET PROCESS T). Causes process - to cleanly exit from any ongoing computation, and then exit.

-
-
- +

+ Causes process to cleanly exit + from any ongoing computation, and then exit. +

+
+
+
See Also:
process-reset, process-abort @@ -8096,5 +8132,5 @@
- +
Arguments and Values:

process---a lisp process (thread).

@@ -8102,5 +8138,5 @@
- +
Description:

Entirely equivalent to calling @@ -8116,5 +8152,5 @@

- +
See Also:
process-reset, process-kill @@ -8135,10 +8171,10 @@
- +
Value Type:

A positive integer.

- +
Initial Value:

The clock resolution of the OS scheduler. Currently, @@ -8147,5 +8183,5 @@

- +
Description:

This value is ordinarily of marginal interest at best, @@ -8155,5 +8191,5 @@

- +
See Also:
@@ -8179,5 +8215,5 @@
- +
Description:

This information is primarily for the benefit of @@ -8193,10 +8229,10 @@

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

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

- +
Description:

Advises the OS scheduler that the current thread has nothing @@ -8231,10 +8267,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 @@ -8259,5 +8295,5 @@

- +
Arguments and Values:

whostate---a string, which will be the value of @@ -8272,5 +8308,5 @@

- +
Description:

Causes the current lisp process (thread) to repeatedly @@ -8289,5 +8325,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 @@ -8309,5 +8345,5 @@
- +
Arguments and Values:

whostate---a string, which will be the value of @@ -8327,5 +8363,5 @@

- +
Description:

If ticks is NIL, behaves exactly like @@ -8344,5 +8380,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 @@ -8364,5 +8400,5 @@
- +
Arguments and Values:

body---an implicit progn.

@@ -8371,5 +8407,5 @@
- +
Description:

Executes body @@ -8386,5 +8422,5 @@

- +
See Also:
@@ -8410,5 +8446,5 @@
- +
Arguments and Values:

name---any lisp object; saved as part of @@ -8420,5 +8456,5 @@

- +
Description:

Creates and returns a lock object, which can @@ -8430,5 +8466,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 @@ -8450,5 +8486,5 @@
- +
Arguments and Values:

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

@@ -8458,5 +8494,5 @@
- +
Description:

Waits until lock is either free or @@ -8469,5 +8505,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 @@ -8488,10 +8524,10 @@
- +
Arguments and Values:

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

- +
Description:

Blocks until lock is owned by the @@ -8504,5 +8540,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 @@ -8522,10 +8558,10 @@
- +
Arguments and Values:

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

- +
Description:

Signals an error of type CCL:LOCK-NOT-OWNER if @@ -8540,5 +8576,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 @@ -8559,5 +8595,5 @@
- +
Arguments and Values:

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

@@ -8566,5 +8602,5 @@
- +
Description:

Tests whether lock @@ -8579,5 +8615,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 @@ -8599,5 +8635,5 @@
- +
Arguments and Values:

read-write-lock---a newly-allocated object of type @@ -8605,5 +8641,5 @@

- +
Description:

Creates and returns an object of type CCL::READ-WRITE-LOCK. @@ -8616,10 +8652,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 @@ -8644,5 +8680,5 @@

- +
Arguments and Values:

read-write-lock---an object of type @@ -8653,5 +8689,5 @@

- +
Description:

Waits until read-write-lock has no @@ -8667,5 +8703,5 @@

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

read-write-lock---an object of type @@ -8696,5 +8732,5 @@

- +
Description:

Waits until read-write-lock has no @@ -8711,5 +8747,5 @@

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

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

- +
Description:

Creates and returns an object of type CCL:SEMAPHORE. @@ -8745,5 +8781,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 @@ -8765,5 +8801,5 @@
- +
Arguments and Values:

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

@@ -8772,5 +8808,5 @@
- +
Description:

Atomically increments semaphore's @@ -8779,10 +8815,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 @@ -8807,5 +8843,5 @@

- +
Arguments and Values:

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

@@ -8814,5 +8850,5 @@
- +
Description:

Waits until semaphore @@ -8822,10 +8858,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 @@ -8851,5 +8887,5 @@

- +
Arguments and Values:

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

@@ -8864,5 +8900,5 @@
- +
Description:

Waits until semaphore @@ -8873,5 +8909,5 @@

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

fd---a file descriptor, which is a non-negative integer @@ -8901,5 +8937,5 @@

- +
Description:

Wait until input is available on fd. @@ -8917,10 +8953,10 @@

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

@@ -8947,5 +8983,5 @@

- +
Arguments and Values:

fd---a file descriptor, which is a non-negative integer @@ -8955,5 +8991,5 @@

- +
Description:

Wait until output is possible on fd or until timeout, if @@ -8968,10 +9004,10 @@

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

@@ -8998,5 +9034,5 @@

- +
Arguments and Values:

body---an implicit progn.

@@ -9005,5 +9041,5 @@
- +
Description:

Requests exclusive read access to the standard terminal @@ -9013,5 +9049,5 @@

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

A boolean.

- +
Initial Value:

NIL.

- +
Description:

Controls how attempts to obtain ownership of terminal input @@ -9054,5 +9090,5 @@

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

p---a lisp process (thread), designated either by @@ -9082,5 +9118,5 @@

- +
Description:

:Y is a toplevel command, not a function. As such, it @@ -9093,5 +9129,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 @@ -9114,5 +9150,5 @@
- +
Arguments and Values:

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

@@ -9124,5 +9160,5 @@
- +
Description:

Waits for the specified process to terminate. If the @@ -9265,5 +9301,5 @@

- +
Arguments and Values:

address-family---The address/protocol family of this socket. Currently @@ -9365,5 +9401,5 @@

- +
Description:

Creates and returns a new socket

@@ -9384,5 +9420,5 @@
- +
Arguments and Values:

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

@@ -9392,5 +9428,5 @@
- +
Description:

Extracts the first connection on the queue of pending @@ -9418,5 +9454,5 @@

- +
Arguments and Values:

dotted---A string representing an IP address in the @@ -9426,5 +9462,5 @@

- +
Description:

Converts a dotted-string representation of a host address to @@ -9446,5 +9482,5 @@

- +
Arguments and Values:

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

@@ -9455,5 +9491,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into octets.

@@ -9474,5 +9510,5 @@
- +
Arguments and Values:

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

@@ -9481,5 +9517,5 @@
- +
Description:

Converts a 32-bit unsigned IP address into a host name @@ -9501,5 +9537,5 @@

- +
Arguments and Values:

host---Specifies the host. It can be either a host name @@ -9509,5 +9545,5 @@

- +
Description:

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

- +
Arguments and Values:

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

- +
Description:

Finds the port number for the specified port and protocol

@@ -9558,5 +9594,5 @@
- +
Arguments and Values:

socket---The socket to read from

@@ -9575,5 +9611,5 @@
- +
Description:

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

- +
Arguments and Values:

socket---The socket to write to

@@ -9627,5 +9663,5 @@
- +
Description:

Send a UDP packet over a socket.

@@ -9646,5 +9682,5 @@
- +
Arguments and Values:

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

@@ -9653,5 +9689,5 @@
- +
Description:

Shuts down part of a bidirectional connection. This is @@ -9674,10 +9710,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the native OS's representation of the socket, or @@ -9704,10 +9740,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the 32-bit unsigned IP address of the remote host, @@ -9729,10 +9765,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

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

- +
Arguments and Values:

socket---The socket

- +
Description:

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

@@ -9778,10 +9814,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the local port number

@@ -9802,10 +9838,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :internet or :file, as appropriate.

@@ -9826,10 +9862,10 @@
- +
Arguments and Values:

socket---The socket

- +
Description:

Returns :active for tcp-stream, :passive for @@ -9851,10 +9887,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

Returns the socket format as specified by the :format @@ -9876,10 +9912,10 @@

- +
Arguments and Values:

socket---The socket

- +
Description:

returns :stream for tcp-stream and listener-socket, and @@ -9900,10 +9936,10 @@

- +
Description:

The class of OS errors signaled by socket functions

- +
Superclasses:

simple-error

@@ -9924,10 +9960,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

The OS error code of the error

@@ -9948,10 +9984,10 @@
- +
Arguments and Values:

socket-error---the condition

- +
Description:

A symbol representing the error code in a more @@ -9977,10 +10013,10 @@

- +
Arguments and Values:

socket-error---the condition

- +
Description:

A string describing the context where the error happened. On @@ -10003,5 +10039,5 @@

- +
Arguments and Values:

socket---The socket to close

@@ -10014,5 +10050,5 @@
- +
Description:

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

- +
Arguments and Values:

var---variable to bind

@@ -10042,5 +10078,5 @@
- +
Description:

executes body with var bound to the result of applying @@ -10174,5 +10210,5 @@

- +
Arguments and Values:

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

- +
Description:

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

- +
Arguments and Values:

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

@@ -10251,5 +10287,5 @@
- +
Description:

Sends the specified "signal" to the specified @@ -10274,10 +10310,10 @@

- +
Arguments and Values:

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

- +
Description:

Returns the process id assigned to @@ -10301,10 +10337,10 @@

- +
Arguments and Values:

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

- +
Description:

Returns the stream created when the input argument to @@ -10327,10 +10363,10 @@

- +
Arguments and Values:

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

- +
Description:

Returns the stream created when the output argument to @@ -10354,10 +10390,10 @@

- +
Arguments and Values:

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

- +
Description:

Returns the stream created when the error argument to @@ -10381,10 +10417,10 @@

- +
Arguments and Values:

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

- +
Description:

Returns, as multiple values, a keyword denoting the status @@ -10416,5 +10452,5 @@

- 9.1.1. Stream External Format + 9.1.1. Stream External Format
@@ -10484,5 +10520,5 @@
-

9.1.1. Stream External Format

+

9.1.1. Stream External Format

@@ -10647,10 +10683,10 @@
- - - - - - + + + + + +

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

- +
Values:

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

- +
Description:

Returns a list of open file streams.

- +
See Also:
note-open-file-stream, remove-open-file-stream @@ -10740,10 +10776,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Adds a file stream to the internal list of open @@ -10754,5 +10790,5 @@

- +
See Also:
open-file-streams, remove-open-file-stream @@ -10777,10 +10813,10 @@
- +
Arguments:

file-stream---A file stream.

- +
Description:

Remove file stream from the internal list of open file @@ -10791,5 +10827,5 @@

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

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

@@ -11235,5 +11271,5 @@
- +
Description:

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

- +
Arguments and Values:

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

@@ -11267,5 +11303,5 @@
- +
Description:

should try to write the first count elements of list to @@ -11287,5 +11323,5 @@

- +
Arguments and Values:

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

@@ -11303,5 +11339,5 @@
- +
Description:

should try to read successive elements from stream into @@ -11326,5 +11362,5 @@

- +
Arguments and Values:

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

@@ -11342,5 +11378,5 @@
- +
Description:

should try to write successive elements of vector to stream, @@ -11364,5 +11400,5 @@

- +
Method Signatures:
ccl::stream-device @@ -11370,5 +11406,5 @@
- +
Arguments and Values:

s---a stream.

@@ -11381,5 +11417,5 @@
- +
Description:

Returns the file descriptor associated with @@ -11405,5 +11441,5 @@

- +
Description:

Reads up to max-octets octets from stream into ivector, @@ -11412,5 +11448,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -11437,5 +11473,5 @@

- +
Description:

Writes max-octets octets to stream from ivector, starting at @@ -11443,5 +11479,5 @@

- +
Arguments:

stream---An input stream. The method defined on @@ -11453,5 +11489,5 @@

- +
Examples:
@@ -12619,5 +12655,5 @@

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

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

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

@@ -13715,5 +13751,5 @@
-

12.3.2.4. %int-to-ptr [Function]

+

12.3.2.4. %int-to-ptr [Function]

@@ -13756,5 +13792,5 @@
-

12.3.2.5. %inc-ptr [Function]

+

12.3.2.5. %inc-ptr [Function]

@@ -13806,5 +13842,5 @@
-

12.3.2.6. %ptr-to-int [Function]

+

12.3.2.6. %ptr-to-int [Function]

@@ -13848,5 +13884,5 @@
-

12.3.2.7. %null-ptr [Macro]

+

12.3.2.7. %null-ptr [Macro]

@@ -13873,5 +13909,5 @@
-

12.3.2.8. %null-ptr-p [Function]

+

12.3.2.8. %null-ptr-p [Function]

@@ -13915,5 +13951,5 @@
-

12.3.2.9. %setf-macptr [Function]

+

12.3.2.9. %setf-macptr [Function]

@@ -13963,5 +13999,5 @@
-

12.3.2.10. %incf-ptr [Macro]

+

12.3.2.10. %incf-ptr [Macro]

@@ -14011,5 +14047,5 @@
-

12.3.2.11. with-macptrs [Macro]

+

12.3.2.11. with-macptrs [Macro]

@@ -14061,5 +14097,5 @@
-

12.3.2.12. %stack-block [Macro]

+

12.3.2.12. %stack-block [Macro]

@@ -14112,5 +14148,5 @@
-

12.3.2.13. make-cstring [Function]

+

12.3.2.13. make-cstring [Function]

@@ -14155,5 +14191,5 @@
-

12.3.2.14. with-cstrs [Macro]

+

12.3.2.14. with-cstrs [Macro]

@@ -14205,5 +14241,5 @@
-

12.3.2.15. with-encoded-cstrs [Macro]

+

12.3.2.15. with-encoded-cstrs [Macro]

@@ -14268,5 +14304,5 @@
-

12.3.2.16. %get-cstring [Function]

+

12.3.2.16. %get-cstring [Function]

@@ -14310,5 +14346,5 @@
-

12.3.2.17. %str-from-ptr [Function]

+

12.3.2.17. %str-from-ptr [Function]

@@ -15756,5 +15792,5 @@
- +
Description:

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

- +
Description:

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

- +
Description:

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

- +
Description:

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

- +
Description:

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

- +
Values:

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

- +
Description:

If completely is T, sets the @@ -16082,5 +16118,5 @@

- +
Values:

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

@@ -16099,5 +16135,5 @@
- +
Description:

Proclaims name @@ -16135,5 +16171,5 @@

- +
Values:

name---NIL or a keyword; the keyword may contain @@ -16143,5 +16179,5 @@

- +
Description:

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

- +
Values:

name--- @@ -16190,5 +16226,5 @@

- +
Description:

If there is already an EXTERNAL-ENTRY-POINT for @@ -16218,5 +16254,5 @@

- +
Values:

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

@@ -16231,5 +16267,5 @@
- +
Description:

Calls the foreign function at the address obtained by @@ -16258,5 +16294,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -16269,5 +16305,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -16295,5 +16331,5 @@

- +
Values:

entrypoint---A fixnum or MACPTR

@@ -16308,5 +16344,5 @@
- +
Description:

Calls the foreign function at address entrypoint passing the @@ -16333,10 +16369,10 @@

- +
Values:

name---A lisp string.

- +
Description:

Tries to resolve the address of the foreign symbol @@ -16361,10 +16397,10 @@

- +
Values:

name---A lisp string.

- +
Description:

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

- +
Values:

ptr---A MACPTR that points to a block of @@ -16394,5 +16430,5 @@

- +
Description:

In CCL 1.2 and later, the CCL:FREE @@ -16426,5 +16462,5 @@

- +
Values:

element-count---A positive integer.

@@ -16441,5 +16477,5 @@
- +
Description:

@@ -16476,5 +16512,5 @@

- +
Values:

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

- +
Description:

@@ -16542,5 +16578,5 @@

- +
Values:

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

- +
Description:

@@ -16597,5 +16633,5 @@

- +
Notes:

@@ -16630,5 +16666,5 @@

- +
Values:

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

- +
Description:

If the library denoted by name can @@ -16649,5 +16685,5 @@

- +
Examples:
;;; Try to do something simple.
@@ -16684,5 +16720,5 @@
- +
Notes:

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

- +
Values:

ptr---a MACPTR.

@@ -16715,5 +16751,5 @@
- +
Description:

References an instance of a foreign type (or a component of @@ -16741,5 +16777,5 @@

- +
Values:

eep---An EXTERNAL-ENTRY-POINT, as obtained by the EXTERNAL @@ -16747,5 +16783,5 @@

- +
Description:

Tries to resolve the address of the EXTERNAL-ENTRY-POINT @@ -16770,5 +16806,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -16778,5 +16814,5 @@
- +
Description:

Executes body @@ -16808,5 +16844,5 @@

- +
Values:

var---A symbol (a lisp variable)

@@ -16815,5 +16851,5 @@
- +
Description:

Executes body in an environment in which each var is @@ -16842,5 +16878,5 @@

- +
Values:

object---A CLOS object of a class for which there exists @@ -16850,5 +16886,5 @@

- +
Description:

@@ -16887,5 +16923,5 @@

- +
Example:
@@ -16901,5 +16937,5 @@
- +
See Also:
@@ -16923,5 +16959,5 @@
- +
Values:

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

- +
Description:

Tells CCL to remove the interface directory denoted by @@ -16954,5 +16990,5 @@

- +
Values:

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

- +
Description:

Tells CCL to add the interface directory denoted by @@ -16983,5 +17019,5 @@

- +
Examples:

One typically wants interface information to be @@ -18636,5 +18672,5 @@

- +
Arguments and Values:

name---a string which is the name of an existing @@ -18646,5 +18682,5 @@

- +
Description:

@@ -18667,5 +18703,5 @@

- +
Arguments and Values:

name---a string which is the name of a new or existing @@ -18680,5 +18716,5 @@

- +
Description:

@@ -18704,5 +18740,5 @@

- +
Values:

path---a string, an absolute pathname in Posix format - with @@ -18710,5 +18746,5 @@

- +
Description:

@@ -18732,5 +18768,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -18738,5 +18774,5 @@

- +
Description:

@@ -18758,5 +18794,5 @@

- +
Arguments and Values:

uid---a non-negative integer, identifying a specific user @@ -18767,5 +18803,5 @@

- +
Description:

@@ -18790,5 +18826,5 @@

- +
Arguments and Values:

gid---a non-negative integer, identifying a specific @@ -18799,5 +18835,5 @@

- +
Description:

@@ -18822,10 +18858,10 @@

- +
Values:

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

- +
Description:

@@ -18848,5 +18884,5 @@

- +
Values:

uid---a non-negative integer, identifying a specific user @@ -18856,5 +18892,5 @@

- +
Description:

@@ -18881,5 +18917,5 @@

- +
Values:

command-line---a string, obeying all the whitespace and @@ -18890,5 +18926,5 @@

- +
Description:

@@ -18906,5 +18942,5 @@

- +
Notes:

@@ -18931,5 +18967,5 @@

- +
Arguments and Values:

class-name---a string which denotes an existing class name, or a @@ -18938,5 +18974,5 @@

- +
Description:

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

- +
Arguments and Values:

string---a string constant, used to canonically refer to an @@ -18969,5 +19005,5 @@

- +
Description:

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

- +
Arguments and Values:

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

- +
Description:

Defines an Objective-C-callable method which implements @@ -19038,5 +19074,5 @@

- +
Arguments and Values:

selector---either a string which represents the name of the @@ -19053,5 +19089,5 @@

- +
Description:

Defines an ObjC-callable method which implements the @@ -19074,10 +19110,10 @@

- +
Arguments and Values:

As per DEFINE-OBJC-METHOD

- +
Description:

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

- +
Description:

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

- +
Description:

Per ANSI CL, Clozure CL supports the :EXTERNAL-FORMAT keyword @@ -19200,5 +19236,5 @@

- +
Description:

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

- +
Superclasses:

NS:NS-STRING

- +
Initargs:

:string--- @@ -19237,5 +19273,5 @@

- +
Description:

@@ -19255,5 +19291,5 @@

- +
Examples:

@@ -19286,5 +19322,5 @@

- +
Notes:

@@ -19626,5 +19662,5 @@

- +
Arguments and Values:

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

@@ -19634,5 +19670,5 @@
- +
Description:

Creates a new population of the specified type.

@@ -19652,5 +19688,5 @@
- +
Description:

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

@@ -19670,5 +19706,5 @@
- +
Description:

returns the list encapsulated in population. @@ -19693,5 +19729,5 @@

- +
Description:

Sets the list encapsulated in population to @@ -19726,5 +19762,5 @@

- +
Description:

Returns the value of the kernel variable that specifies the @@ -19747,10 +19783,10 @@

- +
Arguments and Values:

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

- +
Description:

Sets the value of the kernel variable that specifies the @@ -19776,5 +19812,5 @@

- +
Description:

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

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Enables the EGC if arg is non-nil, disables the EGC @@ -19827,5 +19863,5 @@

- +
Description:

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

- +
Description:

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

- +
Description:

Returns, as multiple values, the sizes in kilobytes of the @@ -19897,5 +19933,5 @@

- +
Arguments and Values:

generation-0-size---the requested threshold size of the youngest @@ -19907,5 +19943,5 @@

- +
Description:

Puts the indicated threshold sizes in effect. @@ -19931,10 +19967,10 @@

- +
Arguments and Values:

arg---a generalized boolean

- +
Description:

Tries to influence the GC to retain/recycle the pages @@ -19961,5 +19997,5 @@

- +
Description:

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

- 16.7.2. Recommended Reading + 16.7.2. Recommended Reading
@@ -21392,5 +21428,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 @@ -21525,5 +21561,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".

    @@ -21585,5 +21621,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.

    @@ -21632,5 +21668,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. @@ -21653,5 +21689,5 @@
    -

    [2] This is +

    [2] This is sometimes called "The Write Barrier": all assignments which might result in intergenerational references must be noted, as @@ -21659,5 +21695,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 @@ -21775,5 +21811,5 @@

    -

    16.7.2. Recommended Reading

    +

    16.7.2. Recommended Reading

    @@ -22188,5 +22224,5 @@
    - +
    Description:

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

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -22237,5 +22273,5 @@

    - +
    Description:

    Arranges that the outermost special bindings of *PACKAGE* @@ -22260,5 +22296,5 @@

    - +
    Description:

    This variable is initialized each time an Clozure CL session @@ -22285,5 +22321,5 @@

    - +
    Description:

    Returns non-NIL if AltiVec is available.

    @@ -22303,5 +22339,5 @@
    - +
    Description:

    Intended to control the expansion of certain lap macros. @@ -22325,5 +22361,5 @@

    - +
    Arguments and Values:

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

    @@ -22331,5 +22367,5 @@
    - +
    Description:

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

    - +
    Arguments and Values:

    base---Any available general-purpose register.

    @@ -22366,5 +22402,5 @@
    - +
    Description:

    Generates code which allocates a 16-byte aligned buffer @@ -22925,4 +22961,5 @@

    process-preset, Function PROCESS-PRESET
    process-reset, Function PROCESS-RESET
    +
    process-reset-and-enable, Function PROCESS-RESET-AND-ENABLE
    process-resume, Function PROCESS-RESUME
    process-run-function, Function PROCESS-RUN-FUNCTION
    @@ -23041,5 +23078,5 @@ Symbol Index
    -

    This document was last modified at 21:0 on November 2, 2010, in UTC.

    It uses version 1.75.2 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 14399

    Using libxml 20706, libxslt 10126 and libexslt 815.

    +

    This document was last modified at 19:0 on December 9, 2010, in UTC.

    It uses version 1.75.2 of the Norman Walsh Docbook stylesheets.

    Built from subversion rev 14474

    Using libxml 20706, libxslt 10126 and libexslt 815.