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
@@ -1772,5 +1772,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
@@ -1783,5 +1783,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
@@ -1795,5 +1795,5 @@
as-yet-unsupported ones) has a uniquely named subdirectory of
-
+
TRACE {
-
+
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 compile-file. fasl files store the
@@ -1762,5 +1762,5 @@
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
@@ -2477,15 +2477,20 @@
keyword
global-value}* {spec |
@@ -3063,15 +3068,15 @@
spec &key {keyword value}* [Function]
- + CCL:*TRACE-BAR-FREQUENCY* [Variable]
@@ -3146,5 +3151,5 @@@@ -3226,5 +3231,5 @@
@@ -3265,5 +3270,5 @@
@@ -3437,5 +3442,5 @@
The value of this variable is used when :EXTERNAL-FORMAT is @@ -3463,5 +3468,5 @@
The value of this variable is used when an external-format @@ -3495,5 +3500,5 @@
domain---This is used to indicate where the external @@ -3529,5 +3534,5 @@
Despite the function's name, it doesn't necessarily create a @@ -3702,5 +3707,5 @@
@@ -3718,5 +3723,5 @@ @@ -3746,5 +3751,5 @@ @@ -3768,5 +3773,5 @@@@ -4264,5 +4269,5 @@
@@ -4313,5 +4318,5 @@
@@ -4366,5 +4371,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
@@ -4432,9 +4437,127 @@
Clozure CL assumes that pathname strings are decomposed UTF-8.
++ The syntax of namestrings is implementation-defined in Common Lisp. + Portable programs cannot assume much of anything about them. (See + section 19.1.1 of the Common Lisp standard for more information.) +
+
+ When translating a namestring into a pathname object, most
+ implementations seem to follow the convention that a dot
+ character in the namestring separates the
+ pathname-name and
+ the pathname-type. When there is more
+ than one dot in involved, or when dots appear at the beginning
+ or end of the namestrings, what to do is less clear: does
+ ".emacs" describe a pathname whose name is
+ nil and whose type is emacs
+ or something else? Similarly, given "a.b.c", the question
+ is which parts are parsed as the pathname name, and which are
+ parsed as the pathname type?
+
+ When generating a namestring from a pathname object (as happens, + for example, when printing a pathname), Clozure CL + tries to avoid some potential ambiguity by escaping characters + that might otherwise be used to separate pathname components. + The character used to quote or escape the separators is a + backlash on Unix systems, and a #\> character on Windows. + So, for example, "a\\.b.c" + has name "a.b" and type "c", whereas "a.b\\.c" has name + "a" and type "b.c". +
+
+ To get a native namestring suitable for passing to an
+ operating system command, use the function
+ ccl:native-translated-namestring.
+
+
++
+ This function returns a namestring that represents a pathname + using the native conventions of the operating system. + Any quoting or escaping of special characters will be removed. +
+
+ For example, suppose that p is a pathname made
+ by (make-pathname :name "a.b" :type "c").
+ Then, (native-translated-namestring p) evaluates
+ to "a.b.c". By contrast, (namestring p) evaluates
+ to "a\\.b.c".
+
+
++
+ Executes forms in an environemt in which each + var is bound to a stack-allocated foreign + pointer which refers to a C-style string suitable for passing + to foreign code which expects a filename argument. +
++ For example, one might use this macro in the following way: +
++(with-filename-cstrs ((s (native-translated-namestring pathname))) + (#_unlink s)) ++
+
++ Various operating systems have different conventions for how + they expect native pathname strings to be encoded. Darwin + expects then to be decomposed UTF-8. The Unicode variants + to Windows file-handling functions expect UTF-16. Other + systems just treat them as opaque byte sequences. This macro + ensures that the correct encoding is used, whatever + the host operating system. +
+Clozure CL assumes that pathname strings are decomposed UTF-8.
+
-
+
CCL:MAP-FILE-TO-IVECTOR
pathname
@@ -4580,5 +4713,5 @@
a memory error.
-
+
CCL:UNMAP-IVECTOR
displaced-array
@@ -4592,5 +4725,5 @@
target is an empty vector (of length zero).
-
+
CCL:MAP-FILE-TO-OCTET-VECTOR
pathname
@@ -4602,5 +4735,5 @@
bytes.
-
+
CCL:UNMAP-OCTET-VECTOR
displaced-array
@@ -4641,5 +4774,5 @@
static.
Clozure CL provides the
function CCL:SAVE-APPLICATION, which creates a file
@@ -4775,5 +4908,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.
ccl64 script.
-
+
SAVE-APPLICATION
@@ -5061,5 +5194,5 @@
@@ -5108,5 +5241,5 @@
@@ -5166,5 +5299,5 @@
@@ -5340,5 +5473,5 @@
@@ -5374,5 +5507,5 @@
@@ -5460,5 +5593,5 @@
@@ -5762,5 +5895,5 @@
@@ -5784,5 +5917,5 @@
@@ -5810,5 +5943,5 @@
@@ -5836,5 +5969,5 @@
@@ -5867,5 +6000,5 @@
@@ -5894,5 +6027,5 @@
@@ -5917,5 +6050,5 @@
@@ -5941,5 +6074,5 @@
@@ -5968,5 +6101,5 @@
@@ -5995,5 +6128,5 @@
@@ -6162,5 +6295,5 @@
@@ -6187,5 +6320,5 @@
@@ -6263,5 +6396,5 @@
@@ -6298,5 +6431,5 @@
@@ -6329,5 +6462,5 @@
@@ -6559,5 +6692,5 @@
-
+
BUILD-APPLICATION &key
( process-suspend was previously called
@@ -7886,5 +8019,5 @@
@@ -7939,5 +8072,5 @@
It would be nice to have more discussion of what it means
@@ -8083,5 +8216,5 @@
It would probably be better for result
@@ -8222,10 +8355,10 @@
This should arguably be SETFable, but doesn't seem to
@@ -8514,5 +8647,5 @@
Advises the OS scheduler that the current thread has nothing
@@ -8523,10 +8656,10 @@
This is a holdover from the days of cooperative
@@ -8551,5 +8684,5 @@
Executes body
@@ -8732,5 +8865,5 @@
Creates and returns an object of type CCL::READ-WRITE-LOCK.
@@ -8938,10 +9071,10 @@
There probably should be some way to
@@ -8966,5 +9099,5 @@
result should probably be interpreted
@@ -9129,5 +9262,5 @@
result should probably be interpreted
@@ -9173,5 +9306,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -9223,5 +9356,5 @@
@@ -9269,5 +9402,5 @@
fd---a file descriptor, which is a non-negative integer
@@ -9277,5 +9410,5 @@
@@ -9320,5 +9453,5 @@
process---a process, typically created by process-run-function or by make-process Waits for the specified process to terminate. If the
@@ -9587,5 +9720,5 @@
address-family---The address/protocol family of this socket. Currently
@@ -9687,5 +9820,5 @@
Creates and returns a new socket Extracts the first connection on the queue of pending
@@ -9740,5 +9873,5 @@
Converts a dotted-string representation of a host address to
@@ -9768,5 +9901,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
@@ -9823,5 +9956,5 @@
host---Specifies the host. It can be either a host name
@@ -9831,5 +9964,5 @@
Converts a host spec in any of the acceptable formats into a
@@ -9851,5 +9984,5 @@
port---Specifies the port. It can be either a string, such as
@@ -9860,5 +9993,5 @@
Finds the port number for the specified port and protocol Reads a UDP packet from a socket. If no packets are
@@ -9934,5 +10067,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
@@ -9996,10 +10129,10 @@
Returns the native OS's representation of the socket, or
@@ -10026,10 +10159,10 @@
Returns the 32-bit unsigned IP address of the remote host,
@@ -10051,10 +10184,10 @@
Returns the remote port number, or NIL if the socket is not
@@ -10076,10 +10209,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
@@ -10173,10 +10306,10 @@
Returns the socket format as specified by the :format
@@ -10198,10 +10331,10 @@
returns :stream for tcp-stream and listener-socket, and
@@ -10222,10 +10355,10 @@
simple-error The OS error code of the error A symbol representing the error code in a more
@@ -10299,10 +10432,10 @@
A string describing the context where the error happened. On
@@ -10325,5 +10458,5 @@
The close generic function can be applied to sockets. It
@@ -10357,5 +10490,5 @@
executes body with var bound to the result of applying
@@ -10496,5 +10629,5 @@
program---A string or pathname which denotes an executable file.
@@ -10547,5 +10680,5 @@
Runs the specified program in an external (Unix) process,
@@ -10567,5 +10700,5 @@
proc---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM. Sends the specified "signal" to the specified
@@ -10596,10 +10729,10 @@
Returns the process id assigned to
@@ -10623,10 +10756,10 @@
Returns the stream created when the input argument to
@@ -10649,10 +10782,10 @@
Returns the stream created when the output argument to
@@ -10676,10 +10809,10 @@
Returns the stream created when the error argument to
@@ -10703,10 +10836,10 @@
Returns, as multiple values, a keyword denoting the status
@@ -10738,5 +10871,5 @@
A stream that is associated with a file descriptor has
attributes and accessors:
@@ -11027,5 +11160,5 @@
stream---a stream, presumably a fundamental-input-stream. Should try to read up to count elements from stream into the
@@ -11578,5 +11711,5 @@
stream---a stream, presumably a fundamental-output-stream. should try to write the first count elements of list to
@@ -11609,5 +11742,5 @@
stream---a stream, presumably a fundamental-input-stream should try to read successive elements from stream into
@@ -11648,5 +11781,5 @@
stream---a stream, presumably a fundamental-output-stream should try to write successive elements of vector to stream,
@@ -11686,5 +11819,5 @@
Returns the file descriptor associated with
@@ -11727,5 +11860,5 @@
stream---An input stream. The method defined on
@@ -11759,5 +11892,5 @@
Writes max-octets octets to stream from ivector, starting at
@@ -11765,5 +11898,5 @@
CHUD:*SHARK-CONFIG-FILE*
[Variable] CHUD:METER form &key (reset nil)
+ CHUD:METER form &key (reset nil)
(debug-output nil) [Macro] Executes FORM (an arbitrary lisp form) and returns whatever
@@ -14053,5 +14186,5 @@
Reads a symbol from the current input stream, with *PACKAGE*
@@ -16146,5 +16279,5 @@
In In In In filename
@@ -4987,5 +5120,5 @@
name "MyApplication")
@@ -6991,5 +7124,5 @@
@@ -12566,5 +12699,5 @@
CCL 1.2 and later, the #& reader macro can be used to
@@ -16205,5 +16338,5 @@
CCL 0.14.2 and later, the #? reader macro can be used
@@ -16252,5 +16385,5 @@
CCL 1.2 and later, the #/ reader macro can be used to
@@ -16355,5 +16488,5 @@
CCL 1.2 and later, the #> reader macro reads
@@ -16384,5 +16517,5 @@