Changeset 14635
- Timestamp:
- Feb 3, 2011, 12:00:17 AM (14 years ago)
- File:
-
- 1 edited
-
trunk/source/doc/ccl-documentation.html (modified) (410 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/source/doc/ccl-documentation.html
r14530 r14635 6 6 <title>Clozure CL Documentation</title> 7 7 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /> 8 <link rel="home" href="#id4 68538" title="Clozure CL Documentation" />8 <link rel="home" href="#id490349" title="Clozure CL Documentation" /> 9 9 <link rel="next" href="#about-ccl" title="Chapter 1. About Clozure CL" /> 10 10 </head> … … 14 14 <div> 15 15 <div> 16 <h1 class="title"><a id="id4 68538"></a>Clozure CL Documentation</h1>16 <h1 class="title"><a id="id490349"></a>Clozure CL Documentation</h1> 17 17 </div> 18 18 </div> … … 1745 1745 <p xmlns="http://www.w3.org/1999/xhtml">The following terms are used in subsequent sections; it 1746 1746 may be helpful to refer to these definitions.</p> 1747 <p xmlns="http://www.w3.org/1999/xhtml"><a id="id 487079" class="indexterm"></a><a class="glossterm" href="#fasl-file"><em class="glossterm">fasl1747 <p xmlns="http://www.w3.org/1999/xhtml"><a id="id508890" class="indexterm"></a><a class="glossterm" href="#fasl-file"><em class="glossterm">fasl 1748 1748 files</em></a> are the object files produced 1749 1749 by <code class="literal">compile-file</code>. fasl files store the … … 1756 1756 see 1757 1757 <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, âPlatform-specific filename conventionsâ</a> </p> 1758 <p xmlns="http://www.w3.org/1999/xhtml">The <a id="id 481780" class="indexterm"></a> <a class="glossterm" href="#lisp_kernel"><em class="glossterm">Lisp1758 <p xmlns="http://www.w3.org/1999/xhtml">The <a id="id503591" class="indexterm"></a> <a class="glossterm" href="#lisp_kernel"><em class="glossterm">Lisp 1759 1759 kernel</em></a> is a C program with a fair amount of 1760 1760 platform-specific assembly language code. Its basic job is to … … 1766 1766 files on different platforms; see 1767 1767 <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, âPlatform-specific filename conventionsâ</a>.</p> 1768 <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id5 09996" class="indexterm"></a> <a class="glossterm" href="#lisp_image"><em class="glossterm">heap1768 <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id531807" class="indexterm"></a> <a class="glossterm" href="#lisp_image"><em class="glossterm">heap 1769 1769 image</em></a> is a file that can be quickly mapped into a 1770 1770 process's address space. Conceptually, it's not too different … … 1777 1777 standard full heap image files on different platforms; see 1778 1778 <a class="xref" href="#Platform-specific-filename-conventions" title="Table 3.1. Platform-specific filename conventions">Table 3.1, âPlatform-specific filename conventionsâ</a>.</p> 1779 <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id 495655" class="indexterm"></a> bootstrapping image is a minimal1779 <p xmlns="http://www.w3.org/1999/xhtml">A <a id="id517466" class="indexterm"></a> bootstrapping image is a minimal 1780 1780 heap image used in the process of building Clozure CL itself. The 1781 1781 bootstrapping image contains just enough code to load the rest … … 1789 1789 as-yet-unsupported ones) has a uniquely named subdirectory of 1790 1790 <code class="literal">ccl/lisp-kernel/</code>; each such 1791 <a id="id 493838" class="indexterm"></a>1791 <a id="id515649" class="indexterm"></a> 1792 1792 contains a Makefile and may contain some auxiliary files (linker 1793 1793 scripts, etc.) that are used to build the lisp kernel on a … … 2608 2608 </p> 2609 2609 <p xmlns="http://www.w3.org/1999/xhtml"> 2610 <a id="id5 02724" class="indexterm"></a>2610 <a id="id524535" class="indexterm"></a> 2611 2611 <span class="command"><strong><em class="varname"><a id="trace"></a>TRACE</em> {<em class="replaceable"><code>keyword</code></em> 2612 2612 <em class="replaceable"><code>global-value</code></em>}* {<em class="replaceable"><code>spec</code></em> | … … 3052 3052 </div> 3053 3053 <p xmlns="http://www.w3.org/1999/xhtml"> 3054 <a id="id5 23292" class="indexterm"></a>3054 <a id="id545104" class="indexterm"></a> 3055 3055 <span class="command"><strong><em class="varname"><a id="trace-level"></a>CCL:*TRACE-LEVEL*</em> [Variable]</strong></span> 3056 3056 </p> 3057 3057 <p xmlns="http://www.w3.org/1999/xhtml">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.</p> 3058 3058 <p xmlns="http://www.w3.org/1999/xhtml"> 3059 <a id="id5 23319" class="indexterm"></a>3059 <a id="id545130" class="indexterm"></a> 3060 3060 <span class="command"><strong><em class="varname"><a id="trace-max-indent"></a>CCL:*TRACE-MAX-INDENT*</em> [Variable]</strong></span> 3061 3061 </p> 3062 3062 <p xmlns="http://www.w3.org/1999/xhtml">The default before and after print actions will not indent by more than the value of <em class="varname">ccl:*trace-max-indent*</em> regardless of the current trace level.</p> 3063 3063 <p xmlns="http://www.w3.org/1999/xhtml"> 3064 <a id="id5 23348" class="indexterm"></a>3064 <a id="id545159" class="indexterm"></a> 3065 3065 <span class="command"><strong><em class="varname"><a id="trace-function"></a>CCL:TRACE-FUNCTION</em> <em class="replaceable"><code>spec</code></em> <em class="varname">&key</em> {<em class="replaceable"><code>keyword</code></em> <em class="replaceable"><code>value</code></em>}* [Function]</strong></span> 3066 3066 </p> … … 3070 3070 </p> 3071 3071 <p xmlns="http://www.w3.org/1999/xhtml"> 3072 <a id="id5 23396" class="indexterm"></a>3072 <a id="id545208" class="indexterm"></a> 3073 3073 <span class="command"><strong><em class="varname"><a id="trace-print-level"></a>CCL:*TRACE-PRINT-LEVEL*</em> [Variable]</strong></span> 3074 3074 </p> … … 3078 3078 explicit printing done by user code.</p> 3079 3079 <p xmlns="http://www.w3.org/1999/xhtml"> 3080 <a id="id5 23431" class="indexterm"></a>3080 <a id="id545242" class="indexterm"></a> 3081 3081 <span class="command"><strong><em class="varname"><a id="trace-print-length"></a>CCL:*TRACE-PRINT-LENGTH*</em> [Variable]</strong></span> 3082 3082 </p> … … 3086 3086 explicit printing done by user code.</p> 3087 3087 <p xmlns="http://www.w3.org/1999/xhtml"> 3088 <a id="id5 23466" class="indexterm"></a>3088 <a id="id545277" class="indexterm"></a> 3089 3089 <span class="command"><strong><em class="varname"><a id="trace-bar-frequency"></a>CCL:*TRACE-BAR-FREQUENCY*</em> [Variable]</strong></span> 3090 3090 </p> … … 3135 3135 <div> 3136 3136 <div class="refsect1" lang="en" xml:lang="en"> 3137 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 23628"></a>3137 <a xmlns="http://www.w3.org/1999/xhtml" id="id545439"></a> 3138 3138 <div class="header">Arguments and Values:</div> 3139 3139 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">spec</span></i>--- … … 3170 3170 </div> 3171 3171 <div class="refsect1" lang="en" xml:lang="en"> 3172 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 23735"></a>3172 <a xmlns="http://www.w3.org/1999/xhtml" id="id545546"></a> 3173 3173 <div class="header">Examples:</div> 3174 3174 <p xmlns="http://www.w3.org/1999/xhtml"> … … 3215 3215 <div> 3216 3216 <div class="refsect1" lang="en" xml:lang="en"> 3217 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 23834"></a>3217 <a xmlns="http://www.w3.org/1999/xhtml" id="id545645"></a> 3218 3218 <div class="header">Description:</div> 3219 3219 <p xmlns="http://www.w3.org/1999/xhtml"> … … 3230 3230 </div> 3231 3231 <div class="refsect1" lang="en" xml:lang="en"> 3232 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 23900"></a>3232 <a xmlns="http://www.w3.org/1999/xhtml" id="id545711"></a> 3233 3233 <div class="header">Arguments and Values:</div> 3234 3234 <p xmlns="http://www.w3.org/1999/xhtml"> … … 3254 3254 <div> 3255 3255 <div class="refsect1" lang="en" xml:lang="en"> 3256 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 23978"></a>3256 <a xmlns="http://www.w3.org/1999/xhtml" id="id545789"></a> 3257 3257 <div class="header">Description:</div> 3258 3258 <p xmlns="http://www.w3.org/1999/xhtml"> … … 3266 3266 </div> 3267 3267 <div class="refsect1" lang="en" xml:lang="en"> 3268 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 24025"></a>3268 <a xmlns="http://www.w3.org/1999/xhtml" id="id545836"></a> 3269 3269 <div class="header">Arguments and Values:</div> 3270 3270 <p xmlns="http://www.w3.org/1999/xhtml"> … … 3433 3433 <div> 3434 3434 <div class="refsect1" lang="en" xml:lang="en"> 3435 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 24587"></a>3435 <a xmlns="http://www.w3.org/1999/xhtml" id="id546398"></a> 3436 3436 <div class="header">Arguments and Values:</div> 3437 3437 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">domain</span></i>---This is used to indicate where the external … … 3467 3467 </div> 3468 3468 <div class="refsect1" lang="en" xml:lang="en"> 3469 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39209"></a>3469 <a xmlns="http://www.w3.org/1999/xhtml" id="id561041"></a> 3470 3470 <div class="header">Description:</div> 3471 3471 <p xmlns="http://www.w3.org/1999/xhtml">Despite the function's name, it doesn't necessarily create a … … 3635 3635 <div> 3636 3636 <div> 3637 <h4 class="title"><a id="id5 39512"></a>4.5.4.1. Encoding Problems</h4>3637 <h4 class="title"><a id="id561344"></a>4.5.4.1. Encoding Problems</h4> 3638 3638 </div> 3639 3639 </div> … … 3651 3651 <div> 3652 3652 <div> 3653 <h4 class="title"><a id="id5 39525"></a>4.5.4.2. Byte Order Marks</h4>3653 <h4 class="title"><a id="id561357"></a>4.5.4.2. Byte Order Marks</h4> 3654 3654 </div> 3655 3655 </div> … … 3679 3679 <div> 3680 3680 <div> 3681 <h4 class="title"><a id="id5 39559"></a>4.5.4.3. <span class="function"><strong>DESCRIBE-CHARACTER-ENCODINGS</strong></span></h4>3681 <h4 class="title"><a id="id561391"></a>4.5.4.3. <span class="function"><strong>DESCRIBE-CHARACTER-ENCODINGS</strong></span></h4> 3682 3682 </div> 3683 3683 </div> … … 3701 3701 <div> 3702 3702 <div class="refsect1" lang="en" xml:lang="en"> 3703 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39621"></a>3703 <a xmlns="http://www.w3.org/1999/xhtml" id="id561453"></a> 3704 3704 <div class="header">Description:</div> 3705 3705 <p xmlns="http://www.w3.org/1999/xhtml">Writes descriptions of all defined character encodings … … 3710 3710 </div> 3711 3711 <div class="refsect1" lang="en" xml:lang="en"> 3712 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39636"></a>3712 <a xmlns="http://www.w3.org/1999/xhtml" id="id561468"></a> 3713 3713 <div class="header">See Also:</div> 3714 3714 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#Character-Encodings" title="4.5.4. Character Encodings">Section 4.5.4, âCharacter Encodingsâ</a>, <a class="xref" href="#External-Formats" title="4.5.2. External Formats">Section 4.5.2, âExternal Formatsâ</a>, <a class="xref" href="#Supported-Character-Encodings" title="4.5.4.4. Supported Character Encodings">Section 4.5.4.4, âSupported Character Encodingsâ</a></span> … … 4141 4141 <div> 4142 4142 <div> 4143 <h4 class="title"><a id="id5 40315"></a>4.5.4.5. Encoding and Decoding Strings</h4>4143 <h4 class="title"><a id="id562147"></a>4.5.4.5. Encoding and Decoding Strings</h4> 4144 4144 </div> 4145 4145 </div> … … 4166 4166 <div> 4167 4167 <div class="refsect1" lang="en" xml:lang="en"> 4168 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 40390"></a>4168 <a xmlns="http://www.w3.org/1999/xhtml" id="id562222"></a> 4169 4169 <div class="header">Description:</div> 4170 4170 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4197 4197 <div> 4198 4198 <div class="refsect1" lang="en" xml:lang="en"> 4199 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 40486"></a>4199 <a xmlns="http://www.w3.org/1999/xhtml" id="id562318"></a> 4200 4200 <div class="header">Description:</div> 4201 4201 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4240 4240 <div> 4241 4241 <div class="refsect1" lang="en" xml:lang="en"> 4242 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 40609"></a>4242 <a xmlns="http://www.w3.org/1999/xhtml" id="id562441"></a> 4243 4243 <div class="header">Description:</div> 4244 4244 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4286 4286 <div> 4287 4287 <div class="refsect1" lang="en" xml:lang="en"> 4288 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 40728"></a>4288 <a xmlns="http://www.w3.org/1999/xhtml" id="id562560"></a> 4289 4289 <div class="header">Description:</div> 4290 4290 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4336 4336 </div> 4337 4337 <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL sets up logical pathname translations for logical hosts: <code class="literal">ccl</code> and <code class="literal">home</code></p> 4338 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 40817" class="indexterm"></a>4338 <a xmlns="http://www.w3.org/1999/xhtml" id="id562649" class="indexterm"></a> 4339 4339 <p xmlns="http://www.w3.org/1999/xhtml">The <code class="literal">CCL</code> logical host should point to the 4340 4340 <code class="literal">ccl</code> directory. It is used for a variety of … … 4440 4440 platforms.</p> 4441 4441 <p xmlns="http://www.w3.org/1999/xhtml"> 4442 <a id="id5 41000" class="indexterm"></a>4442 <a id="id562832" class="indexterm"></a> 4443 4443 <span class="command"><strong><em class="varname"><a id="map-file-to-ivector"></a>CCL:MAP-FILE-TO-IVECTOR</em> 4444 4444 <em class="parameter"><code>pathname</code></em> … … 4500 4500 a memory error.</p> 4501 4501 <p xmlns="http://www.w3.org/1999/xhtml"> 4502 <a id="id5 41133" class="indexterm"></a>4502 <a id="id562965" class="indexterm"></a> 4503 4503 <span class="command"><strong><em class="varname"><a id="unmap-ivector"></a>CCL:UNMAP-IVECTOR</em> 4504 4504 <em class="parameter"><code>displaced-array</code></em> … … 4512 4512 target is an empty vector (of length zero).</p> 4513 4513 <p xmlns="http://www.w3.org/1999/xhtml"> 4514 <a id="id5 41168" class="indexterm"></a>4514 <a id="id563000" class="indexterm"></a> 4515 4515 <span class="command"><strong><em class="varname"><a id="map-file-to-octet-vector"></a>CCL:MAP-FILE-TO-OCTET-VECTOR</em> 4516 4516 <em class="parameter"><code>pathname</code></em> … … 4522 4522 bytes.</p> 4523 4523 <p xmlns="http://www.w3.org/1999/xhtml"> 4524 <a id="id5 41200" class="indexterm"></a>4524 <a id="id563032" class="indexterm"></a> 4525 4525 <span class="command"><strong><em class="varname"><a id="unmap-octet-vector"></a>CCL:UNMAP-OCTET-VECTOR</em> 4526 4526 <em class="parameter"><code>displaced-array</code></em> … … 4561 4561 static.</p> 4562 4562 <p xmlns="http://www.w3.org/1999/xhtml"> 4563 <a id="id5 41275" class="indexterm"></a>4563 <a id="id563107" class="indexterm"></a> 4564 4564 <span class="command"><strong><em class="varname"><a id="defstatic"></a>DEFSTATIC</em> 4565 4565 <em class="parameter"><code>var</code></em> … … 4615 4615 </div> 4616 4616 </div> 4617 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 41387" class="indexterm"></a>4617 <a xmlns="http://www.w3.org/1999/xhtml" id="id563219" class="indexterm"></a> 4618 4618 <p xmlns="http://www.w3.org/1999/xhtml">Clozure CL provides the 4619 4619 function <code class="literal">CCL:SAVE-APPLICATION</code>, which creates a file … … 4695 4695 converted, because address 0 can always be relied upon to refer to 4696 4696 the same thing.</p> 4697 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 41609" class="indexterm"></a>4697 <a xmlns="http://www.w3.org/1999/xhtml" id="id563441" class="indexterm"></a> 4698 4698 <p xmlns="http://www.w3.org/1999/xhtml">As of Clozure CL 1.2, the constant <code class="literal">CCL:+NULL-PTR+</code> 4699 4699 refers to a <code class="literal">MACPTR</code> object that points to address 0.</p> … … 4703 4703 does. Alternatively, if you choose not to prepend the kernel, you 4704 4704 can save an image and then later run it by passing it as a 4705 command-line parameter to the <code class="literal"> opencml</code>4706 or <code class="literal"> opencml64</code> script.</p>4705 command-line parameter to the <code class="literal">ccl</code> 4706 or <code class="literal">ccl64</code> script.</p> 4707 4707 <p xmlns="http://www.w3.org/1999/xhtml"> 4708 <a id="id5 41656" class="indexterm"></a>4708 <a id="id563488" class="indexterm"></a> 4709 4709 <span class="command"><strong><em class="varname"><a id="save-application"></a>SAVE-APPLICATION</em> 4710 4710 <em class="parameter"><code>filename</code></em> … … 4719 4719 <em class="parameter"><code>(mode #o644)</code></em> 4720 4720 <em class="parameter"><code>prepend-kernel</code></em> 4721 <em class="parameter"><code>native</code></em> 4721 4722 [Function]</strong></span> 4722 4723 </p> … … 4801 4802 any true value.</p> 4802 4803 </dd> 4804 <dt> 4805 <span class="term"> 4806 <em class="varname">native</em> 4807 </span> 4808 </dt> 4809 <dd> 4810 <p>If true, saves the image as a native (ELF, Mach-O, PE) 4811 shared library. (On platforms where this isn't yet supported, 4812 a warning is issued and the option is ignored.) 4813 </p> 4814 </dd> 4803 4815 </dl> 4804 4816 </div> … … 4830 4842 <div> 4831 4843 <div class="refsect1" lang="en" xml:lang="en"> 4832 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 41927"></a>4844 <a xmlns="http://www.w3.org/1999/xhtml" id="id563780"></a> 4833 4845 <div class="header">Arguments and Values:</div> 4834 4846 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">out-file</span></i>--- … … 4844 4856 </div> 4845 4857 <div class="refsect1" lang="en" xml:lang="en"> 4846 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 41987"></a>4858 <a xmlns="http://www.w3.org/1999/xhtml" id="id563840"></a> 4847 4859 <div class="header">Description:</div> 4848 4860 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4904 4916 <div> 4905 4917 <div class="refsect1" lang="en" xml:lang="en"> 4906 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42078"></a>4918 <a xmlns="http://www.w3.org/1999/xhtml" id="id563930"></a> 4907 4919 <div class="header">Arguments and Values:</div> 4908 4920 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">mode</span></i>--- … … 4912 4924 </div> 4913 4925 <div class="refsect1" lang="en" xml:lang="en"> 4914 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42101"></a>4926 <a xmlns="http://www.w3.org/1999/xhtml" id="id563954"></a> 4915 4927 <div class="header">Description:</div> 4916 4928 <p xmlns="http://www.w3.org/1999/xhtml"> … … 4951 4963 <div> 4952 4964 <div class="refsect1" lang="en" xml:lang="en"> 4953 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42196"></a>4965 <a xmlns="http://www.w3.org/1999/xhtml" id="id564049"></a> 4954 4966 <div class="header">Arguments and Values:</div> 4955 4967 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">rounding-mode</span></i>--- … … 4960 4972 </div> 4961 4973 <div class="refsect1" lang="en" xml:lang="en"> 4962 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42232"></a>4974 <a xmlns="http://www.w3.org/1999/xhtml" id="id564085"></a> 4963 4975 <div class="header">Description:</div> 4964 4976 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5009 5021 <div> 5010 5022 <div class="refsect1" lang="en" xml:lang="en"> 5011 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42308"></a>5023 <a xmlns="http://www.w3.org/1999/xhtml" id="id564160"></a> 5012 5024 <div class="header">Arguments and Values:</div> 5013 5025 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">object</span></i>--- … … 5016 5028 </div> 5017 5029 <div class="refsect1" lang="en" xml:lang="en"> 5018 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42330"></a>5030 <a xmlns="http://www.w3.org/1999/xhtml" id="id564183"></a> 5019 5031 <div class="header">Description:</div> 5020 5032 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5183 5195 <div> 5184 5196 <div class="refsect1" lang="en" xml:lang="en"> 5185 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42504"></a>5197 <a xmlns="http://www.w3.org/1999/xhtml" id="id564357"></a> 5186 5198 <div class="header">Description:</div> 5187 5199 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5217 5229 <div> 5218 5230 <div class="refsect1" lang="en" xml:lang="en"> 5219 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42552"></a>5231 <a xmlns="http://www.w3.org/1999/xhtml" id="id564405"></a> 5220 5232 <div class="header">Discussion:</div> 5221 5233 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5235 5247 </div> 5236 5248 <div class="refsect1" lang="en" xml:lang="en"> 5237 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42606"></a>5249 <a xmlns="http://www.w3.org/1999/xhtml" id="id564459"></a> 5238 5250 <div class="header">Restarts:</div> 5239 5251 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5303 5315 <div> 5304 5316 <div> 5305 <h4 class="title"><a id="id5 42664"></a>4.12.5.1. Fancy arrays</h4>5317 <h4 class="title"><a id="id564516"></a>4.12.5.1. Fancy arrays</h4> 5306 5318 </div> 5307 5319 </div> … … 5330 5342 <div> 5331 5343 <div> 5332 <h4 class="title"><a id="id5 42683"></a>4.12.5.2. Hash tables</h4>5344 <h4 class="title"><a id="id564536"></a>4.12.5.2. Hash tables</h4> 5333 5345 </div> 5334 5346 </div> … … 5378 5390 <div> 5379 5391 <div> 5380 <h4 class="title"><a id="id5 42713"></a>4.12.5.3. Lists</h4>5392 <h4 class="title"><a id="id564566"></a>4.12.5.3. Lists</h4> 5381 5393 </div> 5382 5394 </div> … … 5547 5559 <div> 5548 5560 <div class="refsect1" lang="en" xml:lang="en"> 5549 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42895"></a>5561 <a xmlns="http://www.w3.org/1999/xhtml" id="id564748"></a> 5550 5562 <div class="header">Arguments and Values:</div> 5551 5563 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">html</span></i>--- … … 5569 5581 </div> 5570 5582 <div class="refsect1" lang="en" xml:lang="en"> 5571 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 42948"></a>5583 <a xmlns="http://www.w3.org/1999/xhtml" id="id564800"></a> 5572 5584 <div class="header">Example:</div> 5573 5585 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5603 5615 <div> 5604 5616 <div class="refsect1" lang="en" xml:lang="en"> 5605 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43027"></a>5617 <a xmlns="http://www.w3.org/1999/xhtml" id="id564880"></a> 5606 5618 <div class="header">Summary:</div> 5607 5619 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5625 5637 <div> 5626 5638 <div class="refsect1" lang="en" xml:lang="en"> 5627 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43066"></a>5639 <a xmlns="http://www.w3.org/1999/xhtml" id="id564918"></a> 5628 5640 <div class="header">Summary:</div> 5629 5641 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5651 5663 <div> 5652 5664 <div class="refsect1" lang="en" xml:lang="en"> 5653 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43118"></a>5665 <a xmlns="http://www.w3.org/1999/xhtml" id="id564971"></a> 5654 5666 <div class="header">Summary:</div> 5655 5667 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5677 5689 <div> 5678 5690 <div class="refsect1" lang="en" xml:lang="en"> 5679 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43170"></a>5691 <a xmlns="http://www.w3.org/1999/xhtml" id="id565023"></a> 5680 5692 <div class="header">Summary:</div> 5681 5693 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5708 5720 <div> 5709 5721 <div class="refsect1" lang="en" xml:lang="en"> 5710 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43213"></a>5722 <a xmlns="http://www.w3.org/1999/xhtml" id="id565066"></a> 5711 5723 <div class="header">Summary:</div> 5712 5724 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5735 5747 <div> 5736 5748 <div class="refsect1" lang="en" xml:lang="en"> 5737 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43266"></a>5749 <a xmlns="http://www.w3.org/1999/xhtml" id="id565119"></a> 5738 5750 <div class="header">Summary:</div> 5739 5751 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5758 5770 <div> 5759 5771 <div class="refsect1" lang="en" xml:lang="en"> 5760 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43316"></a>5772 <a xmlns="http://www.w3.org/1999/xhtml" id="id565169"></a> 5761 5773 <div class="header">Summary:</div> 5762 5774 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5785 5797 <div> 5786 5798 <div class="refsect1" lang="en" xml:lang="en"> 5787 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43369"></a>5799 <a xmlns="http://www.w3.org/1999/xhtml" id="id565222"></a> 5788 5800 <div class="header">Summary:</div> 5789 5801 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5812 5824 <div> 5813 5825 <div class="refsect1" lang="en" xml:lang="en"> 5814 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43422"></a>5826 <a xmlns="http://www.w3.org/1999/xhtml" id="id565275"></a> 5815 5827 <div class="header">Summary:</div> 5816 5828 <p xmlns="http://www.w3.org/1999/xhtml"> … … 5979 5991 <div> 5980 5992 <div class="refsect1" lang="en" xml:lang="en"> 5981 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43657"></a>5993 <a xmlns="http://www.w3.org/1999/xhtml" id="id565510"></a> 5982 5994 <div class="header">Summary:</div> 5983 5995 <p xmlns="http://www.w3.org/1999/xhtml"> … … 6004 6016 <div> 6005 6017 <div class="refsect1" lang="en" xml:lang="en"> 6006 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43709"></a>6018 <a xmlns="http://www.w3.org/1999/xhtml" id="id565562"></a> 6007 6019 <div class="header">Summary:</div> 6008 6020 <p xmlns="http://www.w3.org/1999/xhtml"> … … 6040 6052 <div> 6041 6053 <div class="refsect1" lang="en" xml:lang="en"> 6042 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43775"></a>6054 <a xmlns="http://www.w3.org/1999/xhtml" id="id565628"></a> 6043 6055 <div class="header">Summary:</div> 6044 6056 <p xmlns="http://www.w3.org/1999/xhtml"> … … 6075 6087 <div> 6076 6088 <div class="refsect1" lang="en" xml:lang="en"> 6077 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43837"></a>6089 <a xmlns="http://www.w3.org/1999/xhtml" id="id565690"></a> 6078 6090 <div class="header">Summary:</div> 6079 6091 <p xmlns="http://www.w3.org/1999/xhtml"> … … 6106 6118 <div> 6107 6119 <div class="refsect1" lang="en" xml:lang="en"> 6108 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43894"></a>6120 <a xmlns="http://www.w3.org/1999/xhtml" id="id565747"></a> 6109 6121 <div class="header">Summary:</div> 6110 6122 <p xmlns="http://www.w3.org/1999/xhtml"> … … 6336 6348 <div> 6337 6349 <div> 6338 <h4 class="title"><a id="id5 01255"></a>5.4.2.1. Checking for Updates</h4>6350 <h4 class="title"><a id="id523071"></a>5.4.2.1. Checking for Updates</h4> 6339 6351 </div> 6340 6352 </div> … … 6468 6480 the required subsystems, if necessary.</p> 6469 6481 <p xmlns="http://www.w3.org/1999/xhtml"> 6470 <a id="id5 05233" class="indexterm"></a>6482 <a id="id527050" class="indexterm"></a> 6471 6483 <span class="command"><strong><em class="varname"><a id="build-application"></a>BUILD-APPLICATION</em> <em class="varname">&key</em> 6472 6484 (<em class="parameter"><code>name</code></em> <em class="replaceable"><code>"MyApplication"</code></em>) … … 6768 6780 <dt> 6769 6781 <span class="sect2"> 6770 <a href="#id 479200">6.3.2. As of August 2003:</a>6782 <a href="#id500912">6.3.2. As of August 2003:</a> 6771 6783 </span> 6772 6784 </dt> … … 7019 7031 <div> 7020 7032 <div> 7021 <h3 class="title"><a id="id 479200"></a>6.3.2. As of August 2003:</h3>7033 <h3 class="title"><a id="id500912"></a>6.3.2. As of August 2003:</h3> 7022 7034 </div> 7023 7035 </div> … … 7471 7483 <div> 7472 7484 <div class="refsect1" lang="en" xml:lang="en"> 7473 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30296"></a>7485 <a xmlns="http://www.w3.org/1999/xhtml" id="id552107"></a> 7474 7486 <div class="header">Values:</div> 7475 7487 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">result</span></i>---a list of all lisp processes (threads) … … 7477 7489 </div> 7478 7490 <div class="refsect1" lang="en" xml:lang="en"> 7479 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30321"></a>7491 <a xmlns="http://www.w3.org/1999/xhtml" id="id552133"></a> 7480 7492 <div class="header">Description:</div> 7481 7493 <p xmlns="http://www.w3.org/1999/xhtml">Returns a list of all lisp processes (threads) known … … 7489 7501 </div> 7490 7502 <div class="refsect1" lang="en" xml:lang="en"> 7491 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30336"></a>7503 <a xmlns="http://www.w3.org/1999/xhtml" id="id552147"></a> 7492 7504 <div class="header">See Also:</div> 7493 7505 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 7517 7529 <div> 7518 7530 <div class="refsect1" lang="en" xml:lang="en"> 7519 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30406"></a>7531 <a xmlns="http://www.w3.org/1999/xhtml" id="id552217"></a> 7520 7532 <div class="header">Arguments and Values:</div> 7521 7533 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string, used to identify the process.</p> … … 7556 7568 </div> 7557 7569 <div class="refsect1" lang="en" xml:lang="en"> 7558 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30591"></a>7570 <a xmlns="http://www.w3.org/1999/xhtml" id="id552403"></a> 7559 7571 <div class="header">Description:</div> 7560 7572 <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a new lisp process (thread) with the … … 7577 7589 </div> 7578 7590 <div class="refsect1" lang="en" xml:lang="en"> 7579 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30643"></a>7591 <a xmlns="http://www.w3.org/1999/xhtml" id="id552455"></a> 7580 7592 <div class="header">See Also:</div> 7581 7593 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span> … … 7596 7608 <div> 7597 7609 <div class="refsect1" lang="en" xml:lang="en"> 7598 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30722"></a>7610 <a xmlns="http://www.w3.org/1999/xhtml" id="id552533"></a> 7599 7611 <div class="header">Arguments and Values:</div> 7600 7612 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7606 7618 </div> 7607 7619 <div class="refsect1" lang="en" xml:lang="en"> 7608 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30776"></a>7620 <a xmlns="http://www.w3.org/1999/xhtml" id="id552587"></a> 7609 7621 <div class="header">Description:</div> 7610 7622 <p xmlns="http://www.w3.org/1999/xhtml">Suspends <em class="varname">process</em>, preventing it from … … 7628 7640 </div> 7629 7641 <div class="refsect1" lang="en" xml:lang="en"> 7630 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30831"></a>7642 <a xmlns="http://www.w3.org/1999/xhtml" id="id552642"></a> 7631 7643 <div class="header">See Also:</div> 7632 7644 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-resume" title="Function PROCESS-RESUME"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a>, <a class="xref" href="#f_process-suspend-count" title="Function PROCESS-SUSPEND-COUNT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a></span> 7633 7645 </div> 7634 7646 <div class="refsect1" lang="en" xml:lang="en"> 7635 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30856"></a>7647 <a xmlns="http://www.w3.org/1999/xhtml" id="id552667"></a> 7636 7648 <div class="header">Notes:</div> 7637 7649 <p xmlns="http://www.w3.org/1999/xhtml"><span class="function"><strong>process-suspend</strong></span> was previously called … … 7659 7671 <div> 7660 7672 <div class="refsect1" lang="en" xml:lang="en"> 7661 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30937"></a>7673 <a xmlns="http://www.w3.org/1999/xhtml" id="id552748"></a> 7662 7674 <div class="header">Arguments and Values:</div> 7663 7675 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7670 7682 </div> 7671 7683 <div class="refsect1" lang="en" xml:lang="en"> 7672 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 30991"></a>7684 <a xmlns="http://www.w3.org/1999/xhtml" id="id552802"></a> 7673 7685 <div class="header">Description:</div> 7674 7686 <p xmlns="http://www.w3.org/1999/xhtml">Undoes the effect of a previous call to … … 7681 7693 </div> 7682 7694 <div class="refsect1" lang="en" xml:lang="en"> 7683 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31022"></a>7695 <a xmlns="http://www.w3.org/1999/xhtml" id="id552833"></a> 7684 7696 <div class="header">See Also:</div> 7685 7697 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a>, <a class="xref" href="#f_process-suspend-count" title="Function PROCESS-SUSPEND-COUNT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend-count</b></a></span> 7686 7698 </div> 7687 7699 <div class="refsect1" lang="en" xml:lang="en"> 7688 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31047"></a>7700 <a xmlns="http://www.w3.org/1999/xhtml" id="id552858"></a> 7689 7701 <div class="header">Notes:</div> 7690 7702 <p xmlns="http://www.w3.org/1999/xhtml"> … … 7712 7724 <div> 7713 7725 <div class="refsect1" lang="en" xml:lang="en"> 7714 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31112"></a>7726 <a xmlns="http://www.w3.org/1999/xhtml" id="id552923"></a> 7715 7727 <div class="header">Arguments and Values:</div> 7716 7728 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7722 7734 </div> 7723 7735 <div class="refsect1" lang="en" xml:lang="en"> 7724 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31165"></a>7736 <a xmlns="http://www.w3.org/1999/xhtml" id="id552976"></a> 7725 7737 <div class="header">Description:</div> 7726 7738 <p xmlns="http://www.w3.org/1999/xhtml">An "outstanding" <a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a> call … … 7737 7749 </div> 7738 7750 <div class="refsect1" lang="en" xml:lang="en"> 7739 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31215"></a>7751 <a xmlns="http://www.w3.org/1999/xhtml" id="id553026"></a> 7740 7752 <div class="header">See Also:</div> 7741 7753 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-suspend" title="Function PROCESS-SUSPEND"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-suspend</b></a>, <a class="xref" href="#f_process-resume" title="Function PROCESS-RESUME"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-resume</b></a></span> … … 7758 7770 <div> 7759 7771 <div class="refsect1" lang="en" xml:lang="en"> 7760 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31291"></a>7772 <a xmlns="http://www.w3.org/1999/xhtml" id="id553102"></a> 7761 7773 <div class="header">Arguments and Values:</div> 7762 7774 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7769 7781 </div> 7770 7782 <div class="refsect1" lang="en" xml:lang="en"> 7771 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31365"></a>7783 <a xmlns="http://www.w3.org/1999/xhtml" id="id553177"></a> 7772 7784 <div class="header">Description:</div> 7773 7785 <p xmlns="http://www.w3.org/1999/xhtml">Typically used to initialize a newly-created or newly-reset … … 7783 7795 </div> 7784 7796 <div class="refsect1" lang="en" xml:lang="en"> 7785 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31409"></a>7797 <a xmlns="http://www.w3.org/1999/xhtml" id="id553220"></a> 7786 7798 <div class="header">See Also:</div> 7787 7799 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span> … … 7804 7816 <div> 7805 7817 <div class="refsect1" lang="en" xml:lang="en"> 7806 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31490"></a>7818 <a xmlns="http://www.w3.org/1999/xhtml" id="id553302"></a> 7807 7819 <div class="header">Arguments and Values:</div> 7808 7820 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7813 7825 </div> 7814 7826 <div class="refsect1" lang="en" xml:lang="en"> 7815 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31552"></a>7827 <a xmlns="http://www.w3.org/1999/xhtml" id="id553364"></a> 7816 7828 <div class="header">Description:</div> 7817 7829 <p xmlns="http://www.w3.org/1999/xhtml">Tries to begin the execution of <em class="varname">process</em>. … … 7830 7842 </div> 7831 7843 <div class="refsect1" lang="en" xml:lang="en"> 7832 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31601"></a>7844 <a xmlns="http://www.w3.org/1999/xhtml" id="id553413"></a> 7833 7845 <div class="header">See Also:</div> 7834 7846 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a></span> 7835 7847 </div> 7836 7848 <div class="refsect1" lang="en" xml:lang="en"> 7837 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31632"></a>7849 <a xmlns="http://www.w3.org/1999/xhtml" id="id553443"></a> 7838 7850 <div class="header">Notes:</div> 7839 7851 <p xmlns="http://www.w3.org/1999/xhtml">It would be nice to have more discussion of what it means … … 7856 7868 <div> 7857 7869 <div class="refsect1" lang="en" xml:lang="en"> 7858 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31747"></a>7870 <a xmlns="http://www.w3.org/1999/xhtml" id="id553559"></a> 7859 7871 <div class="header">Arguments and Values:</div> 7860 7872 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string, used to identify the process. … … 7878 7890 </div> 7879 7891 <div class="refsect1" lang="en" xml:lang="en"> 7880 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31936"></a>7892 <a xmlns="http://www.w3.org/1999/xhtml" id="id553748"></a> 7881 7893 <div class="header">Description:</div> 7882 7894 <p xmlns="http://www.w3.org/1999/xhtml">Creates a lisp process (thread) via … … 7891 7903 </div> 7892 7904 <div class="refsect1" lang="en" xml:lang="en"> 7893 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 31971"></a>7905 <a xmlns="http://www.w3.org/1999/xhtml" id="id553783"></a> 7894 7906 <div class="header">See Also:</div> 7895 7907 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a>, <a class="xref" href="#f_process-preset" title="Function PROCESS-PRESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-preset</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a></span> … … 7912 7924 <div> 7913 7925 <div class="refsect1" lang="en" xml:lang="en"> 7914 <a xmlns="http://www.w3.org/1999/xhtml" id="id51 4384"></a>7926 <a xmlns="http://www.w3.org/1999/xhtml" id="id516619"></a> 7915 7927 <div class="header">Arguments and Values:</div> 7916 7928 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 7925 7937 </div> 7926 7938 <div class="refsect1" lang="en" xml:lang="en"> 7927 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35451"></a>7939 <a xmlns="http://www.w3.org/1999/xhtml" id="id557272"></a> 7928 7940 <div class="header">Description:</div> 7929 7941 <p xmlns="http://www.w3.org/1999/xhtml">Arranges for <em class="varname">process</em> … … 7956 7968 </div> 7957 7969 <div class="refsect1" lang="en" xml:lang="en"> 7958 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35525"></a>7970 <a xmlns="http://www.w3.org/1999/xhtml" id="id557346"></a> 7959 7971 <div class="header">See Also:</div> 7960 7972 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 7965 7977 </div> 7966 7978 <div class="refsect1" lang="en" xml:lang="en"> 7967 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35544"></a>7979 <a xmlns="http://www.w3.org/1999/xhtml" id="id557365"></a> 7968 7980 <div class="header">Notes:</div> 7969 7981 <p xmlns="http://www.w3.org/1999/xhtml">It would probably be better for <em class="varname">result</em> … … 7995 8007 <div> 7996 8008 <div class="refsect1" lang="en" xml:lang="en"> 7997 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35609"></a>8009 <a xmlns="http://www.w3.org/1999/xhtml" id="id557430"></a> 7998 8010 <div class="header">Value Type:</div> 7999 8011 <p xmlns="http://www.w3.org/1999/xhtml">A lisp process (thread).</p> 8000 8012 </div> 8001 8013 <div class="refsect1" lang="en" xml:lang="en"> 8002 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35621"></a>8014 <a xmlns="http://www.w3.org/1999/xhtml" id="id557442"></a> 8003 8015 <div class="header">Initial Value:</div> 8004 8016 <p xmlns="http://www.w3.org/1999/xhtml">Bound separately in each process, to that process itself. … … 8006 8018 </div> 8007 8019 <div class="refsect1" lang="en" xml:lang="en"> 8008 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35632"></a>8020 <a xmlns="http://www.w3.org/1999/xhtml" id="id557453"></a> 8009 8021 <div class="header">Description:</div> 8010 8022 <p xmlns="http://www.w3.org/1999/xhtml">Used when lisp code needs to find out what process it is … … 8012 8024 </div> 8013 8025 <div class="refsect1" lang="en" xml:lang="en"> 8014 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35644"></a>8026 <a xmlns="http://www.w3.org/1999/xhtml" id="id557465"></a> 8015 8027 <div class="header">See Also:</div> 8016 8028 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 8036 8048 <div> 8037 8049 <div class="refsect1" lang="en" xml:lang="en"> 8038 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35714"></a>8050 <a xmlns="http://www.w3.org/1999/xhtml" id="id557535"></a> 8039 8051 <div class="header">Arguments and Values:</div> 8040 8052 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 8043 8055 </div> 8044 8056 <div class="refsect1" lang="en" xml:lang="en"> 8045 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35771"></a>8057 <a xmlns="http://www.w3.org/1999/xhtml" id="id557592"></a> 8046 8058 <div class="header">Description:</div> 8047 8059 <p xmlns="http://www.w3.org/1999/xhtml">Causes <em class="varname">process</em> to cleanly exit … … 8070 8082 </div> 8071 8083 <div class="refsect1" lang="en" xml:lang="en"> 8072 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35838"></a>8084 <a xmlns="http://www.w3.org/1999/xhtml" id="id557659"></a> 8073 8085 <div class="header">See Also:</div> 8074 8086 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-kill" title="Function PROCESS-KILL"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-kill</b></a>, <a class="xref" href="#f_process-abort" title="Function PROCESS-ABORT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span> … … 8090 8102 <div> 8091 8103 <div class="refsect1" lang="en" xml:lang="en"> 8092 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35911"></a>8104 <a xmlns="http://www.w3.org/1999/xhtml" id="id557733"></a> 8093 8105 <div class="header">Arguments and Values:</div> 8094 8106 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread), which … … 8097 8109 </div> 8098 8110 <div class="refsect1" lang="en" xml:lang="en"> 8099 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35953"></a>8111 <a xmlns="http://www.w3.org/1999/xhtml" id="id557774"></a> 8100 8112 <div class="header">Description:</div> 8101 8113 <p xmlns="http://www.w3.org/1999/xhtml"> … … 8105 8117 </div> 8106 8118 <div class="refsect1" lang="en" xml:lang="en"> 8107 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 35965"></a>8119 <a xmlns="http://www.w3.org/1999/xhtml" id="id557786"></a> 8108 8120 <div class="header">See Also:</div> 8109 8121 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-reset" title="Function PROCESS-RESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a class="xref" href="#f_process-enable" title="Function PROCESS-ENABLE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-enable</b></a></span> … … 8125 8137 <div> 8126 8138 <div class="refsect1" lang="en" xml:lang="en"> 8127 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36038"></a>8139 <a xmlns="http://www.w3.org/1999/xhtml" id="id557860"></a> 8128 8140 <div class="header">Arguments and Values:</div> 8129 8141 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 8131 8143 </div> 8132 8144 <div class="refsect1" lang="en" xml:lang="en"> 8133 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36079"></a>8145 <a xmlns="http://www.w3.org/1999/xhtml" id="id557901"></a> 8134 8146 <div class="header">Description:</div> 8135 8147 <p xmlns="http://www.w3.org/1999/xhtml"> … … 8139 8151 </div> 8140 8152 <div class="refsect1" lang="en" xml:lang="en"> 8141 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36094"></a>8153 <a xmlns="http://www.w3.org/1999/xhtml" id="id557916"></a> 8142 8154 <div class="header">See Also:</div> 8143 8155 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-reset" title="Function PROCESS-RESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a class="xref" href="#f_process-abort" title="Function PROCESS-ABORT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-abort</b></a></span> … … 8161 8173 <div> 8162 8174 <div class="refsect1" lang="en" xml:lang="en"> 8163 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36177"></a>8175 <a xmlns="http://www.w3.org/1999/xhtml" id="id557999"></a> 8164 8176 <div class="header">Arguments and Values:</div> 8165 8177 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a lisp process (thread).</p> … … 8167 8179 </div> 8168 8180 <div class="refsect1" lang="en" xml:lang="en"> 8169 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36218"></a>8181 <a xmlns="http://www.w3.org/1999/xhtml" id="id558041"></a> 8170 8182 <div class="header">Description:</div> 8171 8183 <p xmlns="http://www.w3.org/1999/xhtml">Entirely equivalent to calling … … 8181 8193 </div> 8182 8194 <div class="refsect1" lang="en" xml:lang="en"> 8183 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36282"></a>8195 <a xmlns="http://www.w3.org/1999/xhtml" id="id558104"></a> 8184 8196 <div class="header">See Also:</div> 8185 8197 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-reset" title="Function PROCESS-RESET"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-reset</b></a>, <a class="xref" href="#f_process-kill" title="Function PROCESS-KILL"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-kill</b></a></span> … … 8200 8212 <div> 8201 8213 <div class="refsect1" lang="en" xml:lang="en"> 8202 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36340"></a>8214 <a xmlns="http://www.w3.org/1999/xhtml" id="id558163"></a> 8203 8215 <div class="header">Value Type:</div> 8204 8216 <p xmlns="http://www.w3.org/1999/xhtml">A positive integer.</p> 8205 8217 </div> 8206 8218 <div class="refsect1" lang="en" xml:lang="en"> 8207 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36351"></a>8219 <a xmlns="http://www.w3.org/1999/xhtml" id="id558174"></a> 8208 8220 <div class="header">Initial Value:</div> 8209 8221 <p xmlns="http://www.w3.org/1999/xhtml">The clock resolution of the OS scheduler. Currently, … … 8212 8224 </div> 8213 8225 <div class="refsect1" lang="en" xml:lang="en"> 8214 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36364"></a>8226 <a xmlns="http://www.w3.org/1999/xhtml" id="id558186"></a> 8215 8227 <div class="header">Description:</div> 8216 8228 <p xmlns="http://www.w3.org/1999/xhtml">This value is ordinarily of marginal interest at best, … … 8220 8232 </div> 8221 8233 <div class="refsect1" lang="en" xml:lang="en"> 8222 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36376"></a>8234 <a xmlns="http://www.w3.org/1999/xhtml" id="id558199"></a> 8223 8235 <div class="header">See Also:</div> 8224 8236 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 8244 8256 <div> 8245 8257 <div class="refsect1" lang="en" xml:lang="en"> 8246 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36481"></a>8258 <a xmlns="http://www.w3.org/1999/xhtml" id="id558304"></a> 8247 8259 <div class="header">Description:</div> 8248 8260 <p xmlns="http://www.w3.org/1999/xhtml">This information is primarily for the benefit of … … 8258 8270 </div> 8259 8271 <div class="refsect1" lang="en" xml:lang="en"> 8260 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36524"></a>8272 <a xmlns="http://www.w3.org/1999/xhtml" id="id558347"></a> 8261 8273 <div class="header">See Also:</div> 8262 8274 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-wait" title="Function PROCESS-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a class="xref" href="#f_process-wait-with-timeout" title="Function PROCESS-WAIT-WITH-TIMEOUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait-with-timeout</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 8263 8275 </div> 8264 8276 <div class="refsect1" lang="en" xml:lang="en"> 8265 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36555"></a>8277 <a xmlns="http://www.w3.org/1999/xhtml" id="id558377"></a> 8266 8278 <div class="header">Notes:</div> 8267 8279 <p xmlns="http://www.w3.org/1999/xhtml">This should arguably be SETFable, but doesn't seem to … … 8287 8299 <div> 8288 8300 <div class="refsect1" lang="en" xml:lang="en"> 8289 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36614"></a>8301 <a xmlns="http://www.w3.org/1999/xhtml" id="id558436"></a> 8290 8302 <div class="header">Description:</div> 8291 8303 <p xmlns="http://www.w3.org/1999/xhtml">Advises the OS scheduler that the current thread has nothing … … 8296 8308 </div> 8297 8309 <div class="refsect1" lang="en" xml:lang="en"> 8298 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36627"></a>8310 <a xmlns="http://www.w3.org/1999/xhtml" id="id558450"></a> 8299 8311 <div class="header">See Also:</div> 8300 8312 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 8301 8313 </div> 8302 8314 <div class="refsect1" lang="en" xml:lang="en"> 8303 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36675"></a>8315 <a xmlns="http://www.w3.org/1999/xhtml" id="id558498"></a> 8304 8316 <div class="header">Notes:</div> 8305 8317 <p xmlns="http://www.w3.org/1999/xhtml">This is a holdover from the days of cooperative … … 8324 8336 <div> 8325 8337 <div class="refsect1" lang="en" xml:lang="en"> 8326 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36740"></a>8338 <a xmlns="http://www.w3.org/1999/xhtml" id="id558562"></a> 8327 8339 <div class="header">Arguments and Values:</div> 8328 8340 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">whostate</span></i>---a string, which will be the value of … … 8337 8349 </div> 8338 8350 <div class="refsect1" lang="en" xml:lang="en"> 8339 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36819"></a>8351 <a xmlns="http://www.w3.org/1999/xhtml" id="id558642"></a> 8340 8352 <div class="header">Description:</div> 8341 8353 <p xmlns="http://www.w3.org/1999/xhtml">Causes the current lisp process (thread) to repeatedly … … 8354 8366 </div> 8355 8367 <div class="refsect1" lang="en" xml:lang="en"> 8356 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36855"></a>8368 <a xmlns="http://www.w3.org/1999/xhtml" id="id558678"></a> 8357 8369 <div class="header">See Also:</div> 8358 8370 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_process-whostate" title="Function PROCESS-WHOSTATE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>, <a class="xref" href="#f_process-wait-with-timeout" title="Function PROCESS-WAIT-WITH-TIMEOUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait-with-timeout</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8374 8386 <div> 8375 8387 <div class="refsect1" lang="en" xml:lang="en"> 8376 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 36963"></a>8388 <a xmlns="http://www.w3.org/1999/xhtml" id="id558786"></a> 8377 8389 <div class="header">Arguments and Values:</div> 8378 8390 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">whostate</span></i>---a string, which will be the value of … … 8392 8404 </div> 8393 8405 <div class="refsect1" lang="en" xml:lang="en"> 8394 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37078"></a>8406 <a xmlns="http://www.w3.org/1999/xhtml" id="id558900"></a> 8395 8407 <div class="header">Description:</div> 8396 8408 <p xmlns="http://www.w3.org/1999/xhtml">If <em class="varname">ticks</em> is NIL, behaves exactly like … … 8409 8421 </div> 8410 8422 <div class="refsect1" lang="en" xml:lang="en"> 8411 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37128"></a>8423 <a xmlns="http://www.w3.org/1999/xhtml" id="id558950"></a> 8412 8424 <div class="header">See Also:</div> 8413 8425 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#v_ticks-per-second" title="Variable *TICKS-PER-SECOND*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*ticks-per-second*</b></a>, <a class="xref" href="#f_process-whostate" title="Function PROCESS-WHOSTATE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-whostate</b></a>, <a class="xref" href="#f_process-wait" title="Function PROCESS-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-wait</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8429 8441 <div> 8430 8442 <div class="refsect1" lang="en" xml:lang="en"> 8431 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37245"></a>8443 <a xmlns="http://www.w3.org/1999/xhtml" id="id559067"></a> 8432 8444 <div class="header">Arguments and Values:</div> 8433 8445 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">body</span></i>---an implicit progn.</p> … … 8436 8448 </div> 8437 8449 <div class="refsect1" lang="en" xml:lang="en"> 8438 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37289"></a>8450 <a xmlns="http://www.w3.org/1999/xhtml" id="id559112"></a> 8439 8451 <div class="header">Description:</div> 8440 8452 <p xmlns="http://www.w3.org/1999/xhtml">Executes <em class="varname">body</em> … … 8451 8463 </div> 8452 8464 <div class="refsect1" lang="en" xml:lang="en"> 8453 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37321"></a>8465 <a xmlns="http://www.w3.org/1999/xhtml" id="id559143"></a> 8454 8466 <div class="header">See Also:</div> 8455 8467 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 8475 8487 <div> 8476 8488 <div class="refsect1" lang="en" xml:lang="en"> 8477 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37392"></a>8489 <a xmlns="http://www.w3.org/1999/xhtml" id="id559215"></a> 8478 8490 <div class="header">Arguments and Values:</div> 8479 8491 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">body</span></i>---an implicit progn.</p> … … 8482 8494 </div> 8483 8495 <div class="refsect1" lang="en" xml:lang="en"> 8484 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50492"></a>8496 <a xmlns="http://www.w3.org/1999/xhtml" id="id572336"></a> 8485 8497 <div class="header">Description:</div> 8486 8498 <p xmlns="http://www.w3.org/1999/xhtml">Executes <em class="varname">body</em> … … 8505 8517 <div> 8506 8518 <div class="refsect1" lang="en" xml:lang="en"> 8507 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50553"></a>8519 <a xmlns="http://www.w3.org/1999/xhtml" id="id572398"></a> 8508 8520 <div class="header">Arguments and Values:</div> 8509 8521 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---any lisp object; saved as part of … … 8515 8527 </div> 8516 8528 <div class="refsect1" lang="en" xml:lang="en"> 8517 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50599"></a>8529 <a xmlns="http://www.w3.org/1999/xhtml" id="id572444"></a> 8518 8530 <div class="header">Description:</div> 8519 8531 <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a lock object, which can … … 8525 8537 </div> 8526 8538 <div class="refsect1" lang="en" xml:lang="en"> 8527 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50614"></a>8539 <a xmlns="http://www.w3.org/1999/xhtml" id="id572459"></a> 8528 8540 <div class="header">See Also:</div> 8529 8541 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8545 8557 <div> 8546 8558 <div class="refsect1" lang="en" xml:lang="en"> 8547 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50717"></a>8559 <a xmlns="http://www.w3.org/1999/xhtml" id="id572562"></a> 8548 8560 <div class="header">Arguments and Values:</div> 8549 8561 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p> … … 8553 8565 </div> 8554 8566 <div class="refsect1" lang="en" xml:lang="en"> 8555 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50768"></a>8567 <a xmlns="http://www.w3.org/1999/xhtml" id="id572614"></a> 8556 8568 <div class="header">Description:</div> 8557 8569 <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">lock</em> is either free or … … 8564 8576 </div> 8565 8577 <div class="refsect1" lang="en" xml:lang="en"> 8566 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50798"></a>8578 <a xmlns="http://www.w3.org/1999/xhtml" id="id572643"></a> 8567 8579 <div class="header">See Also:</div> 8568 8580 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8583 8595 <div> 8584 8596 <div class="refsect1" lang="en" xml:lang="en"> 8585 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50898"></a>8597 <a xmlns="http://www.w3.org/1999/xhtml" id="id572743"></a> 8586 8598 <div class="header">Arguments and Values:</div> 8587 8599 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p> 8588 8600 </div> 8589 8601 <div class="refsect1" lang="en" xml:lang="en"> 8590 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50920"></a>8602 <a xmlns="http://www.w3.org/1999/xhtml" id="id572765"></a> 8591 8603 <div class="header">Description:</div> 8592 8604 <p xmlns="http://www.w3.org/1999/xhtml">Blocks until <em class="varname">lock</em> is owned by the … … 8599 8611 </div> 8600 8612 <div class="refsect1" lang="en" xml:lang="en"> 8601 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 50953"></a>8613 <a xmlns="http://www.w3.org/1999/xhtml" id="id572798"></a> 8602 8614 <div class="header">See Also:</div> 8603 8615 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8617 8629 <div> 8618 8630 <div class="refsect1" lang="en" xml:lang="en"> 8619 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51053"></a>8631 <a xmlns="http://www.w3.org/1999/xhtml" id="id572898"></a> 8620 8632 <div class="header">Arguments and Values:</div> 8621 8633 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p> 8622 8634 </div> 8623 8635 <div class="refsect1" lang="en" xml:lang="en"> 8624 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51075"></a>8636 <a xmlns="http://www.w3.org/1999/xhtml" id="id572920"></a> 8625 8637 <div class="header">Description:</div> 8626 8638 <p xmlns="http://www.w3.org/1999/xhtml">Signals an error of type CCL:LOCK-NOT-OWNER if … … 8635 8647 </div> 8636 8648 <div class="refsect1" lang="en" xml:lang="en"> 8637 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51109"></a>8649 <a xmlns="http://www.w3.org/1999/xhtml" id="id572954"></a> 8638 8650 <div class="header">See Also:</div> 8639 8651 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_try-lock" title="Function TRY-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">try-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8654 8666 <div> 8655 8667 <div class="refsect1" lang="en" xml:lang="en"> 8656 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51209"></a>8668 <a xmlns="http://www.w3.org/1999/xhtml" id="id573054"></a> 8657 8669 <div class="header">Arguments and Values:</div> 8658 8670 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">lock</span></i>---an object of type CCL:LOCK.</p> … … 8661 8673 </div> 8662 8674 <div class="refsect1" lang="en" xml:lang="en"> 8663 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51247"></a>8675 <a xmlns="http://www.w3.org/1999/xhtml" id="id573092"></a> 8664 8676 <div class="header">Description:</div> 8665 8677 <p xmlns="http://www.w3.org/1999/xhtml">Tests whether <em class="varname">lock</em> … … 8674 8686 </div> 8675 8687 <div class="refsect1" lang="en" xml:lang="en"> 8676 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51270"></a>8688 <a xmlns="http://www.w3.org/1999/xhtml" id="id573116"></a> 8677 8689 <div class="header">See Also:</div> 8678 8690 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#m_with-lock-grabbed" title="Macro WITH-LOCK-GRABBED"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-lock-grabbed</b></a>, <a class="xref" href="#f_grab-lock" title="Function GRAB-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">grab-lock</b></a>, <a class="xref" href="#f_release-lock" title="Function RELEASE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">release-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8694 8706 <div> 8695 8707 <div class="refsect1" lang="en" xml:lang="en"> 8696 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51371"></a>8708 <a xmlns="http://www.w3.org/1999/xhtml" id="id573216"></a> 8697 8709 <div class="header">Arguments and Values:</div> 8698 8710 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---a newly-allocated object of type … … 8700 8712 </div> 8701 8713 <div class="refsect1" lang="en" xml:lang="en"> 8702 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51394"></a>8714 <a xmlns="http://www.w3.org/1999/xhtml" id="id573239"></a> 8703 8715 <div class="header">Description:</div> 8704 8716 <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns an object of type CCL::READ-WRITE-LOCK. … … 8711 8723 </div> 8712 8724 <div class="refsect1" lang="en" xml:lang="en"> 8713 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51410"></a>8725 <a xmlns="http://www.w3.org/1999/xhtml" id="id573255"></a> 8714 8726 <div class="header">See Also:</div> 8715 8727 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-read-lock" title="Macro WITH-READ-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a>, <a class="xref" href="#m_with-write-lock" title="Macro WITH-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 8716 8728 </div> 8717 8729 <div class="refsect1" lang="en" xml:lang="en"> 8718 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51458"></a>8730 <a xmlns="http://www.w3.org/1999/xhtml" id="id573303"></a> 8719 8731 <div class="header">Notes:</div> 8720 8732 <p xmlns="http://www.w3.org/1999/xhtml">There probably should be some way to … … 8739 8751 <div> 8740 8752 <div class="refsect1" lang="en" xml:lang="en"> 8741 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51514"></a>8753 <a xmlns="http://www.w3.org/1999/xhtml" id="id573359"></a> 8742 8754 <div class="header">Arguments and Values:</div> 8743 8755 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---an object of type … … 8748 8760 </div> 8749 8761 <div class="refsect1" lang="en" xml:lang="en"> 8750 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51565"></a>8762 <a xmlns="http://www.w3.org/1999/xhtml" id="id573410"></a> 8751 8763 <div class="header">Description:</div> 8752 8764 <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">read-write-lock</em> has no … … 8762 8774 </div> 8763 8775 <div class="refsect1" lang="en" xml:lang="en"> 8764 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51605"></a>8776 <a xmlns="http://www.w3.org/1999/xhtml" id="id573450"></a> 8765 8777 <div class="header">See Also:</div> 8766 8778 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#m_with-write-lock" title="Macro WITH-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-write-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8782 8794 <div> 8783 8795 <div class="refsect1" lang="en" xml:lang="en"> 8784 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51698"></a>8796 <a xmlns="http://www.w3.org/1999/xhtml" id="id573543"></a> 8785 8797 <div class="header">Arguments and Values:</div> 8786 8798 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">read-write-lock</span></i>---an object of type … … 8791 8803 </div> 8792 8804 <div class="refsect1" lang="en" xml:lang="en"> 8793 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51749"></a>8805 <a xmlns="http://www.w3.org/1999/xhtml" id="id573595"></a> 8794 8806 <div class="header">Description:</div> 8795 8807 <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">read-write-lock</em> has no … … 8806 8818 </div> 8807 8819 <div class="refsect1" lang="en" xml:lang="en"> 8808 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51794"></a>8820 <a xmlns="http://www.w3.org/1999/xhtml" id="id573639"></a> 8809 8821 <div class="header">See Also:</div> 8810 8822 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#m_with-read-lock" title="Macro WITH-READ-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-read-lock</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8826 8838 <div> 8827 8839 <div class="refsect1" lang="en" xml:lang="en"> 8828 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51884"></a>8840 <a xmlns="http://www.w3.org/1999/xhtml" id="id573729"></a> 8829 8841 <div class="header">Arguments and Values:</div> 8830 8842 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---a newly-allocated object of type CCL:SEMAPHORE.</p> 8831 8843 </div> 8832 8844 <div class="refsect1" lang="en" xml:lang="en"> 8833 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51906"></a>8845 <a xmlns="http://www.w3.org/1999/xhtml" id="id573752"></a> 8834 8846 <div class="header">Description:</div> 8835 8847 <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns an object of type CCL:SEMAPHORE. … … 8840 8852 </div> 8841 8853 <div class="refsect1" lang="en" xml:lang="en"> 8842 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 51922"></a>8854 <a xmlns="http://www.w3.org/1999/xhtml" id="id573767"></a> 8843 8855 <div class="header">See Also:</div> 8844 8856 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_signal-semaphore" title="Function SIGNAL-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8860 8872 <div> 8861 8873 <div class="refsect1" lang="en" xml:lang="en"> 8862 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52016"></a>8874 <a xmlns="http://www.w3.org/1999/xhtml" id="id573862"></a> 8863 8875 <div class="header">Arguments and Values:</div> 8864 8876 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p> … … 8867 8879 </div> 8868 8880 <div class="refsect1" lang="en" xml:lang="en"> 8869 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52053"></a>8881 <a xmlns="http://www.w3.org/1999/xhtml" id="id573898"></a> 8870 8882 <div class="header">Description:</div> 8871 8883 <p xmlns="http://www.w3.org/1999/xhtml">Atomically increments <em class="varname">semaphore</em>'s … … 8874 8886 </div> 8875 8887 <div class="refsect1" lang="en" xml:lang="en"> 8876 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52066"></a>8888 <a xmlns="http://www.w3.org/1999/xhtml" id="id573911"></a> 8877 8889 <div class="header">See Also:</div> 8878 8890 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 8879 8891 </div> 8880 8892 <div class="refsect1" lang="en" xml:lang="en"> 8881 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52119"></a>8893 <a xmlns="http://www.w3.org/1999/xhtml" id="id573965"></a> 8882 8894 <div class="header">Notes:</div> 8883 8895 <p xmlns="http://www.w3.org/1999/xhtml"><em class="varname">result</em> should probably be interpreted … … 8902 8914 <div> 8903 8915 <div class="refsect1" lang="en" xml:lang="en"> 8904 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52179"></a>8916 <a xmlns="http://www.w3.org/1999/xhtml" id="id574025"></a> 8905 8917 <div class="header">Arguments and Values:</div> 8906 8918 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---an object of type CCL:SEMAPHORE.</p> … … 8909 8921 </div> 8910 8922 <div class="refsect1" lang="en" xml:lang="en"> 8911 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52216"></a>8923 <a xmlns="http://www.w3.org/1999/xhtml" id="id574061"></a> 8912 8924 <div class="header">Description:</div> 8913 8925 <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">semaphore</em> … … 8917 8929 </div> 8918 8930 <div class="refsect1" lang="en" xml:lang="en"> 8919 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52230"></a>8931 <a xmlns="http://www.w3.org/1999/xhtml" id="id574075"></a> 8920 8932 <div class="header">See Also:</div> 8921 8933 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_signal-semaphore" title="Function SIGNAL-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">signal-semaphore</b></a>, <a class="xref" href="#f_timed-wait-on-semaphore" title="Function TIMED-WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">timed-wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 8922 8934 </div> 8923 8935 <div class="refsect1" lang="en" xml:lang="en"> 8924 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52283"></a>8936 <a xmlns="http://www.w3.org/1999/xhtml" id="id574128"></a> 8925 8937 <div class="header">Notes:</div> 8926 8938 <p xmlns="http://www.w3.org/1999/xhtml"><em class="varname">result</em> should probably be interpreted … … 8946 8958 <div> 8947 8959 <div class="refsect1" lang="en" xml:lang="en"> 8948 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52343"></a>8960 <a xmlns="http://www.w3.org/1999/xhtml" id="id574188"></a> 8949 8961 <div class="header">Arguments and Values:</div> 8950 8962 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">semaphore</span></i>---An object of type CCL:SEMAPHORE.</p> … … 8959 8971 </div> 8960 8972 <div class="refsect1" lang="en" xml:lang="en"> 8961 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52410"></a>8973 <a xmlns="http://www.w3.org/1999/xhtml" id="id574255"></a> 8962 8974 <div class="header">Description:</div> 8963 8975 <p xmlns="http://www.w3.org/1999/xhtml">Waits until <em class="varname">semaphore</em> … … 8968 8980 </div> 8969 8981 <div class="refsect1" lang="en" xml:lang="en"> 8970 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52427"></a>8982 <a xmlns="http://www.w3.org/1999/xhtml" id="id574272"></a> 8971 8983 <div class="header">See Also:</div> 8972 8984 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_wait-on-semaphore" title="Function WAIT-ON-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">wait-on-semaphore</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> … … 8988 9000 <div> 8989 9001 <div class="refsect1" lang="en" xml:lang="en"> 8990 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52519"></a>9002 <a xmlns="http://www.w3.org/1999/xhtml" id="id574365"></a> 8991 9003 <div class="header">Arguments and Values:</div> 8992 9004 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">fd</span></i>---a file descriptor, which is a non-negative integer … … 8996 9008 </div> 8997 9009 <div class="refsect1" lang="en" xml:lang="en"> 8998 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52561"></a>9010 <a xmlns="http://www.w3.org/1999/xhtml" id="id574406"></a> 8999 9011 <div class="header">Description:</div> 9000 9012 <p xmlns="http://www.w3.org/1999/xhtml">Wait until input is available on <em class="varname">fd</em>. … … 9012 9024 </div> 9013 9025 <div class="refsect1" lang="en" xml:lang="en"> 9014 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52594"></a>9026 <a xmlns="http://www.w3.org/1999/xhtml" id="id574439"></a> 9015 9027 <div class="header">See Also:</div> 9016 9028 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 9017 9029 </div> 9018 9030 <div class="refsect1" lang="en" xml:lang="en"> 9019 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52632"></a>9031 <a xmlns="http://www.w3.org/1999/xhtml" id="id574477"></a> 9020 9032 <div class="header">Notes:</div> 9021 9033 <p xmlns="http://www.w3.org/1999/xhtml"> … … 9042 9054 <div> 9043 9055 <div class="refsect1" lang="en" xml:lang="en"> 9044 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52696"></a>9056 <a xmlns="http://www.w3.org/1999/xhtml" id="id574542"></a> 9045 9057 <div class="header">Arguments and Values:</div> 9046 9058 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">fd</span></i>---a file descriptor, which is a non-negative integer … … 9050 9062 </div> 9051 9063 <div class="refsect1" lang="en" xml:lang="en"> 9052 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52738"></a>9064 <a xmlns="http://www.w3.org/1999/xhtml" id="id574583"></a> 9053 9065 <div class="header">Description:</div> 9054 9066 <p xmlns="http://www.w3.org/1999/xhtml">Wait until output is possible on <em class="varname">fd</em> or until <em class="varname">timeout</em>, if … … 9063 9075 </div> 9064 9076 <div class="refsect1" lang="en" xml:lang="en"> 9065 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52771"></a>9077 <a xmlns="http://www.w3.org/1999/xhtml" id="id574616"></a> 9066 9078 <div class="header">See Also:</div> 9067 9079 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a></span> 9068 9080 </div> 9069 9081 <div class="refsect1" lang="en" xml:lang="en"> 9070 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52809"></a>9082 <a xmlns="http://www.w3.org/1999/xhtml" id="id574654"></a> 9071 9083 <div class="header">Notes:</div> 9072 9084 <p xmlns="http://www.w3.org/1999/xhtml"> … … 9093 9105 <div> 9094 9106 <div class="refsect1" lang="en" xml:lang="en"> 9095 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52873"></a>9107 <a xmlns="http://www.w3.org/1999/xhtml" id="id574719"></a> 9096 9108 <div class="header">Arguments and Values:</div> 9097 9109 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">body</span></i>---an implicit progn.</p> … … 9100 9112 </div> 9101 9113 <div class="refsect1" lang="en" xml:lang="en"> 9102 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52912"></a>9114 <a xmlns="http://www.w3.org/1999/xhtml" id="id574757"></a> 9103 9115 <div class="header">Description:</div> 9104 9116 <p xmlns="http://www.w3.org/1999/xhtml">Requests exclusive read access to the standard terminal … … 9108 9120 </div> 9109 9121 <div class="refsect1" lang="en" xml:lang="en"> 9110 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 52928"></a>9122 <a xmlns="http://www.w3.org/1999/xhtml" id="id574774"></a> 9111 9123 <div class="header">See Also:</div> 9112 9124 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#v_request-terminal-input-via-break" title="Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*request-terminal-input-via-break*</b></a>, <a class="xref" href="#cmd_y" title="Toplevel Command :Y"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span> … … 9127 9139 <div> 9128 9140 <div class="refsect1" lang="en" xml:lang="en"> 9129 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53006"></a>9141 <a xmlns="http://www.w3.org/1999/xhtml" id="id574851"></a> 9130 9142 <div class="header">Value Type:</div> 9131 9143 <p xmlns="http://www.w3.org/1999/xhtml">A boolean.</p> 9132 9144 </div> 9133 9145 <div class="refsect1" lang="en" xml:lang="en"> 9134 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53015"></a>9146 <a xmlns="http://www.w3.org/1999/xhtml" id="id574860"></a> 9135 9147 <div class="header">Initial Value:</div> 9136 9148 <p xmlns="http://www.w3.org/1999/xhtml">NIL.</p> 9137 9149 </div> 9138 9150 <div class="refsect1" lang="en" xml:lang="en"> 9139 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53025"></a>9151 <a xmlns="http://www.w3.org/1999/xhtml" id="id574870"></a> 9140 9152 <div class="header">Description:</div> 9141 9153 <p xmlns="http://www.w3.org/1999/xhtml">Controls how attempts to obtain ownership of terminal input … … 9149 9161 </div> 9150 9162 <div class="refsect1" lang="en" xml:lang="en"> 9151 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53039"></a>9163 <a xmlns="http://www.w3.org/1999/xhtml" id="id574884"></a> 9152 9164 <div class="header">See Also:</div> 9153 9165 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a>, <a class="xref" href="#cmd_y" title="Toplevel Command :Y"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">:y</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span> … … 9168 9180 <div> 9169 9181 <div class="refsect1" lang="en" xml:lang="en"> 9170 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53129"></a>9182 <a xmlns="http://www.w3.org/1999/xhtml" id="id574975"></a> 9171 9183 <div class="header">Arguments and Values:</div> 9172 9184 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">p</span></i>---a lisp process (thread), designated either by … … 9177 9189 </div> 9178 9190 <div class="refsect1" lang="en" xml:lang="en"> 9179 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53168"></a>9191 <a xmlns="http://www.w3.org/1999/xhtml" id="id575014"></a> 9180 9192 <div class="header">Description:</div> 9181 9193 <p xmlns="http://www.w3.org/1999/xhtml">:Y is a toplevel command, not a function. As such, it … … 9188 9200 </div> 9189 9201 <div class="refsect1" lang="en" xml:lang="en"> 9190 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53190"></a>9202 <a xmlns="http://www.w3.org/1999/xhtml" id="id575036"></a> 9191 9203 <div class="header">See Also:</div> 9192 9204 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#m_with-terminal-input" title="Macro WITH-TERMINAL-INPUT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">with-terminal-input</b></a>, <a class="xref" href="#v_request-terminal-input-via-break" title="Variable *REQUEST-TERMINAL-INPUT-VIA-BREAK*"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">*request-terminal-input-via-break*</b></a>, <a class="xref" href="#f_make-lock" title="Function MAKE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-lock</b></a>, <a class="xref" href="#f_make-read-write-lock" title="Function MAKE-READ-WRITE-LOCK"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-read-write-lock</b></a>, <a class="xref" href="#f_make-semaphore" title="Function MAKE-SEMAPHORE"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-semaphore</b></a>, <a class="xref" href="#f_process-input-wait" title="Function PROCESS-INPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-input-wait</b></a>, <a class="xref" href="#f_process-output-wait" title="Function PROCESS-OUTPUT-WAIT"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-output-wait</b></a></span> … … 9209 9221 <div> 9210 9222 <div class="refsect1" lang="en" xml:lang="en"> 9211 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53284"></a>9223 <a xmlns="http://www.w3.org/1999/xhtml" id="id575129"></a> 9212 9224 <div class="header">Arguments and Values:</div> 9213 9225 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">process</span></i>---a process, typically created by <a xmlns="http://www.w3.org/1999/xhtml" class="xref" href="#f_process-run-function" title="Function PROCESS-RUN-FUNCTION"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">process-run-function</b></a> or by <a xmlns="http://www.w3.org/1999/xhtml" class="xref" href="#f_make-process" title="Function MAKE-PROCESS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">make-process</b></a></p> … … 9219 9231 </div> 9220 9232 <div class="refsect1" lang="en" xml:lang="en"> 9221 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53341"></a>9233 <a xmlns="http://www.w3.org/1999/xhtml" id="id575186"></a> 9222 9234 <div class="header">Description:</div> 9223 9235 <p xmlns="http://www.w3.org/1999/xhtml">Waits for the specified process to terminate. If the … … 9360 9372 <div> 9361 9373 <div class="refsect1" lang="en" xml:lang="en"> 9362 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38486"></a>9374 <a xmlns="http://www.w3.org/1999/xhtml" id="id560322"></a> 9363 9375 <div class="header">Arguments and Values:</div> 9364 9376 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">address-family</span></i>---The address/protocol family of this socket. Currently … … 9460 9472 </div> 9461 9473 <div class="refsect1" lang="en" xml:lang="en"> 9462 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 27152"></a>9474 <a xmlns="http://www.w3.org/1999/xhtml" id="id548877"></a> 9463 9475 <div class="header">Description:</div> 9464 9476 <p xmlns="http://www.w3.org/1999/xhtml">Creates and returns a new socket</p> … … 9479 9491 <div> 9480 9492 <div class="refsect1" lang="en" xml:lang="en"> 9481 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34460"></a>9493 <a xmlns="http://www.w3.org/1999/xhtml" id="id548939"></a> 9482 9494 <div class="header">Arguments and Values:</div> 9483 9495 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The listener-socket to listen on.</p> … … 9487 9499 </div> 9488 9500 <div class="refsect1" lang="en" xml:lang="en"> 9489 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34503"></a>9501 <a xmlns="http://www.w3.org/1999/xhtml" id="id548981"></a> 9490 9502 <div class="header">Description:</div> 9491 9503 <p xmlns="http://www.w3.org/1999/xhtml">Extracts the first connection on the queue of pending … … 9513 9525 <div> 9514 9526 <div class="refsect1" lang="en" xml:lang="en"> 9515 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34568"></a>9527 <a xmlns="http://www.w3.org/1999/xhtml" id="id546997"></a> 9516 9528 <div class="header">Arguments and Values:</div> 9517 9529 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dotted</span></i>---A string representing an IP address in the … … 9521 9533 </div> 9522 9534 <div class="refsect1" lang="en" xml:lang="en"> 9523 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34609"></a>9535 <a xmlns="http://www.w3.org/1999/xhtml" id="id547039"></a> 9524 9536 <div class="header">Description:</div> 9525 9537 <p xmlns="http://www.w3.org/1999/xhtml">Converts a dotted-string representation of a host address to … … 9541 9553 <div> 9542 9554 <div class="refsect1" lang="en" xml:lang="en"> 9543 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34671"></a>9555 <a xmlns="http://www.w3.org/1999/xhtml" id="id547101"></a> 9544 9556 <div class="header">Arguments and Values:</div> 9545 9557 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ipaddr</span></i>---A 32-bit integer representing an internet host address</p> … … 9550 9562 </div> 9551 9563 <div class="refsect1" lang="en" xml:lang="en"> 9552 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34713"></a>9564 <a xmlns="http://www.w3.org/1999/xhtml" id="id547143"></a> 9553 9565 <div class="header">Description:</div> 9554 9566 <p xmlns="http://www.w3.org/1999/xhtml">Converts a 32-bit unsigned IP address into octets.</p> … … 9569 9581 <div> 9570 9582 <div class="refsect1" lang="en" xml:lang="en"> 9571 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34774"></a>9583 <a xmlns="http://www.w3.org/1999/xhtml" id="id547204"></a> 9572 9584 <div class="header">Arguments and Values:</div> 9573 9585 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ipaddr</span></i>---a 32-bit integer representing an internet host address</p> … … 9576 9588 </div> 9577 9589 <div class="refsect1" lang="en" xml:lang="en"> 9578 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34815"></a>9590 <a xmlns="http://www.w3.org/1999/xhtml" id="id547244"></a> 9579 9591 <div class="header">Description:</div> 9580 9592 <p xmlns="http://www.w3.org/1999/xhtml">Converts a 32-bit unsigned IP address into a host name … … 9596 9608 <div> 9597 9609 <div class="refsect1" lang="en" xml:lang="en"> 9598 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 34872"></a>9610 <a xmlns="http://www.w3.org/1999/xhtml" id="id547302"></a> 9599 9611 <div class="header">Arguments and Values:</div> 9600 9612 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">host</span></i>---Specifies the host. It can be either a host name … … 9604 9616 </div> 9605 9617 <div class="refsect1" lang="en" xml:lang="en"> 9606 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25151"></a>9618 <a xmlns="http://www.w3.org/1999/xhtml" id="id547329"></a> 9607 9619 <div class="header">Description:</div> 9608 9620 <p xmlns="http://www.w3.org/1999/xhtml">Converts a host spec in any of the acceptable formats into a … … 9624 9636 <div> 9625 9637 <div class="refsect1" lang="en" xml:lang="en"> 9626 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25209"></a>9638 <a xmlns="http://www.w3.org/1999/xhtml" id="id547387"></a> 9627 9639 <div class="header">Arguments and Values:</div> 9628 9640 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">port</span></i>---Specifies the port. It can be either a string, such as … … 9633 9645 </div> 9634 9646 <div class="refsect1" lang="en" xml:lang="en"> 9635 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25252"></a>9647 <a xmlns="http://www.w3.org/1999/xhtml" id="id556298"></a> 9636 9648 <div class="header">Description:</div> 9637 9649 <p xmlns="http://www.w3.org/1999/xhtml">Finds the port number for the specified port and protocol</p> … … 9653 9665 <div> 9654 9666 <div class="refsect1" lang="en" xml:lang="en"> 9655 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25313"></a>9667 <a xmlns="http://www.w3.org/1999/xhtml" id="id556359"></a> 9656 9668 <div class="header">Arguments and Values:</div> 9657 9669 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to read from</p> … … 9670 9682 </div> 9671 9683 <div class="refsect1" lang="en" xml:lang="en"> 9672 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25403"></a>9684 <a xmlns="http://www.w3.org/1999/xhtml" id="id556449"></a> 9673 9685 <div class="header">Description:</div> 9674 9686 <p xmlns="http://www.w3.org/1999/xhtml">Reads a UDP packet from a socket. If no packets are … … 9707 9719 <div> 9708 9720 <div class="refsect1" lang="en" xml:lang="en"> 9709 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25503"></a>9721 <a xmlns="http://www.w3.org/1999/xhtml" id="id556549"></a> 9710 9722 <div class="header">Arguments and Values:</div> 9711 9723 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to write to</p> … … 9722 9734 </div> 9723 9735 <div class="refsect1" lang="en" xml:lang="en"> 9724 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25606"></a>9736 <a xmlns="http://www.w3.org/1999/xhtml" id="id556652"></a> 9725 9737 <div class="header">Description:</div> 9726 9738 <p xmlns="http://www.w3.org/1999/xhtml">Send a UDP packet over a socket.</p> … … 9741 9753 <div> 9742 9754 <div class="refsect1" lang="en" xml:lang="en"> 9743 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33228"></a>9755 <a xmlns="http://www.w3.org/1999/xhtml" id="id555022"></a> 9744 9756 <div class="header">Arguments and Values:</div> 9745 9757 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to shut down (typically a tcp-stream)</p> … … 9748 9760 </div> 9749 9761 <div class="refsect1" lang="en" xml:lang="en"> 9750 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33268"></a>9762 <a xmlns="http://www.w3.org/1999/xhtml" id="id555062"></a> 9751 9763 <div class="header">Description:</div> 9752 9764 <p xmlns="http://www.w3.org/1999/xhtml">Shuts down part of a bidirectional connection. This is … … 9769 9781 <div> 9770 9782 <div class="refsect1" lang="en" xml:lang="en"> 9771 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33327"></a>9783 <a xmlns="http://www.w3.org/1999/xhtml" id="id555121"></a> 9772 9784 <div class="header">Arguments and Values:</div> 9773 9785 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9774 9786 </div> 9775 9787 <div class="refsect1" lang="en" xml:lang="en"> 9776 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33353"></a>9788 <a xmlns="http://www.w3.org/1999/xhtml" id="id555147"></a> 9777 9789 <div class="header">Description:</div> 9778 9790 <p xmlns="http://www.w3.org/1999/xhtml">Returns the native OS's representation of the socket, or … … 9799 9811 <div> 9800 9812 <div class="refsect1" lang="en" xml:lang="en"> 9801 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33414"></a>9813 <a xmlns="http://www.w3.org/1999/xhtml" id="id555208"></a> 9802 9814 <div class="header">Arguments and Values:</div> 9803 9815 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9804 9816 </div> 9805 9817 <div class="refsect1" lang="en" xml:lang="en"> 9806 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33440"></a>9818 <a xmlns="http://www.w3.org/1999/xhtml" id="id555234"></a> 9807 9819 <div class="header">Description:</div> 9808 9820 <p xmlns="http://www.w3.org/1999/xhtml">Returns the 32-bit unsigned IP address of the remote host, … … 9824 9836 <div> 9825 9837 <div class="refsect1" lang="en" xml:lang="en"> 9826 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33498"></a>9838 <a xmlns="http://www.w3.org/1999/xhtml" id="id555292"></a> 9827 9839 <div class="header">Arguments and Values:</div> 9828 9840 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9829 9841 </div> 9830 9842 <div class="refsect1" lang="en" xml:lang="en"> 9831 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33524"></a>9843 <a xmlns="http://www.w3.org/1999/xhtml" id="id555318"></a> 9832 9844 <div class="header">Description:</div> 9833 9845 <p xmlns="http://www.w3.org/1999/xhtml">Returns the remote port number, or NIL if the socket is not … … 9849 9861 <div> 9850 9862 <div class="refsect1" lang="en" xml:lang="en"> 9851 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33582"></a>9863 <a xmlns="http://www.w3.org/1999/xhtml" id="id555375"></a> 9852 9864 <div class="header">Arguments and Values:</div> 9853 9865 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9854 9866 </div> 9855 9867 <div class="refsect1" lang="en" xml:lang="en"> 9856 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33608"></a>9868 <a xmlns="http://www.w3.org/1999/xhtml" id="id555402"></a> 9857 9869 <div class="header">Description:</div> 9858 9870 <p xmlns="http://www.w3.org/1999/xhtml">Returns 32-bit unsigned IP address of the local host.</p> … … 9873 9885 <div> 9874 9886 <div class="refsect1" lang="en" xml:lang="en"> 9875 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33665"></a>9887 <a xmlns="http://www.w3.org/1999/xhtml" id="id555459"></a> 9876 9888 <div class="header">Arguments and Values:</div> 9877 9889 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9878 9890 </div> 9879 9891 <div class="refsect1" lang="en" xml:lang="en"> 9880 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33691"></a>9892 <a xmlns="http://www.w3.org/1999/xhtml" id="id555485"></a> 9881 9893 <div class="header">Description:</div> 9882 9894 <p xmlns="http://www.w3.org/1999/xhtml">Returns the local port number</p> … … 9897 9909 <div> 9898 9910 <div class="refsect1" lang="en" xml:lang="en"> 9899 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33749"></a>9911 <a xmlns="http://www.w3.org/1999/xhtml" id="id555542"></a> 9900 9912 <div class="header">Arguments and Values:</div> 9901 9913 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9902 9914 </div> 9903 9915 <div class="refsect1" lang="en" xml:lang="en"> 9904 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38570"></a>9916 <a xmlns="http://www.w3.org/1999/xhtml" id="id555569"></a> 9905 9917 <div class="header">Description:</div> 9906 9918 <p xmlns="http://www.w3.org/1999/xhtml">Returns :internet or :file, as appropriate.</p> … … 9921 9933 <div> 9922 9934 <div class="refsect1" lang="en" xml:lang="en"> 9923 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38627"></a>9935 <a xmlns="http://www.w3.org/1999/xhtml" id="id560444"></a> 9924 9936 <div class="header">Arguments and Values:</div> 9925 9937 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9926 9938 </div> 9927 9939 <div class="refsect1" lang="en" xml:lang="en"> 9928 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38653"></a>9940 <a xmlns="http://www.w3.org/1999/xhtml" id="id560470"></a> 9929 9941 <div class="header">Description:</div> 9930 9942 <p xmlns="http://www.w3.org/1999/xhtml">Returns :active for tcp-stream, :passive for … … 9946 9958 <div> 9947 9959 <div class="refsect1" lang="en" xml:lang="en"> 9948 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38710"></a>9960 <a xmlns="http://www.w3.org/1999/xhtml" id="id560527"></a> 9949 9961 <div class="header">Arguments and Values:</div> 9950 9962 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9951 9963 </div> 9952 9964 <div class="refsect1" lang="en" xml:lang="en"> 9953 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38736"></a>9965 <a xmlns="http://www.w3.org/1999/xhtml" id="id560553"></a> 9954 9966 <div class="header">Description:</div> 9955 9967 <p xmlns="http://www.w3.org/1999/xhtml">Returns the socket format as specified by the :format … … 9971 9983 <div> 9972 9984 <div class="refsect1" lang="en" xml:lang="en"> 9973 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38794"></a>9985 <a xmlns="http://www.w3.org/1999/xhtml" id="id560610"></a> 9974 9986 <div class="header">Arguments and Values:</div> 9975 9987 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket</p> 9976 9988 </div> 9977 9989 <div class="refsect1" lang="en" xml:lang="en"> 9978 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38820"></a>9990 <a xmlns="http://www.w3.org/1999/xhtml" id="id560636"></a> 9979 9991 <div class="header">Description:</div> 9980 9992 <p xmlns="http://www.w3.org/1999/xhtml">returns :stream for tcp-stream and listener-socket, and … … 9995 10007 <div> 9996 10008 <div class="refsect1" lang="en" xml:lang="en"> 9997 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38863"></a>10009 <a xmlns="http://www.w3.org/1999/xhtml" id="id560679"></a> 9998 10010 <div class="header">Description:</div> 9999 10011 <p xmlns="http://www.w3.org/1999/xhtml">The class of OS errors signaled by socket functions</p> 10000 10012 </div> 10001 10013 <div class="refsect1" lang="en" xml:lang="en"> 10002 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38874"></a>10014 <a xmlns="http://www.w3.org/1999/xhtml" id="id560690"></a> 10003 10015 <div class="header">Superclasses:</div> 10004 10016 <p xmlns="http://www.w3.org/1999/xhtml">simple-error</p> … … 10019 10031 <div> 10020 10032 <div class="refsect1" lang="en" xml:lang="en"> 10021 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38931"></a>10033 <a xmlns="http://www.w3.org/1999/xhtml" id="id560748"></a> 10022 10034 <div class="header">Arguments and Values:</div> 10023 10035 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p> 10024 10036 </div> 10025 10037 <div class="refsect1" lang="en" xml:lang="en"> 10026 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38957"></a>10038 <a xmlns="http://www.w3.org/1999/xhtml" id="id560774"></a> 10027 10039 <div class="header">Description:</div> 10028 10040 <p xmlns="http://www.w3.org/1999/xhtml">The OS error code of the error</p> … … 10043 10055 <div> 10044 10056 <div class="refsect1" lang="en" xml:lang="en"> 10045 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39015"></a>10057 <a xmlns="http://www.w3.org/1999/xhtml" id="id560832"></a> 10046 10058 <div class="header">Arguments and Values:</div> 10047 10059 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p> 10048 10060 </div> 10049 10061 <div class="refsect1" lang="en" xml:lang="en"> 10050 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39041"></a>10062 <a xmlns="http://www.w3.org/1999/xhtml" id="id560858"></a> 10051 10063 <div class="header">Description:</div> 10052 10064 <p xmlns="http://www.w3.org/1999/xhtml">A symbol representing the error code in a more … … 10072 10084 <div> 10073 10085 <div class="refsect1" lang="en" xml:lang="en"> 10074 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39105"></a>10086 <a xmlns="http://www.w3.org/1999/xhtml" id="id560921"></a> 10075 10087 <div class="header">Arguments and Values:</div> 10076 10088 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket-error</span></i>---the condition</p> 10077 10089 </div> 10078 10090 <div class="refsect1" lang="en" xml:lang="en"> 10079 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39131"></a>10091 <a xmlns="http://www.w3.org/1999/xhtml" id="id560947"></a> 10080 10092 <div class="header">Description:</div> 10081 10093 <p xmlns="http://www.w3.org/1999/xhtml">A string describing the context where the error happened. On … … 10098 10110 <div> 10099 10111 <div class="refsect1" lang="en" xml:lang="en"> 10100 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 39192"></a>10112 <a xmlns="http://www.w3.org/1999/xhtml" id="id561008"></a> 10101 10113 <div class="header">Arguments and Values:</div> 10102 10114 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">socket</span></i>---The socket to close</p> … … 10109 10121 </div> 10110 10122 <div class="refsect1" lang="en" xml:lang="en"> 10111 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33821"></a>10123 <a xmlns="http://www.w3.org/1999/xhtml" id="id555625"></a> 10112 10124 <div class="header">Description:</div> 10113 10125 <p xmlns="http://www.w3.org/1999/xhtml">The close generic function can be applied to sockets. It … … 10130 10142 <div> 10131 10143 <div class="refsect1" lang="en" xml:lang="en"> 10132 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33883"></a>10144 <a xmlns="http://www.w3.org/1999/xhtml" id="id555688"></a> 10133 10145 <div class="header">Arguments and Values:</div> 10134 10146 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---variable to bind</p> … … 10137 10149 </div> 10138 10150 <div class="refsect1" lang="en" xml:lang="en"> 10139 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33938"></a>10151 <a xmlns="http://www.w3.org/1999/xhtml" id="id555743"></a> 10140 10152 <div class="header">Description:</div> 10141 10153 <p xmlns="http://www.w3.org/1999/xhtml">executes body with var bound to the result of applying … … 10269 10281 <div> 10270 10282 <div class="refsect1" lang="en" xml:lang="en"> 10271 <a xmlns="http://www.w3.org/1999/xhtml" id="id50 6485"></a>10283 <a xmlns="http://www.w3.org/1999/xhtml" id="id500325"></a> 10272 10284 <div class="header">Arguments and Values:</div> 10273 10285 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">program</span></i>---A string or pathname which denotes an executable file. … … 10320 10332 </div> 10321 10333 <div class="refsect1" lang="en" xml:lang="en"> 10322 <a xmlns="http://www.w3.org/1999/xhtml" id="id 483330"></a>10334 <a xmlns="http://www.w3.org/1999/xhtml" id="id547826"></a> 10323 10335 <div class="header">Description:</div> 10324 10336 <p xmlns="http://www.w3.org/1999/xhtml">Runs the specified program in an external (Unix) process, … … 10340 10352 <div> 10341 10353 <div class="refsect1" lang="en" xml:lang="en"> 10342 <a xmlns="http://www.w3.org/1999/xhtml" id="id 483388"></a>10354 <a xmlns="http://www.w3.org/1999/xhtml" id="id549773"></a> 10343 10355 <div class="header">Arguments and Values:</div> 10344 10356 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> … … 10346 10358 </div> 10347 10359 <div class="refsect1" lang="en" xml:lang="en"> 10348 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 25947"></a>10360 <a xmlns="http://www.w3.org/1999/xhtml" id="id549814"></a> 10349 10361 <div class="header">Description:</div> 10350 10362 <p xmlns="http://www.w3.org/1999/xhtml">Sends the specified "signal" to the specified … … 10369 10381 <div> 10370 10382 <div class="refsect1" lang="en" xml:lang="en"> 10371 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 26008"></a>10383 <a xmlns="http://www.w3.org/1999/xhtml" id="id549875"></a> 10372 10384 <div class="header">Arguments and Values:</div> 10373 10385 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> 10374 10386 </div> 10375 10387 <div class="refsect1" lang="en" xml:lang="en"> 10376 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 26034"></a>10388 <a xmlns="http://www.w3.org/1999/xhtml" id="id557073"></a> 10377 10389 <div class="header">Description:</div> 10378 10390 <p xmlns="http://www.w3.org/1999/xhtml">Returns the <span class="emphasis"><em>process id</em></span> assigned to … … 10396 10408 <div> 10397 10409 <div class="refsect1" lang="en" xml:lang="en"> 10398 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 05376"></a>10410 <a xmlns="http://www.w3.org/1999/xhtml" id="id557138"></a> 10399 10411 <div class="header">Arguments and Values:</div> 10400 10412 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> 10401 10413 </div> 10402 10414 <div class="refsect1" lang="en" xml:lang="en"> 10403 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 05402"></a>10415 <a xmlns="http://www.w3.org/1999/xhtml" id="id557163"></a> 10404 10416 <div class="header">Description:</div> 10405 10417 <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the input argument to … … 10422 10434 <div> 10423 10435 <div class="refsect1" lang="en" xml:lang="en"> 10424 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 05462"></a>10436 <a xmlns="http://www.w3.org/1999/xhtml" id="id528365"></a> 10425 10437 <div class="header">Arguments and Values:</div> 10426 10438 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> 10427 10439 </div> 10428 10440 <div class="refsect1" lang="en" xml:lang="en"> 10429 <a xmlns="http://www.w3.org/1999/xhtml" id="id52 7947"></a>10441 <a xmlns="http://www.w3.org/1999/xhtml" id="id528391"></a> 10430 10442 <div class="header">Description:</div> 10431 10443 <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the output argument to … … 10449 10461 <div> 10450 10462 <div class="refsect1" lang="en" xml:lang="en"> 10451 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 28008"></a>10463 <a xmlns="http://www.w3.org/1999/xhtml" id="id530283"></a> 10452 10464 <div class="header">Arguments and Values:</div> 10453 10465 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> 10454 10466 </div> 10455 10467 <div class="refsect1" lang="en" xml:lang="en"> 10456 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 28033"></a>10468 <a xmlns="http://www.w3.org/1999/xhtml" id="id530309"></a> 10457 10469 <div class="header">Description:</div> 10458 10470 <p xmlns="http://www.w3.org/1999/xhtml">Returns the stream created when the error argument to … … 10476 10488 <div> 10477 10489 <div class="refsect1" lang="en" xml:lang="en"> 10478 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 07389"></a>10490 <a xmlns="http://www.w3.org/1999/xhtml" id="id530370"></a> 10479 10491 <div class="header">Arguments and Values:</div> 10480 10492 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">proc</span></i>---An EXTERNAL-PROCESS, as returned by RUN-PROGRAM.</p> 10481 10493 </div> 10482 10494 <div class="refsect1" lang="en" xml:lang="en"> 10483 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 07415"></a>10495 <a xmlns="http://www.w3.org/1999/xhtml" id="id553936"></a> 10484 10496 <div class="header">Description:</div> 10485 10497 <p xmlns="http://www.w3.org/1999/xhtml">Returns, as multiple values, a keyword denoting the status … … 10511 10523 <dt> 10512 10524 <span class="sect2"> 10513 <a href="#id5 18743">9.1.1. Stream External Format</a>10525 <a href="#id522068">9.1.1. Stream External Format</a> 10514 10526 </span> 10515 10527 </dt> … … 10579 10591 <div> 10580 10592 <div> 10581 <h3 class="title"><a id="id5 18743"></a>9.1.1. Stream External Format</h3>10593 <h3 class="title"><a id="id522068"></a>9.1.1. Stream External Format</h3> 10582 10594 </div> 10583 10595 </div> … … 10742 10754 </div> 10743 10755 </div> 10744 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 06032" class="indexterm"></a>10745 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 06042" class="indexterm"></a>10746 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 06052" class="indexterm"></a>10747 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 06061" class="indexterm"></a>10748 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32796" class="indexterm"></a>10749 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32806" class="indexterm"></a>10756 <a xmlns="http://www.w3.org/1999/xhtml" id="id521773" class="indexterm"></a> 10757 <a xmlns="http://www.w3.org/1999/xhtml" id="id521783" class="indexterm"></a> 10758 <a xmlns="http://www.w3.org/1999/xhtml" id="id521792" class="indexterm"></a> 10759 <a xmlns="http://www.w3.org/1999/xhtml" id="id554586" class="indexterm"></a> 10760 <a xmlns="http://www.w3.org/1999/xhtml" id="id554594" class="indexterm"></a> 10761 <a xmlns="http://www.w3.org/1999/xhtml" id="id554604" class="indexterm"></a> 10750 10762 <p xmlns="http://www.w3.org/1999/xhtml">A stream that is associated with a file descriptor has 10751 10763 attributes and accessors: … … 10800 10812 <div> 10801 10813 <div class="refsect1" lang="en" xml:lang="en"> 10802 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32971"></a>10814 <a xmlns="http://www.w3.org/1999/xhtml" id="id554769"></a> 10803 10815 <div class="header">Values:</div> 10804 10816 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream-list</span></i>---A list of open file streams. This is a copy of … … 10807 10819 </div> 10808 10820 <div class="refsect1" lang="en" xml:lang="en"> 10809 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32999"></a>10821 <a xmlns="http://www.w3.org/1999/xhtml" id="id554796"></a> 10810 10822 <div class="header">Description:</div> 10811 10823 <p xmlns="http://www.w3.org/1999/xhtml">Returns a list of open file streams.</p> 10812 10824 </div> 10813 10825 <div class="refsect1" lang="en" xml:lang="en"> 10814 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33010"></a>10826 <a xmlns="http://www.w3.org/1999/xhtml" id="id554808"></a> 10815 10827 <div class="header">See Also:</div> 10816 10828 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_note-open-file-stream" title="Function NOTE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">note-open-file-stream</b></a>, <a class="xref" href="#f_remove-open-file-stream" title="Function REMOVE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">remove-open-file-stream</b></a></span> … … 10835 10847 <div> 10836 10848 <div class="refsect1" lang="en" xml:lang="en"> 10837 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33091"></a>10849 <a xmlns="http://www.w3.org/1999/xhtml" id="id554889"></a> 10838 10850 <div class="header">Arguments:</div> 10839 10851 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">file-stream</span></i>---A file stream.</p> 10840 10852 </div> 10841 10853 <div class="refsect1" lang="en" xml:lang="en"> 10842 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33117"></a>10854 <a xmlns="http://www.w3.org/1999/xhtml" id="id554915"></a> 10843 10855 <div class="header">Description:</div> 10844 10856 <p xmlns="http://www.w3.org/1999/xhtml">Adds a file stream to the internal list of open … … 10849 10861 </div> 10850 10862 <div class="refsect1" lang="en" xml:lang="en"> 10851 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 33136"></a>10863 <a xmlns="http://www.w3.org/1999/xhtml" id="id554934"></a> 10852 10864 <div class="header">See Also:</div> 10853 10865 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_open-file-streams" title="Function OPEN-FILE-STREAMS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">open-file-streams</b></a>, <a class="xref" href="#f_remove-open-file-stream" title="Function REMOVE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">remove-open-file-stream</b></a></span> … … 10872 10884 <div> 10873 10885 <div class="refsect1" lang="en" xml:lang="en"> 10874 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43936"></a>10886 <a xmlns="http://www.w3.org/1999/xhtml" id="id555015"></a> 10875 10887 <div class="header">Arguments:</div> 10876 10888 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">file-stream</span></i>---A file stream.</p> 10877 10889 </div> 10878 10890 <div class="refsect1" lang="en" xml:lang="en"> 10879 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43962"></a>10891 <a xmlns="http://www.w3.org/1999/xhtml" id="id565792"></a> 10880 10892 <div class="header">Description:</div> 10881 10893 <p xmlns="http://www.w3.org/1999/xhtml">Remove file stream from the internal list of open file … … 10886 10898 </div> 10887 10899 <div class="refsect1" lang="en" xml:lang="en"> 10888 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 43981"></a>10900 <a xmlns="http://www.w3.org/1999/xhtml" id="id565811"></a> 10889 10901 <div class="header">See Also:</div> 10890 10902 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"><a class="xref" href="#f_open-file-streams" title="Function OPEN-FILE-STREAMS"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">open-file-streams</b></a>, <a class="xref" href="#f_note-open-file-stream" title="Function NOTE-OPEN-FILE-STREAM"><b xmlns="http://www.w3.org/TR/xhtml1/transitional">note-open-file-stream</b></a></span> … … 11319 11331 <div> 11320 11332 <div class="refsect1" lang="en" xml:lang="en"> 11321 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44568"></a>11333 <a xmlns="http://www.w3.org/1999/xhtml" id="id566398"></a> 11322 11334 <div class="header">Arguments and Values:</div> 11323 11335 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-input-stream.</p> … … 11330 11342 </div> 11331 11343 <div class="refsect1" lang="en" xml:lang="en"> 11332 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44626"></a>11344 <a xmlns="http://www.w3.org/1999/xhtml" id="id566456"></a> 11333 11345 <div class="header">Description:</div> 11334 11346 <p xmlns="http://www.w3.org/1999/xhtml">Should try to read up to count elements from stream into the … … 11351 11363 <div> 11352 11364 <div class="refsect1" lang="en" xml:lang="en"> 11353 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44685"></a>11365 <a xmlns="http://www.w3.org/1999/xhtml" id="id566515"></a> 11354 11366 <div class="header">Arguments and Values:</div> 11355 11367 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-output-stream.</p> … … 11362 11374 </div> 11363 11375 <div class="refsect1" lang="en" xml:lang="en"> 11364 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44743"></a>11376 <a xmlns="http://www.w3.org/1999/xhtml" id="id566574"></a> 11365 11377 <div class="header">Description:</div> 11366 11378 <p xmlns="http://www.w3.org/1999/xhtml">should try to write the first count elements of list to … … 11382 11394 <div> 11383 11395 <div class="refsect1" lang="en" xml:lang="en"> 11384 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44802"></a>11396 <a xmlns="http://www.w3.org/1999/xhtml" id="id566632"></a> 11385 11397 <div class="header">Arguments and Values:</div> 11386 11398 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-input-stream</p> … … 11398 11410 </div> 11399 11411 <div class="refsect1" lang="en" xml:lang="en"> 11400 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44877"></a>11412 <a xmlns="http://www.w3.org/1999/xhtml" id="id566707"></a> 11401 11413 <div class="header">Description:</div> 11402 11414 <p xmlns="http://www.w3.org/1999/xhtml">should try to read successive elements from stream into … … 11421 11433 <div> 11422 11434 <div class="refsect1" lang="en" xml:lang="en"> 11423 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 44937"></a>11435 <a xmlns="http://www.w3.org/1999/xhtml" id="id566767"></a> 11424 11436 <div class="header">Arguments and Values:</div> 11425 11437 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---a stream, presumably a fundamental-output-stream</p> … … 11437 11449 </div> 11438 11450 <div class="refsect1" lang="en" xml:lang="en"> 11439 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45012"></a>11451 <a xmlns="http://www.w3.org/1999/xhtml" id="id566843"></a> 11440 11452 <div class="header">Description:</div> 11441 11453 <p xmlns="http://www.w3.org/1999/xhtml">should try to write successive elements of vector to stream, … … 11459 11471 <div> 11460 11472 <div class="refsect1" lang="en" xml:lang="en"> 11461 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45072"></a>11473 <a xmlns="http://www.w3.org/1999/xhtml" id="id566902"></a> 11462 11474 <div class="header">Method Signatures:</div> 11463 11475 <div class="synopsis"><span xmlns="http://www.w3.org/1999/xhtml" class="function"><strong>ccl::stream-device</strong></span> <i> … … 11465 11477 </div> 11466 11478 <div class="refsect1" lang="en" xml:lang="en"> 11467 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45090"></a>11479 <a xmlns="http://www.w3.org/1999/xhtml" id="id566921"></a> 11468 11480 <div class="header">Arguments and Values:</div> 11469 11481 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">s</span></i>---a stream.</p> … … 11476 11488 </div> 11477 11489 <div class="refsect1" lang="en" xml:lang="en"> 11478 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45156"></a>11490 <a xmlns="http://www.w3.org/1999/xhtml" id="id566986"></a> 11479 11491 <div class="header">Description:</div> 11480 11492 <p xmlns="http://www.w3.org/1999/xhtml">Returns the file descriptor associated with … … 11500 11512 <div> 11501 11513 <div class="refsect1" lang="en" xml:lang="en"> 11502 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45225"></a>11514 <a xmlns="http://www.w3.org/1999/xhtml" id="id567056"></a> 11503 11515 <div class="header">Description:</div> 11504 11516 <p xmlns="http://www.w3.org/1999/xhtml">Reads up to max-octets octets from stream into ivector, … … 11507 11519 </div> 11508 11520 <div class="refsect1" lang="en" xml:lang="en"> 11509 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45237"></a>11521 <a xmlns="http://www.w3.org/1999/xhtml" id="id567068"></a> 11510 11522 <div class="header">Arguments:</div> 11511 11523 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---An input stream. The method defined on … … 11532 11544 <div> 11533 11545 <div class="refsect1" lang="en" xml:lang="en"> 11534 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45357"></a>11546 <a xmlns="http://www.w3.org/1999/xhtml" id="id567187"></a> 11535 11547 <div class="header">Description:</div> 11536 11548 <p xmlns="http://www.w3.org/1999/xhtml">Writes max-octets octets to stream from ivector, starting at … … 11538 11550 </div> 11539 11551 <div class="refsect1" lang="en" xml:lang="en"> 11540 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45369"></a>11552 <a xmlns="http://www.w3.org/1999/xhtml" id="id567199"></a> 11541 11553 <div class="header">Arguments:</div> 11542 11554 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">stream</span></i>---An input stream. The method defined on … … 11548 11560 </div> 11549 11561 <div class="refsect1" lang="en" xml:lang="en"> 11550 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 45441"></a>11562 <a xmlns="http://www.w3.org/1999/xhtml" id="id567271"></a> 11551 11563 <div class="header">Examples:</div> 11552 11564 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> … … 12339 12351 <dt> 12340 12352 <span class="sect2"> 12341 <a href="# Profiling-CHUD-usage-synopsis">11.2.2. Usage synopsis</a>12353 <a href="#id554348">11.2.2. Generating a lisp image for use with Shark</a> 12342 12354 </span> 12343 12355 </dt> 12344 12356 <dt> 12345 12357 <span class="sect2"> 12346 <a href="#Profiling-CHUD- profiling-configurations">11.2.3. Profiling "configurations"</a>12358 <a href="#Profiling-CHUD-usage-synopsis">11.2.3. Usage synopsis</a> 12347 12359 </span> 12348 12360 </dt> 12349 12361 <dt> 12350 12362 <span class="sect2"> 12351 <a href="#Profiling-CHUD- Reference">11.2.4. Reference</a>12363 <a href="#Profiling-CHUD-profiling-configurations">11.2.4. Profiling "configurations"</a> 12352 12364 </span> 12353 12365 </dt> 12354 12366 <dt> 12355 12367 <span class="sect2"> 12356 <a href="#Profiling-CHUD-Acknowledgments">11.2.5. Acknowledgement</a> 12368 <a href="#Profiling-CHUD-Reference">11.2.5. Reference</a> 12369 </span> 12370 </dt> 12371 <dt> 12372 <span class="sect2"> 12373 <a href="#Profiling-CHUD-Acknowledgments">11.2.6. Acknowledgement</a> 12357 12374 </span> 12358 12375 </dt> … … 12369 12386 </div> 12370 12387 </div> 12371 <p xmlns="http://www.w3.org/1999/xhtml"><a class="ulink" href="http://oprofile.sourceforge.net" target="_top"><code class="code">oprofile</code></a> is 12372 a system-level profiler that's available for most modern Linux distributions.</p> 12373 <p xmlns="http://www.w3.org/1999/xhtml">Use of oprofile and its companion programs isn't really documented here; what 12374 is described is a way of generating symbolic information that enables profiling 12375 summaries generated by the <code class="code">opreport</code> program to identify lisp functions 12376 meaningfully.</p> 12388 <p xmlns="http://www.w3.org/1999/xhtml"><a class="ulink" href="http://oprofile.sourceforge.net" target="_top"><code class="code">oprofile</code></a> is a 12389 system-level profiler that's available for most modern Linux 12390 distributions.</p> 12391 <p xmlns="http://www.w3.org/1999/xhtml">Use of oprofile and its companion programs isn't really documented 12392 here; what is described is a way of generating symbolic information that 12393 enables profiling summaries generated by the <code class="code">opreport</code> program 12394 to identify lisp functions meaningfully.</p> 12377 12395 <div class="sect2" lang="en" xml:lang="en"> 12378 12396 <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> … … 12383 12401 </div> 12384 12402 </div> 12385 <p xmlns="http://www.w3.org/1999/xhtml">Modern Linux uses the 'ELF" (Executable and Linking Format) object file12386 format; the oprofile tools can associate symbolic names with addresses in a 12387 memory-mapped file if that file appears to be an ELF object file and if it 12388 contains ELF symbol information that describes those memory regions. So, the 12389 general idea is to make a lisp heap image that looks enough like an ELF shared 12390 library to fool the <code class="code">oprofile</code> tools (we don't actually load heap 12391 images via ELF dynamic linking technology, but we can make it look like we 12392 did.)</p>12403 <p xmlns="http://www.w3.org/1999/xhtml">Modern Linux uses the 'ELF" (Executable and Linking Format) object 12404 file format; the oprofile tools can associate symbolic names with 12405 addresses in a memory-mapped file if that file appears to be an ELF 12406 object file and if it contains ELF symbol information that describes 12407 those memory regions. So, the general idea is to make a lisp heap image 12408 that looks enough like an ELF shared library to fool the 12409 <code class="code">oprofile</code> tools (we don't actually load heap images via ELF 12410 dynamic linking technology, but we can make it look like we did.)</p> 12393 12411 </div> 12394 12412 <div class="sect2" lang="en" xml:lang="en"> … … 12403 12421 <ul class="itemizedlist" type="disc"> 12404 12422 <li class="listitem"> 12405 <p><code class="code">oprofile</code> itself, which is almost certainly available via12406 your distribution's package management system if not already 12407 preinstalled.</p>12423 <p><code class="code">oprofile</code> itself, which is almost certainly 12424 available via your distribution's package management system if not 12425 already preinstalled.</p> 12408 12426 </li> 12409 12427 <li class="listitem"> 12410 <p><code class="code">libelf</code>, which provides utilities for reading and writing 12411 ELF files (and is likewise likely preinstalled or readily installable.)</p> 12428 <p><code class="code">libelf</code>, which provides utilities for reading and 12429 writing ELF files (and is likewise likely preinstalled or readily 12430 installable.) Somewhat confusingly, there are two libelf 12431 implementations in widespread use on Linux, and different 12432 distributions refer to them by different names (they may be 12433 available as part of an 'elfutils' package.) The oprofile insterface 12434 was designed to work with a libelf implementation whose version 12435 number is currently around 147; the other (incompatible) libelf 12436 implementation has a version number around 0.8. It may be necessary 12437 to install the corresponding development package (-dev or -devel, 12438 usuallly) in order to actually be able to use the libelf shared 12439 library.</p> 12412 12440 </li> 12413 12441 </ul> … … 12423 12451 </div> 12424 12452 <p xmlns="http://www.w3.org/1999/xhtml">In order to create a lisp heap image which can be used for 12425 <code class="code">oprofile</code>- based profiling, we need to:</p>12453 <code class="code">oprofile</code>- based profiling, we need to:</p> 12426 12454 <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist"> 12427 12455 <ol class="orderedlist" type="1"> … … 12430 12458 </li> 12431 12459 <li class="listitem"> 12432 <p>generate a file that contains ELF symbol information describing the12433 names and addresses of all lisp functions.</p>12460 <p>generate a file that contains ELF symbol information 12461 describing the names and addresses of all lisp functions.</p> 12434 12462 <p>This step involves doing (from within Clozure CL)</p> 12435 12463 <pre class="programlisting"> … … 12440 12468 ? (ccl::write-elf-symbols-to-file "home:elf-symbols") 12441 12469 </pre> 12442 <p>The argument to CCL::WRITE-ELF-SYMBOLS-TO-FILE can be any writable 12443 pathname. The function will do whatever's necessary to nail lisp functions 12444 down in memory (so that they aren't moved by GC), then write an ELF object 12445 file to the indicated pathname. This typically takes a few seconds.</p> 12470 <p>The argument to CCL::WRITE-ELF-SYMBOLS-TO-FILE can be any 12471 writable pathname. The function will do whatever's necessary to nail 12472 lisp functions down in memory (so that they aren't moved by GC), 12473 then write an ELF object file to the indicated pathname. This 12474 typically takes a few seconds.</p> 12446 12475 </li> 12447 12476 <li class="listitem"> 12448 <p>Generate a lisp heap image in which the ELF symbols generated in the 12449 previous step are prepended.</p> 12450 <p>The function CCL:SAVE-APPLICATION provides a :PREPEND-KERNEL argument, 12451 which is ordinarily used to save a standalone application in which the kernel 12452 and heap image occupy a single file. :PREPEND-KERNEL doesn't really care what 12453 it's prepending to the image, and we can just as easily ask it to prepend the 12454 ELF symbol file generated in the previous step.</p> 12477 <p>Generate a lisp heap image in which the ELF symbols generated 12478 in the previous step are prepended.</p> 12479 <p>The function CCL:SAVE-APPLICATION provides a :PREPEND-KERNEL 12480 argument, which is ordinarily used to save a standalone application 12481 in which the kernel and heap image occupy a single file. 12482 :PREPEND-KERNEL doesn't really care what it's prepending to the 12483 image, and we can just as easily ask it to prepend the ELF symbol 12484 file generated in the previous step.</p> 12455 12485 <pre class="programlisting"> 12456 12486 ? (save-application "somewhere/image-for-profiling" … … 12461 12491 shell> ccl64 somewhare/image-for-profiling 12462 12492 </pre> 12463 <p>any lisp code sampled by oprofile in that image will be identified12464 "symbolically" by <code class="code">opreport</code>.</p>12493 <p>any lisp code sampled by oprofile in that image will be 12494 identified "symbolically" by <code class="code">opreport</code>.</p> 12465 12495 </li> 12466 12496 </ol> … … 12517 12547 ;;; we simply flush profiling data to disk, where 'opreport' can 12518 12548 ;;; find it. 12519 12549 <span class="token"></span> 12520 12550 [~] gb@rinpoche> sudo opcontrol --dump 12521 12551 … … 12544 12574 </div> 12545 12575 </div> 12546 <p xmlns="http://www.w3.org/1999/xhtml">CCL::WRITE-ELF-SYMBOLS-TO-FILE currently only works on x86-64; it certainly 12547 -could- be made to work on ppc32/ppc64 as well.</p> 12548 <p xmlns="http://www.w3.org/1999/xhtml">So far, no one has been able to make oprofile/opreport options that're 12549 supposed to generate call-stack info generate meaningful call-stack info.</p> 12550 <p xmlns="http://www.w3.org/1999/xhtml">As of a few months ago, there was an attempt to provide symbol info for 12551 oprofile/opreport "on the fly", e.g., for use in JIT compilation or other 12552 incremental compilations scenarios. That's obviously more nearly The Right Thing, 12553 but it might be awhile before that experimental code makes it into widespread 12554 use.</p> 12576 <p xmlns="http://www.w3.org/1999/xhtml">CCL::WRITE-ELF-SYMBOLS-TO-FILE currently only works on x86-64; it 12577 certainly -could- be made to work on ppc32/ppc64 as well.</p> 12578 <p xmlns="http://www.w3.org/1999/xhtml">So far, no one has been able to make oprofile/opreport options 12579 that're supposed to generate call-stack info generate meaningful 12580 call-stack info.</p> 12581 <p xmlns="http://www.w3.org/1999/xhtml">As of a few months ago, there was an attempt to provide symbol 12582 info for oprofile/opreport "on the fly", e.g., for use in JIT 12583 compilation or other incremental compilation scenarios. That's obviously 12584 more nearly The Right Thing, but it might be awhile before that 12585 experimental code makes it into widespread use.</p> 12555 12586 </div> 12556 12587 </div> … … 12563 12594 </div> 12564 12595 </div> 12596 <p xmlns="http://www.w3.org/1999/xhtml">Apple's CHUD package provides libraries, kernel extensions, and a 12597 set of graphical and command-line programs that can be used to measure 12598 many aspects of application and system performance.</p> 12599 <p xmlns="http://www.w3.org/1999/xhtml">One of these programs is the Shark application (often installed in 12600 "/Developer/Applications/Performance Tools/Shark.app"), which provides a 12601 graphical user interface for exploring and analyzing profiling results and 12602 provides tools for creating "sampling configurations" (see below), among 12603 other things. Use of Shark isn't really documented here (a Shark manual is 12604 available at "Developer/Documentation/CHUD/Shark/ SharkUserGuide.pdf"); 12605 what is described is a way of providing information about Lisp function 12606 names and addresses so that Shark can meaningly identify those functions 12607 in its output.</p> 12565 12608 <div class="sect2" lang="en" xml:lang="en"> 12566 12609 <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> … … 12571 12614 </div> 12572 12615 </div> 12573 <p xmlns="http://www.w3.org/1999/xhtml">Apple's CHUD metering tools are available (as of this writing) from:</p> 12574 <p xmlns="http://www.w3.org/1999/xhtml"><a class="ulink" href="ftp://ftp.apple.com/developer/Tool_Chest/Testing_-_Debugging/Performance_tools/" target="_top"> 12575 ftp://ftp.apple.com/developer/Tool_Chest/Testing_-_Debugging/Performance_tools/</a>.</p> 12576 <p xmlns="http://www.w3.org/1999/xhtml">The CHUD tools are also generally bundled with Apple's XCode tools. CHUD 12577 4.5.0 (which seems to be bundled with XCode 3.0) seems to work well with this 12578 interface; later versions may have problems. Versions of CHUD as old as 4.1.1 may 12579 work with 32-bit PPC versions of CCL; later versions (not sure exactly -what- 12580 versions) added x86, ppc64, and x86-64 support.</p> 12581 <p xmlns="http://www.w3.org/1999/xhtml">One way to tell whether any version of the CHUD tools is installed is to try 12582 to invoke the "shark" command-line program (/usr/bin/shark) from the shell:</p> 12583 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> 12584 shell> shark --help 12585 </pre> 12586 <p xmlns="http://www.w3.org/1999/xhtml">and verifying that that prints a usage summary.</p> 12587 <p xmlns="http://www.w3.org/1999/xhtml">CHUD consists of several components, including command-line programs, GUI 12588 applications, kernel extensions, and "frameworks" (collections of libraries, 12589 headers, and other resources which applications can use to access functionality 12590 provided by the other components.) Past versions of Clozure CL/OpenMCL have used the 12591 CHUD framework libraries to control the CHUD profiler. Even though the rest of 12592 CHUD is currently 64-bit aware, the frameworks are unfortunately still only 12593 available as 32-bit libraries, so the traditional way of controlling the profiling 12594 facility from Clozure CL has only worked from DarwinPPC32 versions.</p> 12595 <p xmlns="http://www.w3.org/1999/xhtml">Two of the CHUD component programs are of particular interest:</p> 12596 <div xmlns="http://www.w3.org/1999/xhtml" class="orderedlist"> 12597 <ol class="orderedlist" type="1"> 12598 <li class="listitem"> 12599 <p>The "Shark" application (often installed in 12600 "/Developer/Applications/Performance Tools/Shark.app"), which provides a 12601 graphical user interface for exploring and analyzing profiling results and 12602 provides tools for creating "sampling configurations" (see below), among other 12603 things.</p> 12604 </li> 12605 <li class="listitem"> 12606 <p>The "shark" program ("/usr/bin/shark"), which can be used to control the 12607 CHUD profiling facility and to collect sampling data, which can then be 12608 displayed and analyzed in Shark.app.</p> 12609 </li> 12610 </ol> 12611 </div> 12612 <p xmlns="http://www.w3.org/1999/xhtml">The fact that these two (substantially different) programs have names that 12613 differ only in alphabetic case may be confusing. The discussion below tries to 12614 consistently distinguish between "the shark program" and "the Shark 12615 application".</p> 12616 <p xmlns="http://www.w3.org/1999/xhtml">Apple's CHUD tools have been distributed with the last several 12617 XCode releases. One way to determine whether or not the tools are 12618 installed is to run:</p> 12619 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">$ /usr/bin/shark -v</pre> 12620 <p xmlns="http://www.w3.org/1999/xhtml">in a terminal or Emacs shell buffer. If that returns output 12621 like</p> 12622 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">shark 4.7.3 (365)</pre> 12623 <p xmlns="http://www.w3.org/1999/xhtml">then the CHUD package is installed. Output like</p> 12624 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">shark: Command not found.</pre> 12625 <p xmlns="http://www.w3.org/1999/xhtml">strongly suggests that it isn't ...</p> 12616 12626 </div> 12617 12627 <div class="sect2" lang="en" xml:lang="en"> … … 12619 12629 <div> 12620 12630 <div> 12621 <h3 class="title"><a id=" Profiling-CHUD-usage-synopsis"></a>11.2.2. Usage synopsis</h3>12631 <h3 class="title"><a id="id554348"></a>11.2.2. Generating a lisp image for use with Shark</h3> 12622 12632 </div> 12623 12633 </div> 12624 12634 </div> 12625 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> 12626 ? (defun fact (n) (if (zerop n) 1 (* n (fact (1- n))))) 12635 <p xmlns="http://www.w3.org/1999/xhtml">Shark can only properly identify functions that're defined in a 12636 shared library that's loaded by the target application. (Any other 12637 functions will be identified by a hex address described as being in an 12638 "Unknown Library"; the hex address is generally somewhat near the actual 12639 function, but it's determined heuristically and isn't always 12640 accurate.)</p> 12641 <p xmlns="http://www.w3.org/1999/xhtml">For those reasons, it's desirable to load the code that you wish 12642 to profile in one lisp session, save a native (Mach-O library) image, 12643 and invoke Shark in a new session which uses that native image. (It may 12644 also be useful to load the CHUD-METERING module, which defines 12645 CHUD:METER and friends.</p> 12646 <p xmlns="http://www.w3.org/1999/xhtml"></p> 12647 </div> 12648 <div class="sect2" lang="en" xml:lang="en"> 12649 <div xmlns="http://www.w3.org/1999/xhtml" class="titlepage"> 12650 <div> 12651 <div> 12652 <h3 class="title"><a id="Profiling-CHUD-usage-synopsis"></a>11.2.3. Usage synopsis</h3> 12653 </div> 12654 </div> 12655 </div> 12656 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">[src/ccl-dev] gb@antinomial> ccl64 12657 Welcome to Clozure Common Lisp Version 1.7-dev-r14624M-trunk (DarwinX8664)! 12658 ? (defun fact(n) (if (zerop n) 1 (* n (fact (1- n))))) 12627 12659 FACT 12628 12660 ? (require "CHUD-METERING") 12629 12661 "CHUD-METERING" 12630 12662 ("CHUD-METERING") 12631 ? (chud:meter (null (fact 10000))) 12632 NIL ; since that large number is not NULL 12633 </pre> 12634 <p xmlns="http://www.w3.org/1999/xhtml">and, a few seconds after the result is returned, a file whose name is of 12635 the form "session_nnn.mshark" will open in Shark.app.</p> 12636 <p xmlns="http://www.w3.org/1999/xhtml">The fist time that CHUD:METER is used in a lisp session, it'll do a few 12637 things to prepare subsequent profiling sessions. Those things include:</p> 12663 ? (save-application "ccl:dx86cl64.dylib" :native t) 12664 [src/ccl-dev] gb@antinomial> ccl64 -I dx86cl64.dylib 12665 Welcome to Clozure Common Lisp Version 1.7-dev-r14624M-trunk (DarwinX8664)! 12666 ? (chud:meter (dotimes (i 1000) (fact 1000))) 12667 ;;; Waiting for shark to process samples ...done. 12668 NIL</pre> 12669 <p xmlns="http://www.w3.org/1999/xhtml">and, a few seconds after the result is returned, a file whose name 12670 is of the form "session_nnn.mshark" will open in Shark.app.</p> 12671 <p xmlns="http://www.w3.org/1999/xhtml"></p> 12672 <p xmlns="http://www.w3.org/1999/xhtml">The fist time that CHUD:METER is used in a lisp session, it'll do 12673 a few things to prepare subsequent profiling sessions. Those things 12674 include:</p> 12638 12675 <div xmlns="http://www.w3.org/1999/xhtml" class="itemizedlist"> 12639 12676 <ul class="itemizedlist" type="disc"> 12640 12677 <li class="listitem"> 12641 <p>creating a directory to store files that are related to using the CHUD12642 tools in this lisp session. This directory is created in the user's home 12643 directory and has a name of the form:</p>12678 <p>creating a directory to store files that are related to using 12679 the CHUD tools in this lisp session. This directory is created in 12680 the user's home directory and has a name of the form:</p> 12644 12681 <pre class="programlisting"> 12645 12682 profiling-session-<lisp-kernel>-<pid>_<mm>-<dd>-<yyyy>_<h>.<m>.<s> 12646 12683 </pre> 12647 <p>where <pid> is the lisp's process id, <lisp-kernel> is the12648 name of the lisp kernel (of all things ...), and the other values provide a12649 timestamp.</p>12650 12684 </li> 12651 12685 <li class="listitem"> 12652 <p>does whatever needs to be done to ensure that currently-defined lisp 12653 functions don't move around as the result of GC activity, then writes a text 12654 file describing the names and addresses of those functions to the 12655 profiling-session directory created above. (The naming conventions for and 12656 format of that file are described in</p> 12657 <p> 12658 <a class="ulink" href="http://developer.apple.com/documentation/DeveloperTools/Conceptual/SharkUserGuide/MiscellaneousTopics/chapter_951_section_4.html#//apple_ref/doc/uid/TP40005233-CH14-DontLinkElementID_42" target="_top">http://developer.apple.com/documentation/DeveloperTools/Conceptual/SharkUserGuide/MiscellaneousTopics/chapter_951_section_4.html#//apple_ref/doc/uid/TP40005233-CH14-DontLinkElementID_42</a></p> 12659 </li> 12660 <li class="listitem"> 12661 <p>run the shark program ("/usr/bin/shark") and wait until it's ready to 12662 receive signals that control its operation.</p> 12686 <p>run the shark program ("/usr/bin/shark") and wait until it's 12687 ready to receive signals that control its operation.</p> 12663 12688 </li> 12664 12689 </ul> 12665 12690 </div> 12666 <p xmlns="http://www.w3.org/1999/xhtml">This startup activity typically takes a few seconds; after it's been 12667 completed, subsequent use of CHUD:METER doesn't involve that overhead. (See the 12668 discussion of :RESET below.)</p> 12669 <p xmlns="http://www.w3.org/1999/xhtml">After any startup activity is complete, CHUD:METER arranges to send a 12670 "start profiling" signal to the running shark program, executes the form, sends 12671 a "stop profiling" signal to the shark program, and reads its diagnostic output, 12672 looking for the name of the ".mshark" file it produces. If it's able to find 12673 this filename, it arranges for "Shark.app" to open it.</p> 12691 <p xmlns="http://www.w3.org/1999/xhtml">This startup activity typically takes a few seconds; after it's 12692 been completed, subsequent use of CHUD:METER doesn't involve that 12693 overhead. (See the discussion of :RESET below.)</p> 12694 <p xmlns="http://www.w3.org/1999/xhtml">After any startup activity is complete, CHUD:METER arranges to 12695 send a "start profiling" signal to the running shark program, executes 12696 the form, sends a "stop profiling" signal to the shark program, and 12697 reads its diagnostic output, looking for the name of the ".mshark" file 12698 it produces. If it's able to find this filename, it arranges for 12699 "Shark.app" to open it.</p> 12674 12700 </div> 12675 12701 <div class="sect2" lang="en" xml:lang="en"> … … 12677 12703 <div> 12678 12704 <div> 12679 <h3 class="title"><a id="Profiling-CHUD-profiling-configurations"></a>11.2. 3. Profiling "configurations"</h3>12705 <h3 class="title"><a id="Profiling-CHUD-profiling-configurations"></a>11.2.4. Profiling "configurations"</h3> 12680 12706 </div> 12681 12707 </div> … … 12686 12712 <li class="listitem"> 12687 12713 <p>use "time based" sampling, to periodically interrupt the lisp 12688 process and note the value of the program counter and at least a few levels of 12689 call history.</p>12714 process and note the value of the program counter and at least a few 12715 levels of call history.</p> 12690 12716 </li> 12691 12717 <li class="listitem"> … … 12697 12723 </ul> 12698 12724 </div> 12699 <p xmlns="http://www.w3.org/1999/xhtml">This is known as "the default configuration"; it's possible to use items 12700 on the "Config" menu in the Shark application to create alternate configurations 12701 which provide different kinds of profiling parameters and to save these 12702 configurations in files for subsequent reuse. (The set of things that CHUD 12703 knows how to monitor is large and interesting.)</p> 12704 <p xmlns="http://www.w3.org/1999/xhtml">You use alternate profiling configurations (created and "exported" via 12705 Shark.app) with CHUD:METER, but the interface is a little awkward.</p> 12725 <p xmlns="http://www.w3.org/1999/xhtml">This is known as "the default configuration"; it's possible to use 12726 items on the "Config" menu in the Shark application to create alternate 12727 configurations which provide different kinds of profiling parameters and 12728 to save these configurations in files for subsequent reuse. (The set of 12729 things that CHUD knows how to monitor is large and interesting.)</p> 12730 <p xmlns="http://www.w3.org/1999/xhtml">You use alternate profiling configurations (created and "exported" 12731 via Shark.app) with CHUD:METER, but the interface is a little 12732 awkward.</p> 12706 12733 </div> 12707 12734 <div class="sect2" lang="en" xml:lang="en"> … … 12709 12736 <div> 12710 12737 <div> 12711 <h3 class="title"><a id="Profiling-CHUD-Reference"></a>11.2. 4. Reference</h3>12738 <h3 class="title"><a id="Profiling-CHUD-Reference"></a>11.2.5. Reference</h3> 12712 12739 </div> 12713 12740 </div> 12714 12741 </div> 12715 <p xmlns="http://www.w3.org/1999/xhtml"> 12716 <a id="id532636" class="indexterm"></a> 12717 <span class="command"><strong><em class="varname"><a id="chud_shark-config-file"></a>CHUD:*SHARK-CONFIG-FILE*</em> [Variable]</strong></span> 12718 </p> 12719 <p xmlns="http://www.w3.org/1999/xhtml">When non-null, this should be the pathname of an alternate profiling 12720 configuration file created by the "Config Editor" in Shark.app.</p> 12721 <p xmlns="http://www.w3.org/1999/xhtml"> 12722 <a id="id532662" class="indexterm"></a> 12723 <span class="command"><strong><em class="varname"><a id="chud_meter"></a>CHUD:METER</em> form <em class="varname">&key</em> (reset nil) (debug-output nil) [Macro]</strong></span> 12724 </p> 12725 <p xmlns="http://www.w3.org/1999/xhtml">Executes FORM (an arbitrary lisp form) and returns whatever result(s) it 12726 returns, with CHUD profiling enabled during the form's execution. Tries to 12727 determine the name of the session file (*.mshark) to which the shark program 12728 wrote profiling data and opens this file in the Shark application.</p> 12742 <p xmlns="http://www.w3.org/1999/xhtml"><a id="id554190" class="indexterm"></a> 12743 <span class="command"><strong><em class="varname"><a id="chud_shark-config-file"></a>CHUD:*SHARK-CONFIG-FILE*</em> 12744 [Variable]</strong></span></p> 12745 <p xmlns="http://www.w3.org/1999/xhtml">When non-null, this should be the pathname of an alternate 12746 profiling configuration file created by the "Config Editor" in 12747 Shark.app.</p> 12748 <p xmlns="http://www.w3.org/1999/xhtml"><a id="id554213" class="indexterm"></a> <span class="command"><strong><em class="varname"><a id="chud_meter"></a>CHUD:METER</em> form <em class="varname">&key</em> (reset nil) 12749 (debug-output nil) [Macro]</strong></span></p> 12750 <p xmlns="http://www.w3.org/1999/xhtml">Executes FORM (an arbitrary lisp form) and returns whatever 12751 result(s) it returns, with CHUD profiling enabled during the form's 12752 execution. Tries to determine the name of the session file (*.mshark) to 12753 which the shark program wrote profiling data and opens this file in the 12754 Shark application.</p> 12729 12755 <p xmlns="http://www.w3.org/1999/xhtml">Arguments:</p> 12730 12756 <div xmlns="http://www.w3.org/1999/xhtml" class="variablelist"> … … 12736 12762 </dt> 12737 12763 <dd> 12738 <p>when non-nil, causes output generated by the shark program to be12739 echoed to *TERMINAL-IO*.For debugging.</p>12764 <p>when non-nil, causes output generated by the shark program 12765 to be echoed to *TERMINAL-IO*. For debugging.</p> 12740 12766 </dd> 12741 12767 <dt> … … 12745 12771 </dt> 12746 12772 <dd> 12747 <p>when non-nil, terminates any running instance of the shark program 12748 created by previous invocations of CHUD:METER in this lisp session, 12749 generates a new .spatch file (describing the names and addresses of lisp 12750 functions), and starts a new instance of the shark program; if 12751 CHUD:*SHARK-CONFIG-FILE* is non-NIL when this new instance is started, 12752 that instance is told to use the specified config file for profiling (in 12753 lieu of the default profiling configuration.)</p> 12773 <p>when non-nil, terminates any running instance of the shark 12774 program created by previous invocations of CHUD:METER in this lisp 12775 session, generates a new .spatch file (describing the names and 12776 addresses of lisp functions), and starts a new instance of the 12777 shark program; if CHUD:*SHARK-CONFIG-FILE* is non-NIL when this 12778 new instance is started, that instance is told to use the 12779 specified config file for profiling (in lieu of the default 12780 profiling configuration.)</p> 12754 12781 </dd> 12755 12782 </dl> … … 12760 12787 <div> 12761 12788 <div> 12762 <h3 class="title"><a id="Profiling-CHUD-Acknowledgments"></a>11.2. 5. Acknowledgement</h3>12789 <h3 class="title"><a id="Profiling-CHUD-Acknowledgments"></a>11.2.6. Acknowledgement</h3> 12763 12790 </div> 12764 12791 </div> 12765 12792 </div> 12766 <p xmlns="http://www.w3.org/1999/xhtml">Both Dan Knapp and Hamilton Link have posted similar CHUD interfaces to 12767 openmcl-devel in the past; Hamilton's also reported bugs in the spatch mechanism 12768 to CHUD developers (and gotten those bugs fixed.)</p> 12793 <p xmlns="http://www.w3.org/1999/xhtml">Both Dan Knapp and Hamilton Link have posted similar CHUD 12794 interfaces to openmcl-devel in the past; Hamilton's also reported bugs 12795 in the spatch mechanism to CHUD developers (and gotten those bugs 12796 fixed.)</p> 12769 12797 </div> 12770 12798 </div> … … 13810 13838 <div> 13811 13839 <div> 13812 <h4 class="title"><a id="id5 47608"></a>12.3.2.4. %int-to-ptr [Function]</h4>13840 <h4 class="title"><a id="id569462"></a>12.3.2.4. %int-to-ptr [Function]</h4> 13813 13841 </div> 13814 13842 </div> … … 13851 13879 <div> 13852 13880 <div> 13853 <h4 class="title"><a id="id5 47682"></a>12.3.2.5. %inc-ptr [Function]</h4>13881 <h4 class="title"><a id="id569536"></a>12.3.2.5. %inc-ptr [Function]</h4> 13854 13882 </div> 13855 13883 </div> … … 13901 13929 <div> 13902 13930 <div> 13903 <h4 class="title"><a id="id5 47774"></a>12.3.2.6. %ptr-to-int [Function]</h4>13931 <h4 class="title"><a id="id569628"></a>12.3.2.6. %ptr-to-int [Function]</h4> 13904 13932 </div> 13905 13933 </div> … … 13943 13971 <div> 13944 13972 <div> 13945 <h4 class="title"><a id="id5 47849"></a>12.3.2.7. %null-ptr [Macro]</h4>13973 <h4 class="title"><a id="id569703"></a>12.3.2.7. %null-ptr [Macro]</h4> 13946 13974 </div> 13947 13975 </div> … … 13968 13996 <div> 13969 13997 <div> 13970 <h4 class="title"><a id="id5 47890"></a>12.3.2.8. %null-ptr-p [Function]</h4>13998 <h4 class="title"><a id="id569744"></a>12.3.2.8. %null-ptr-p [Function]</h4> 13971 13999 </div> 13972 14000 </div> … … 14010 14038 <div> 14011 14039 <div> 14012 <h4 class="title"><a id="id5 47965"></a>12.3.2.9. %setf-macptr [Function]</h4>14040 <h4 class="title"><a id="id569819"></a>12.3.2.9. %setf-macptr [Function]</h4> 14013 14041 </div> 14014 14042 </div> … … 14058 14086 <div> 14059 14087 <div> 14060 <h4 class="title"><a id="id5 48056"></a>12.3.2.10. %incf-ptr [Macro]</h4>14088 <h4 class="title"><a id="id569910"></a>12.3.2.10. %incf-ptr [Macro]</h4> 14061 14089 </div> 14062 14090 </div> … … 14106 14134 <div> 14107 14135 <div> 14108 <h4 class="title"><a id="id5 48146"></a>12.3.2.11. with-macptrs [Macro]</h4>14136 <h4 class="title"><a id="id570000"></a>12.3.2.11. with-macptrs [Macro]</h4> 14109 14137 </div> 14110 14138 </div> … … 14156 14184 <div> 14157 14185 <div> 14158 <h4 class="title"><a id="id5 48238"></a>12.3.2.12. %stack-block [Macro]</h4>14186 <h4 class="title"><a id="id570092"></a>12.3.2.12. %stack-block [Macro]</h4> 14159 14187 </div> 14160 14188 </div> … … 14207 14235 <div> 14208 14236 <div> 14209 <h4 class="title"><a id="id5 48330"></a>12.3.2.13. make-cstring [Function]</h4>14237 <h4 class="title"><a id="id570184"></a>12.3.2.13. make-cstring [Function]</h4> 14210 14238 </div> 14211 14239 </div> … … 14250 14278 <div> 14251 14279 <div> 14252 <h4 class="title"><a id="id5 48406"></a>12.3.2.14. with-cstrs [Macro]</h4>14280 <h4 class="title"><a id="id570260"></a>12.3.2.14. with-cstrs [Macro]</h4> 14253 14281 </div> 14254 14282 </div> … … 14300 14328 <div> 14301 14329 <div> 14302 <h4 class="title"><a id="id5 48498"></a>12.3.2.15. with-encoded-cstrs [Macro]</h4>14330 <h4 class="title"><a id="id570352"></a>12.3.2.15. with-encoded-cstrs [Macro]</h4> 14303 14331 </div> 14304 14332 </div> … … 14363 14391 <div> 14364 14392 <div> 14365 <h4 class="title"><a id="id5 48622"></a>12.3.2.16. %get-cstring [Function]</h4>14393 <h4 class="title"><a id="id570476"></a>12.3.2.16. %get-cstring [Function]</h4> 14366 14394 </div> 14367 14395 </div> … … 14405 14433 <div> 14406 14434 <div> 14407 <h4 class="title"><a id="id5 64959"></a>12.3.2.17. %str-from-ptr [Function]</h4>14435 <h4 class="title"><a id="id586776"></a>12.3.2.17. %str-from-ptr [Function]</h4> 14408 14436 </div> 14409 14437 </div> … … 15851 15879 <div> 15852 15880 <div class="refsect1" lang="en" xml:lang="en"> 15853 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 66913"></a>15881 <a xmlns="http://www.w3.org/1999/xhtml" id="id588730"></a> 15854 15882 <div class="header">Description:</div> 15855 15883 <p xmlns="http://www.w3.org/1999/xhtml">Reads a symbol from the current input stream, with *PACKAGE* … … 15903 15931 <div> 15904 15932 <div class="refsect1" lang="en" xml:lang="en"> 15905 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67019"></a>15933 <a xmlns="http://www.w3.org/1999/xhtml" id="id588836"></a> 15906 15934 <div class="header">Description:</div> 15907 15935 <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #& reader macro can be used to … … 15962 15990 <div> 15963 15991 <div class="refsect1" lang="en" xml:lang="en"> 15964 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67137"></a>15992 <a xmlns="http://www.w3.org/1999/xhtml" id="id588954"></a> 15965 15993 <div class="header">Description:</div> 15966 15994 <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 0.14.2 and later, the #? reader macro can be used … … 16009 16037 <div> 16010 16038 <div class="refsect1" lang="en" xml:lang="en"> 16011 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67219"></a>16039 <a xmlns="http://www.w3.org/1999/xhtml" id="id589036"></a> 16012 16040 <div class="header">Description:</div> 16013 16041 <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #/ reader macro can be used to … … 16112 16140 <div> 16113 16141 <div class="refsect1" lang="en" xml:lang="en"> 16114 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67358"></a>16142 <a xmlns="http://www.w3.org/1999/xhtml" id="id589176"></a> 16115 16143 <div class="header">Description:</div> 16116 16144 <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the #> reader macro reads … … 16141 16169 <div> 16142 16170 <div class="refsect1" lang="en" xml:lang="en"> 16143 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67433"></a>16171 <a xmlns="http://www.w3.org/1999/xhtml" id="id589250"></a> 16144 16172 <div class="header">Values:</div> 16145 16173 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">library</span></i>---either an object of type SHLIB, or a string which … … 16148 16176 </div> 16149 16177 <div class="refsect1" lang="en" xml:lang="en"> 16150 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67469"></a>16178 <a xmlns="http://www.w3.org/1999/xhtml" id="id589286"></a> 16151 16179 <div class="header">Description:</div> 16152 16180 <p xmlns="http://www.w3.org/1999/xhtml">If <em class="varname">completely</em> is T, sets the … … 16177 16205 <div> 16178 16206 <div class="refsect1" lang="en" xml:lang="en"> 16179 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67545"></a>16207 <a xmlns="http://www.w3.org/1999/xhtml" id="id589362"></a> 16180 16208 <div class="header">Values:</div> 16181 16209 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A symbol which can be made into a special variable</p> … … 16194 16222 </div> 16195 16223 <div class="refsect1" lang="en" xml:lang="en"> 16196 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67616"></a>16224 <a xmlns="http://www.w3.org/1999/xhtml" id="id589434"></a> 16197 16225 <div class="header">Description:</div> 16198 16226 <p xmlns="http://www.w3.org/1999/xhtml">Proclaims <em class="varname">name</em> … … 16230 16258 <div> 16231 16259 <div class="refsect1" lang="en" xml:lang="en"> 16232 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67696"></a>16260 <a xmlns="http://www.w3.org/1999/xhtml" id="id589513"></a> 16233 16261 <div class="header">Values:</div> 16234 16262 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---NIL or a keyword; the keyword may contain … … 16238 16266 </div> 16239 16267 <div class="refsect1" lang="en" xml:lang="en"> 16240 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67737"></a>16268 <a xmlns="http://www.w3.org/1999/xhtml" id="id589554"></a> 16241 16269 <div class="header">Description:</div> 16242 16270 <p xmlns="http://www.w3.org/1999/xhtml">If name is non-NIL, defines name to be an alias for the … … 16272 16300 <div> 16273 16301 <div class="refsect1" lang="en" xml:lang="en"> 16274 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67809"></a>16302 <a xmlns="http://www.w3.org/1999/xhtml" id="id589627"></a> 16275 16303 <div class="header">Values:</div> 16276 16304 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>--- … … 16285 16313 </div> 16286 16314 <div class="refsect1" lang="en" xml:lang="en"> 16287 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67850"></a>16315 <a xmlns="http://www.w3.org/1999/xhtml" id="id589667"></a> 16288 16316 <div class="header">Description:</div> 16289 16317 <p xmlns="http://www.w3.org/1999/xhtml">If there is already an EXTERNAL-ENTRY-POINT for … … 16313 16341 <div> 16314 16342 <div class="refsect1" lang="en" xml:lang="en"> 16315 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67919"></a>16343 <a xmlns="http://www.w3.org/1999/xhtml" id="id589736"></a> 16316 16344 <div class="header">Values:</div> 16317 16345 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string. See external, above.</p> … … 16326 16354 </div> 16327 16355 <div class="refsect1" lang="en" xml:lang="en"> 16328 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 67993"></a>16356 <a xmlns="http://www.w3.org/1999/xhtml" id="id589810"></a> 16329 16357 <div class="header">Description:</div> 16330 16358 <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at the address obtained by … … 16353 16381 <div> 16354 16382 <div class="refsect1" lang="en" xml:lang="en"> 16355 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68052"></a>16383 <a xmlns="http://www.w3.org/1999/xhtml" id="id589870"></a> 16356 16384 <div class="header">Values:</div> 16357 16385 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">entrypoint</span></i>---A fixnum or MACPTR</p> … … 16364 16392 </div> 16365 16393 <div class="refsect1" lang="en" xml:lang="en"> 16366 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68115"></a>16394 <a xmlns="http://www.w3.org/1999/xhtml" id="id589932"></a> 16367 16395 <div class="header">Description:</div> 16368 16396 <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at address entrypoint passing the … … 16390 16418 <div> 16391 16419 <div class="refsect1" lang="en" xml:lang="en"> 16392 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68174"></a>16420 <a xmlns="http://www.w3.org/1999/xhtml" id="id589991"></a> 16393 16421 <div class="header">Values:</div> 16394 16422 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">entrypoint</span></i>---A fixnum or MACPTR</p> … … 16403 16431 </div> 16404 16432 <div class="refsect1" lang="en" xml:lang="en"> 16405 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68248"></a>16433 <a xmlns="http://www.w3.org/1999/xhtml" id="id590065"></a> 16406 16434 <div class="header">Description:</div> 16407 16435 <p xmlns="http://www.w3.org/1999/xhtml">Calls the foreign function at address entrypoint passing the … … 16428 16456 <div> 16429 16457 <div class="refsect1" lang="en" xml:lang="en"> 16430 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68303"></a>16458 <a xmlns="http://www.w3.org/1999/xhtml" id="id590121"></a> 16431 16459 <div class="header">Values:</div> 16432 16460 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string.</p> 16433 16461 </div> 16434 16462 <div class="refsect1" lang="en" xml:lang="en"> 16435 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68326"></a>16463 <a xmlns="http://www.w3.org/1999/xhtml" id="id590143"></a> 16436 16464 <div class="header">Description:</div> 16437 16465 <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the foreign symbol … … 16456 16484 <div> 16457 16485 <div class="refsect1" lang="en" xml:lang="en"> 16458 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68385"></a>16486 <a xmlns="http://www.w3.org/1999/xhtml" id="id590202"></a> 16459 16487 <div class="header">Values:</div> 16460 16488 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A lisp string.</p> 16461 16489 </div> 16462 16490 <div class="refsect1" lang="en" xml:lang="en"> 16463 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68407"></a>16491 <a xmlns="http://www.w3.org/1999/xhtml" id="id590225"></a> 16464 16492 <div class="header">Description:</div> 16465 16493 <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the foreign symbol name. If … … 16483 16511 <div> 16484 16512 <div class="refsect1" lang="en" xml:lang="en"> 16485 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68461"></a>16513 <a xmlns="http://www.w3.org/1999/xhtml" id="id590279"></a> 16486 16514 <div class="header">Values:</div> 16487 16515 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ptr</span></i>---A <code xmlns="http://www.w3.org/1999/xhtml" class="code">MACPTR</code> that points to a block of … … 16489 16517 </div> 16490 16518 <div class="refsect1" lang="en" xml:lang="en"> 16491 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68488"></a>16519 <a xmlns="http://www.w3.org/1999/xhtml" id="id590305"></a> 16492 16520 <div class="header">Description:</div> 16493 16521 <p xmlns="http://www.w3.org/1999/xhtml">In <code class="literal">CCL</code> 1.2 and later, the <code class="code">CCL:FREE</code> … … 16521 16549 <div> 16522 16550 <div class="refsect1" lang="en" xml:lang="en"> 16523 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68580"></a>16551 <a xmlns="http://www.w3.org/1999/xhtml" id="id590398"></a> 16524 16552 <div class="header">Values:</div> 16525 16553 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">element-count</span></i>---A positive integer.</p> … … 16536 16564 </div> 16537 16565 <div class="refsect1" lang="en" xml:lang="en"> 16538 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68656"></a>16566 <a xmlns="http://www.w3.org/1999/xhtml" id="id590473"></a> 16539 16567 <div class="header">Description:</div> 16540 16568 <p xmlns="http://www.w3.org/1999/xhtml"> … … 16571 16599 <div> 16572 16600 <div class="refsect1" lang="en" xml:lang="en"> 16573 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68727"></a>16601 <a xmlns="http://www.w3.org/1999/xhtml" id="id590545"></a> 16574 16602 <div class="header">Values:</div> 16575 16603 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">typespec</span></i>---A foreign type specifier, or a keyword which is used … … 16588 16616 </div> 16589 16617 <div class="refsect1" lang="en" xml:lang="en"> 16590 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68795"></a>16618 <a xmlns="http://www.w3.org/1999/xhtml" id="id590612"></a> 16591 16619 <div class="header">Description:</div> 16592 16620 <p xmlns="http://www.w3.org/1999/xhtml"> … … 16637 16665 <div> 16638 16666 <div class="refsect1" lang="en" xml:lang="en"> 16639 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68917"></a>16667 <a xmlns="http://www.w3.org/1999/xhtml" id="id590734"></a> 16640 16668 <div class="header">Values:</div> 16641 16669 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">typespec</span></i>---A foreign type specifier, or a keyword which is used … … 16651 16679 </div> 16652 16680 <div class="refsect1" lang="en" xml:lang="en"> 16653 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 68975"></a>16681 <a xmlns="http://www.w3.org/1999/xhtml" id="id590792"></a> 16654 16682 <div class="header">Description:</div> 16655 16683 <p xmlns="http://www.w3.org/1999/xhtml"> … … 16692 16720 </div> 16693 16721 <div class="refsect1" lang="en" xml:lang="en"> 16694 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69064"></a>16722 <a xmlns="http://www.w3.org/1999/xhtml" id="id590882"></a> 16695 16723 <div class="header">Notes:</div> 16696 16724 <p xmlns="http://www.w3.org/1999/xhtml"> … … 16725 16753 <div> 16726 16754 <div class="refsect1" lang="en" xml:lang="en"> 16727 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69148"></a>16755 <a xmlns="http://www.w3.org/1999/xhtml" id="id590965"></a> 16728 16756 <div class="header">Values:</div> 16729 16757 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---A SIMPLE-STRING which is presumed to be the so-name of … … 16733 16761 </div> 16734 16762 <div class="refsect1" lang="en" xml:lang="en"> 16735 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69188"></a>16763 <a xmlns="http://www.w3.org/1999/xhtml" id="id591006"></a> 16736 16764 <div class="header">Description:</div> 16737 16765 <p xmlns="http://www.w3.org/1999/xhtml">If the library denoted by <em class="varname">name</em> can … … 16744 16772 </div> 16745 16773 <div class="refsect1" lang="en" xml:lang="en"> 16746 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69204"></a>16774 <a xmlns="http://www.w3.org/1999/xhtml" id="id591021"></a> 16747 16775 <div class="header">Examples:</div> 16748 16776 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting">;;; Try to do something simple. … … 16779 16807 </div> 16780 16808 <div class="refsect1" lang="en" xml:lang="en"> 16781 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69224"></a>16809 <a xmlns="http://www.w3.org/1999/xhtml" id="id591042"></a> 16782 16810 <div class="header">Notes:</div> 16783 16811 <p xmlns="http://www.w3.org/1999/xhtml">It would be helpful to describe what an soname is and give … … 16802 16830 <div> 16803 16831 <div class="refsect1" lang="en" xml:lang="en"> 16804 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69282"></a>16832 <a xmlns="http://www.w3.org/1999/xhtml" id="id591099"></a> 16805 16833 <div class="header">Values:</div> 16806 16834 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">ptr</span></i>---<a xmlns="http://www.w3.org/1999/xhtml" class="link" href="#Referencing-and-Using-Foreign-Memory-Addresses" title="12.3. Referencing and Using Foreign Memory Addresses">a MACPTR</a>.</p> … … 16810 16838 </div> 16811 16839 <div class="refsect1" lang="en" xml:lang="en"> 16812 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69326"></a>16840 <a xmlns="http://www.w3.org/1999/xhtml" id="id591144"></a> 16813 16841 <div class="header">Description:</div> 16814 16842 <p xmlns="http://www.w3.org/1999/xhtml">References an instance of a foreign type (or a component of … … 16836 16864 <div> 16837 16865 <div class="refsect1" lang="en" xml:lang="en"> 16838 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69392"></a>16866 <a xmlns="http://www.w3.org/1999/xhtml" id="id591209"></a> 16839 16867 <div class="header">Values:</div> 16840 16868 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">eep</span></i>---An EXTERNAL-ENTRY-POINT, as obtained by the EXTERNAL … … 16842 16870 </div> 16843 16871 <div class="refsect1" lang="en" xml:lang="en"> 16844 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69415"></a>16872 <a xmlns="http://www.w3.org/1999/xhtml" id="id591232"></a> 16845 16873 <div class="header">Description:</div> 16846 16874 <p xmlns="http://www.w3.org/1999/xhtml">Tries to resolve the address of the EXTERNAL-ENTRY-POINT … … 16865 16893 <div> 16866 16894 <div class="refsect1" lang="en" xml:lang="en"> 16867 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69486"></a>16895 <a xmlns="http://www.w3.org/1999/xhtml" id="id591303"></a> 16868 16896 <div class="header">Values:</div> 16869 16897 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---A symbol (a lisp variable)</p> … … 16873 16901 </div> 16874 16902 <div class="refsect1" lang="en" xml:lang="en"> 16875 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69537"></a>16903 <a xmlns="http://www.w3.org/1999/xhtml" id="id591354"></a> 16876 16904 <div class="header">Description:</div> 16877 16905 <p xmlns="http://www.w3.org/1999/xhtml">Executes <em class="varname">body</em> … … 16903 16931 <div> 16904 16932 <div class="refsect1" lang="en" xml:lang="en"> 16905 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69618"></a>16933 <a xmlns="http://www.w3.org/1999/xhtml" id="id591435"></a> 16906 16934 <div class="header">Values:</div> 16907 16935 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">var</span></i>---A symbol (a lisp variable)</p> … … 16910 16938 </div> 16911 16939 <div class="refsect1" lang="en" xml:lang="en"> 16912 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69666"></a>16940 <a xmlns="http://www.w3.org/1999/xhtml" id="id591483"></a> 16913 16941 <div class="header">Description:</div> 16914 16942 <p xmlns="http://www.w3.org/1999/xhtml">Executes body in an environment in which each var is … … 16937 16965 <div> 16938 16966 <div class="refsect1" lang="en" xml:lang="en"> 16939 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69733"></a>16967 <a xmlns="http://www.w3.org/1999/xhtml" id="id591550"></a> 16940 16968 <div class="header">Values:</div> 16941 16969 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">object</span></i>---A CLOS object of a class for which there exists … … 16945 16973 </div> 16946 16974 <div class="refsect1" lang="en" xml:lang="en"> 16947 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69762"></a>16975 <a xmlns="http://www.w3.org/1999/xhtml" id="id591579"></a> 16948 16976 <div class="header">Description:</div> 16949 16977 <p xmlns="http://www.w3.org/1999/xhtml"> … … 16982 17010 </div> 16983 17011 <div class="refsect1" lang="en" xml:lang="en"> 16984 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69818"></a>17012 <a xmlns="http://www.w3.org/1999/xhtml" id="id591635"></a> 16985 17013 <div class="header">Example:</div> 16986 17014 <pre xmlns="http://www.w3.org/1999/xhtml" class="programlisting"> … … 16996 17024 </div> 16997 17025 <div class="refsect1" lang="en" xml:lang="en"> 16998 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69832"></a>17026 <a xmlns="http://www.w3.org/1999/xhtml" id="id591650"></a> 16999 17027 <div class="header">See Also:</div> 17000 17028 <span xmlns="http://www.w3.org/1999/xhtml" class="simplelist"> … … 17018 17046 <div> 17019 17047 <div class="refsect1" lang="en" xml:lang="en"> 17020 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69892"></a>17048 <a xmlns="http://www.w3.org/1999/xhtml" id="id591710"></a> 17021 17049 <div class="header">Values:</div> 17022 17050 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dir-id</span></i>---A keyword whose pname, mapped to lower case, names a … … 17025 17053 </div> 17026 17054 <div class="refsect1" lang="en" xml:lang="en"> 17027 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69916"></a>17055 <a xmlns="http://www.w3.org/1999/xhtml" id="id591733"></a> 17028 17056 <div class="header">Description:</div> 17029 17057 <p xmlns="http://www.w3.org/1999/xhtml">Tells <code class="literal">CCL</code> to remove the interface directory denoted by … … 17049 17077 <div> 17050 17078 <div class="refsect1" lang="en" xml:lang="en"> 17051 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 69976"></a>17079 <a xmlns="http://www.w3.org/1999/xhtml" id="id591794"></a> 17052 17080 <div class="header">Values:</div> 17053 17081 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">dir-id</span></i>---A keyword whose pname, mapped to lower case, names a … … 17056 17084 </div> 17057 17085 <div class="refsect1" lang="en" xml:lang="en"> 17058 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 70000"></a>17086 <a xmlns="http://www.w3.org/1999/xhtml" id="id591817"></a> 17059 17087 <div class="header">Description:</div> 17060 17088 <p xmlns="http://www.w3.org/1999/xhtml">Tells <code class="literal">CCL</code> to add the interface directory denoted by … … 17078 17106 </div> 17079 17107 <div class="refsect1" lang="en" xml:lang="en"> 17080 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 70038"></a>17108 <a xmlns="http://www.w3.org/1999/xhtml" id="id591855"></a> 17081 17109 <div class="header">Examples:</div> 17082 17110 <p xmlns="http://www.w3.org/1999/xhtml">One typically wants interface information to be … … 18731 18759 <div> 18732 18760 <div class="refsect1" lang="en" xml:lang="en"> 18733 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 62764"></a>18761 <a xmlns="http://www.w3.org/1999/xhtml" id="id582988"></a> 18734 18762 <div class="header">Arguments and Values:</div> 18735 18763 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string which is the name of an existing … … 18741 18769 </div> 18742 18770 <div class="refsect1" lang="en" xml:lang="en"> 18743 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 62809"></a>18771 <a xmlns="http://www.w3.org/1999/xhtml" id="id583033"></a> 18744 18772 <div class="header">Description:</div> 18745 18773 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18762 18790 <div> 18763 18791 <div class="refsect1" lang="en" xml:lang="en"> 18764 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 62870"></a>18792 <a xmlns="http://www.w3.org/1999/xhtml" id="id583094"></a> 18765 18793 <div class="header">Arguments and Values:</div> 18766 18794 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name</span></i>---a string which is the name of a new or existing … … 18775 18803 </div> 18776 18804 <div class="refsect1" lang="en" xml:lang="en"> 18777 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 62930"></a>18805 <a xmlns="http://www.w3.org/1999/xhtml" id="id583154"></a> 18778 18806 <div class="header">Description:</div> 18779 18807 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18799 18827 <div> 18800 18828 <div class="refsect1" lang="en" xml:lang="en"> 18801 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 62992"></a>18829 <a xmlns="http://www.w3.org/1999/xhtml" id="id583216"></a> 18802 18830 <div class="header">Values:</div> 18803 18831 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">path</span></i>---a string, an absolute pathname in Posix format - with … … 18805 18833 </div> 18806 18834 <div class="refsect1" lang="en" xml:lang="en"> 18807 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63019"></a>18835 <a xmlns="http://www.w3.org/1999/xhtml" id="id583243"></a> 18808 18836 <div class="header">Description:</div> 18809 18837 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18827 18855 <div> 18828 18856 <div class="refsect1" lang="en" xml:lang="en"> 18829 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63078"></a>18857 <a xmlns="http://www.w3.org/1999/xhtml" id="id583302"></a> 18830 18858 <div class="header">Values:</div> 18831 18859 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user … … 18833 18861 </div> 18834 18862 <div class="refsect1" lang="en" xml:lang="en"> 18835 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63105"></a>18863 <a xmlns="http://www.w3.org/1999/xhtml" id="id583329"></a> 18836 18864 <div class="header">Description:</div> 18837 18865 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18853 18881 <div> 18854 18882 <div class="refsect1" lang="en" xml:lang="en"> 18855 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63162"></a>18883 <a xmlns="http://www.w3.org/1999/xhtml" id="id583386"></a> 18856 18884 <div class="header">Arguments and Values:</div> 18857 18885 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user … … 18862 18890 </div> 18863 18891 <div class="refsect1" lang="en" xml:lang="en"> 18864 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63205"></a>18892 <a xmlns="http://www.w3.org/1999/xhtml" id="id584977"></a> 18865 18893 <div class="header">Description:</div> 18866 18894 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18885 18913 <div> 18886 18914 <div class="refsect1" lang="en" xml:lang="en"> 18887 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63264"></a>18915 <a xmlns="http://www.w3.org/1999/xhtml" id="id585036"></a> 18888 18916 <div class="header">Arguments and Values:</div> 18889 18917 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">gid</span></i>---a non-negative integer, identifying a specific … … 18894 18922 </div> 18895 18923 <div class="refsect1" lang="en" xml:lang="en"> 18896 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63307"></a>18924 <a xmlns="http://www.w3.org/1999/xhtml" id="id585079"></a> 18897 18925 <div class="header">Description:</div> 18898 18926 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18917 18945 <div> 18918 18946 <div class="refsect1" lang="en" xml:lang="en"> 18919 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63366"></a>18947 <a xmlns="http://www.w3.org/1999/xhtml" id="id585138"></a> 18920 18948 <div class="header">Values:</div> 18921 18949 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">pid</span></i>---a non-negative integer, identifying an OS process</p> 18922 18950 </div> 18923 18951 <div class="refsect1" lang="en" xml:lang="en"> 18924 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63392"></a>18952 <a xmlns="http://www.w3.org/1999/xhtml" id="id585164"></a> 18925 18953 <div class="header">Description:</div> 18926 18954 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18943 18971 <div> 18944 18972 <div class="refsect1" lang="en" xml:lang="en"> 18945 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63449"></a>18973 <a xmlns="http://www.w3.org/1999/xhtml" id="id585221"></a> 18946 18974 <div class="header">Values:</div> 18947 18975 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">uid</span></i>---a non-negative integer, identifying a specific user … … 18951 18979 </div> 18952 18980 <div class="refsect1" lang="en" xml:lang="en"> 18953 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63492"></a>18981 <a xmlns="http://www.w3.org/1999/xhtml" id="id585264"></a> 18954 18982 <div class="header">Description:</div> 18955 18983 <p xmlns="http://www.w3.org/1999/xhtml"> … … 18976 19004 <div> 18977 19005 <div class="refsect1" lang="en" xml:lang="en"> 18978 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63561"></a>19006 <a xmlns="http://www.w3.org/1999/xhtml" id="id585333"></a> 18979 19007 <div class="header">Values:</div> 18980 19008 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">command-line</span></i>---a string, obeying all the whitespace and … … 18985 19013 </div> 18986 19014 <div class="refsect1" lang="en" xml:lang="en"> 18987 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63603"></a>19015 <a xmlns="http://www.w3.org/1999/xhtml" id="id585375"></a> 18988 19016 <div class="header">Description:</div> 18989 19017 <p xmlns="http://www.w3.org/1999/xhtml"> … … 19001 19029 </div> 19002 19030 <div class="refsect1" lang="en" xml:lang="en"> 19003 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63637"></a>19031 <a xmlns="http://www.w3.org/1999/xhtml" id="id585409"></a> 19004 19032 <div class="header">Notes:</div> 19005 19033 <p xmlns="http://www.w3.org/1999/xhtml"> … … 19026 19054 <div> 19027 19055 <div class="refsect1" lang="en" xml:lang="en"> 19028 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63697"></a>19056 <a xmlns="http://www.w3.org/1999/xhtml" id="id585469"></a> 19029 19057 <div class="header">Arguments and Values:</div> 19030 19058 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">class-name</span></i>---a string which denotes an existing class name, or a … … 19033 19061 </div> 19034 19062 <div class="refsect1" lang="en" xml:lang="en"> 19035 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63725"></a>19063 <a xmlns="http://www.w3.org/1999/xhtml" id="id585497"></a> 19036 19064 <div class="header">Description:</div> 19037 19065 <p xmlns="http://www.w3.org/1999/xhtml">Used to refer to a known ObjC class by name. (Via the use … … 19058 19086 <div> 19059 19087 <div class="refsect1" lang="en" xml:lang="en"> 19060 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63794"></a>19088 <a xmlns="http://www.w3.org/1999/xhtml" id="id585566"></a> 19061 19089 <div class="header">Arguments and Values:</div> 19062 19090 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">string</span></i>---a string constant, used to canonically refer to an … … 19064 19092 </div> 19065 19093 <div class="refsect1" lang="en" xml:lang="en"> 19066 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63820"></a>19094 <a xmlns="http://www.w3.org/1999/xhtml" id="id585592"></a> 19067 19095 <div class="header">Description:</div> 19068 19096 <p xmlns="http://www.w3.org/1999/xhtml">Used to refer to an ObjC method selector (method name). Uses … … 19086 19114 <div> 19087 19115 <div class="refsect1" lang="en" xml:lang="en"> 19088 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63886"></a>19116 <a xmlns="http://www.w3.org/1999/xhtml" id="id585658"></a> 19089 19117 <div class="header">Arguments and Values:</div> 19090 19118 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">name-and-result-type</span></i>---either an Objective-C message name, for methods … … 19108 19136 </div> 19109 19137 <div class="refsect1" lang="en" xml:lang="en"> 19110 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 63967"></a>19138 <a xmlns="http://www.w3.org/1999/xhtml" id="id585739"></a> 19111 19139 <div class="header">Description:</div> 19112 19140 <p xmlns="http://www.w3.org/1999/xhtml">Defines an Objective-C-callable method which implements … … 19133 19161 <div> 19134 19162 <div class="refsect1" lang="en" xml:lang="en"> 19135 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 64049"></a>19163 <a xmlns="http://www.w3.org/1999/xhtml" id="id585821"></a> 19136 19164 <div class="header">Arguments and Values:</div> 19137 19165 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">selector</span></i>---either a string which represents the name of the … … 19148 19176 </div> 19149 19177 <div class="refsect1" lang="en" xml:lang="en"> 19150 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 64095"></a>19178 <a xmlns="http://www.w3.org/1999/xhtml" id="id585867"></a> 19151 19179 <div class="header">Description:</div> 19152 19180 <p xmlns="http://www.w3.org/1999/xhtml">Defines an ObjC-callable method which implements the … … 19169 19197 <div> 19170 19198 <div class="refsect1" lang="en" xml:lang="en"> 19171 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 64158"></a>19199 <a xmlns="http://www.w3.org/1999/xhtml" id="id585931"></a> 19172 19200 <div class="header">Arguments and Values:</div> 19173 19201 <p xmlns="http://www.w3.org/1999/xhtml">As per DEFINE-OBJC-METHOD</p> 19174 19202 </div> 19175 19203 <div class="refsect1" lang="en" xml:lang="en"> 19176 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 64170"></a>19204 <a xmlns="http://www.w3.org/1999/xhtml" id="id585942"></a> 19177 19205 <div class="header">Description:</div> 19178 19206 <p xmlns="http://www.w3.org/1999/xhtml">Like DEFINE-OBJC-METHOD, only used to define methods on the … … 19216 19244 <div> 19217 19245 <div class="refsect1" lang="en" xml:lang="en"> 19218 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53434"></a>19246 <a xmlns="http://www.w3.org/1999/xhtml" id="id575244"></a> 19219 19247 <div class="header">Description:</div> 19220 19248 <p xmlns="http://www.w3.org/1999/xhtml">This variable is currently only used by the standard reader macro … … 19251 19279 <div> 19252 19280 <div class="refsect1" lang="en" xml:lang="en"> 19253 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53491"></a>19281 <a xmlns="http://www.w3.org/1999/xhtml" id="id575302"></a> 19254 19282 <div class="header">Description:</div> 19255 19283 <p xmlns="http://www.w3.org/1999/xhtml">Per ANSI CL, Clozure CL supports the :EXTERNAL-FORMAT keyword … … 19295 19323 <div> 19296 19324 <div class="refsect1" lang="en" xml:lang="en"> 19297 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53572"></a>19325 <a xmlns="http://www.w3.org/1999/xhtml" id="id575382"></a> 19298 19326 <div class="header">Description:</div> 19299 19327 <p xmlns="http://www.w3.org/1999/xhtml">The value of this variable is used when :EXTERNAL-FORMAT is … … 19319 19347 <div> 19320 19348 <div class="refsect1" lang="en" xml:lang="en"> 19321 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53622"></a>19349 <a xmlns="http://www.w3.org/1999/xhtml" id="id575432"></a> 19322 19350 <div class="header">Superclasses:</div> 19323 19351 <p xmlns="http://www.w3.org/1999/xhtml">NS:NS-STRING</p> 19324 19352 </div> 19325 19353 <div class="refsect1" lang="en" xml:lang="en"> 19326 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53633"></a>19354 <a xmlns="http://www.w3.org/1999/xhtml" id="id575443"></a> 19327 19355 <div class="header">Initargs:</div> 19328 19356 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">:string</span></i>--- … … 19332 19360 </div> 19333 19361 <div class="refsect1" lang="en" xml:lang="en"> 19334 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53660"></a>19362 <a xmlns="http://www.w3.org/1999/xhtml" id="id575470"></a> 19335 19363 <div class="header">Description:</div> 19336 19364 <p xmlns="http://www.w3.org/1999/xhtml"> … … 19350 19378 </div> 19351 19379 <div class="refsect1" lang="en" xml:lang="en"> 19352 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53679"></a>19380 <a xmlns="http://www.w3.org/1999/xhtml" id="id575490"></a> 19353 19381 <div class="header">Examples:</div> 19354 19382 <p xmlns="http://www.w3.org/1999/xhtml"> … … 19381 19409 </div> 19382 19410 <div class="refsect1" lang="en" xml:lang="en"> 19383 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53732"></a>19411 <a xmlns="http://www.w3.org/1999/xhtml" id="id575543"></a> 19384 19412 <div class="header">Notes:</div> 19385 19413 <p xmlns="http://www.w3.org/1999/xhtml"> … … 19721 19749 <div> 19722 19750 <div class="refsect1" lang="en" xml:lang="en"> 19723 <a xmlns="http://www.w3.org/1999/xhtml" id="id 484514"></a>19751 <a xmlns="http://www.w3.org/1999/xhtml" id="id559835"></a> 19724 19752 <div class="header">Arguments and Values:</div> 19725 19753 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">type</span></i>---The type of population, one of <code xmlns="http://www.w3.org/1999/xhtml" class="literal">:LIST</code> (the default) or <code xmlns="http://www.w3.org/1999/xhtml" class="literal">:ALIST</code></p> … … 19729 19757 </div> 19730 19758 <div class="refsect1" lang="en" xml:lang="en"> 19731 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37465"></a>19759 <a xmlns="http://www.w3.org/1999/xhtml" id="id559894"></a> 19732 19760 <div class="header">Description:</div> 19733 19761 <p xmlns="http://www.w3.org/1999/xhtml">Creates a new population of the specified type.</p> … … 19747 19775 <div> 19748 19776 <div class="refsect1" lang="en" xml:lang="en"> 19749 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37522"></a>19777 <a xmlns="http://www.w3.org/1999/xhtml" id="id559468"></a> 19750 19778 <div class="header">Description:</div> 19751 19779 <p xmlns="http://www.w3.org/1999/xhtml">returns the type of <code class="literal">population</code>, one of <code class="literal">:LIST</code> or <code class="literal">:ALIST</code></p> … … 19765 19793 <div> 19766 19794 <div class="refsect1" lang="en" xml:lang="en"> 19767 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37597"></a>19795 <a xmlns="http://www.w3.org/1999/xhtml" id="id559542"></a> 19768 19796 <div class="header">Description:</div> 19769 19797 <p xmlns="http://www.w3.org/1999/xhtml">returns the list encapsulated in <code class="literal">population</code>. … … 19788 19816 <div> 19789 19817 <div class="refsect1" lang="en" xml:lang="en"> 19790 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37665"></a>19818 <a xmlns="http://www.w3.org/1999/xhtml" id="id559611"></a> 19791 19819 <div class="header">Description:</div> 19792 19820 <p xmlns="http://www.w3.org/1999/xhtml">Sets the list encapsulated in <code class="literal">population</code> to … … 19821 19849 <div> 19822 19850 <div class="refsect1" lang="en" xml:lang="en"> 19823 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37750"></a>19851 <a xmlns="http://www.w3.org/1999/xhtml" id="id559696"></a> 19824 19852 <div class="header">Description:</div> 19825 19853 <p xmlns="http://www.w3.org/1999/xhtml">Returns the value of the kernel variable that specifies the … … 19842 19870 <div> 19843 19871 <div class="refsect1" lang="en" xml:lang="en"> 19844 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53785"></a>19872 <a xmlns="http://www.w3.org/1999/xhtml" id="id575582"></a> 19845 19873 <div class="header">Arguments and Values:</div> 19846 19874 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">new-threshold</span></i>---The requested new lisp-heap-gc-threshold.</p> 19847 19875 </div> 19848 19876 <div class="refsect1" lang="en" xml:lang="en"> 19849 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53811"></a>19877 <a xmlns="http://www.w3.org/1999/xhtml" id="id575608"></a> 19850 19878 <div class="header">Description:</div> 19851 19879 <p xmlns="http://www.w3.org/1999/xhtml">Sets the value of the kernel variable that specifies the … … 19871 19899 <div> 19872 19900 <div class="refsect1" lang="en" xml:lang="en"> 19873 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53872"></a>19901 <a xmlns="http://www.w3.org/1999/xhtml" id="id575670"></a> 19874 19902 <div class="header">Description:</div> 19875 19903 <p xmlns="http://www.w3.org/1999/xhtml">Tries to grow or shrink lisp's heap space, so that the … … 19891 19919 <div> 19892 19920 <div class="refsect1" lang="en" xml:lang="en"> 19893 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53931"></a>19921 <a xmlns="http://www.w3.org/1999/xhtml" id="id575728"></a> 19894 19922 <div class="header">Arguments and Values:</div> 19895 19923 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">arg</span></i>---a generalized boolean</p> 19896 19924 </div> 19897 19925 <div class="refsect1" lang="en" xml:lang="en"> 19898 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 53957"></a>19926 <a xmlns="http://www.w3.org/1999/xhtml" id="id575754"></a> 19899 19927 <div class="header">Description:</div> 19900 19928 <p xmlns="http://www.w3.org/1999/xhtml">Enables the EGC if arg is non-nil, disables the EGC … … 19922 19950 <div> 19923 19951 <div class="refsect1" lang="en" xml:lang="en"> 19924 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54015"></a>19952 <a xmlns="http://www.w3.org/1999/xhtml" id="id575813"></a> 19925 19953 <div class="header">Description:</div> 19926 19954 <p xmlns="http://www.w3.org/1999/xhtml">Returns T if the EGC was enabled at the time of the call, … … 19945 19973 <div> 19946 19974 <div class="refsect1" lang="en" xml:lang="en"> 19947 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54071"></a>19975 <a xmlns="http://www.w3.org/1999/xhtml" id="id575869"></a> 19948 19976 <div class="header">Description:</div> 19949 19977 <p xmlns="http://www.w3.org/1999/xhtml">Returns T if the EGC was active at the time of the call, NIL … … 19970 19998 <div> 19971 19999 <div class="refsect1" lang="en" xml:lang="en"> 19972 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54129"></a>20000 <a xmlns="http://www.w3.org/1999/xhtml" id="id575927"></a> 19973 20001 <div class="header">Description:</div> 19974 20002 <p xmlns="http://www.w3.org/1999/xhtml">Returns, as multiple values, the sizes in kilobytes of the … … 19992 20020 <div> 19993 20021 <div class="refsect1" lang="en" xml:lang="en"> 19994 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54188"></a>20022 <a xmlns="http://www.w3.org/1999/xhtml" id="id575985"></a> 19995 20023 <div class="header">Arguments and Values:</div> 19996 20024 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">generation-0-size</span></i>---the requested threshold size of the youngest … … 20002 20030 </div> 20003 20031 <div class="refsect1" lang="en" xml:lang="en"> 20004 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54243"></a>20032 <a xmlns="http://www.w3.org/1999/xhtml" id="id576041"></a> 20005 20033 <div class="header">Description:</div> 20006 20034 <p xmlns="http://www.w3.org/1999/xhtml">Puts the indicated threshold sizes in effect. … … 20026 20054 <div> 20027 20055 <div class="refsect1" lang="en" xml:lang="en"> 20028 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54309"></a>20056 <a xmlns="http://www.w3.org/1999/xhtml" id="id576106"></a> 20029 20057 <div class="header">Arguments and Values:</div> 20030 20058 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">arg</span></i>---a generalized boolean</p> 20031 20059 </div> 20032 20060 <div class="refsect1" lang="en" xml:lang="en"> 20033 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54335"></a>20061 <a xmlns="http://www.w3.org/1999/xhtml" id="id576132"></a> 20034 20062 <div class="header">Description:</div> 20035 20063 <p xmlns="http://www.w3.org/1999/xhtml">Tries to influence the GC to retain/recycle the pages … … 20056 20084 <div> 20057 20085 <div class="refsect1" lang="en" xml:lang="en"> 20058 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 54393"></a>20086 <a xmlns="http://www.w3.org/1999/xhtml" id="id576190"></a> 20059 20087 <div class="header">Description:</div> 20060 20088 <p xmlns="http://www.w3.org/1999/xhtml">Returns T if the GC tries to retain pages between full GCs … … 20211 20239 <dt> 20212 20240 <span class="sect2"> 20213 <a href="#id5 59559">16.7.2. Recommended Reading</a>20241 <a href="#id581356">16.7.2. Recommended Reading</a> 20214 20242 </span> 20215 20243 </dt> … … 21487 21515 <li class="listitem"> 21488 21516 <p>To support a feature called <span class="emphasis"><em>GCTWA 21489 <sup>[<a id="id5 59113" href="#ftn.id559113" class="footnote">1</a>]</sup>21517 <sup>[<a id="id580910" href="#ftn.id580910" class="footnote">1</a>]</sup> 21490 21518 , </em></span>the vector that contains the internal 21491 21519 symbols of the current package is marked on entry to the … … 21620 21648 <hr width="100" align="left" /> 21621 21649 <div class="footnote"> 21622 <p><sup>[<a id="ftn.id5 59113" href="#id559113" class="para">1</a>] </sup>I believe that the acronym comes from MACLISP,21650 <p><sup>[<a id="ftn.id580910" href="#id580910" class="para">1</a>] </sup>I believe that the acronym comes from MACLISP, 21623 21651 where it stood for "Garbage Collection of Truly 21624 21652 Worthless Atoms".</p> … … 21680 21708 generations looking for such intergenerational references, the 21681 21709 runtime system must note all such intergenerational references 21682 at the point where they're created (via Setf).<sup>[<a id="id5 59347" href="#ftn.id559347" class="footnote">2</a>]</sup> The21710 at the point where they're created (via Setf).<sup>[<a id="id581144" href="#ftn.id581144" class="footnote">2</a>]</sup> The 21683 21711 set of pointers that may contain intergenerational references is 21684 21712 sometimes called <span class="emphasis"><em>the remembered set</em></span>.</p> … … 21727 21755 that might introduce an intergenerational reference must be 21728 21756 memoized. 21729 <sup>[<a id="id5 59416" href="#ftn.id559416" class="footnote">3</a>]</sup> It's always safe to21757 <sup>[<a id="id581213" href="#ftn.id581213" class="footnote">3</a>]</sup> It's always safe to 21730 21758 push any cons cell or gvector locative onto the memo stack; 21731 21759 it's never safe to push anything else. … … 21748 21776 <hr width="100" align="left" /> 21749 21777 <div class="footnote"> 21750 <p><sup>[<a id="ftn.id5 59347" href="#id559347" class="para">2</a>] </sup>This is21778 <p><sup>[<a id="ftn.id581144" href="#id581144" class="para">2</a>] </sup>This is 21751 21779 sometimes called "The Write Barrier": all assignments which 21752 21780 might result in intergenerational references must be noted, as … … 21754 21782 </div> 21755 21783 <div class="footnote"> 21756 <p><sup>[<a id="ftn.id5 59416" href="#id559416" class="para">3</a>] </sup>Note that the implicit setfs that occur when21784 <p><sup>[<a id="ftn.id581213" href="#id581213" class="para">3</a>] </sup>Note that the implicit setfs that occur when 21757 21785 initializing an object - as in the case of a call to cons or 21758 21786 vector - can't introduce intergenerational references, since … … 21870 21898 <div> 21871 21899 <div> 21872 <h3 class="title"><a id="id5 59559"></a>16.7.2. Recommended Reading</h3>21900 <h3 class="title"><a id="id581356"></a>16.7.2. Recommended Reading</h3> 21873 21901 </div> 21874 21902 </div> … … 22283 22311 <div> 22284 22312 <div class="refsect1" lang="en" xml:lang="en"> 22285 <a xmlns="http://www.w3.org/1999/xhtml" id="id 478654"></a>22313 <a xmlns="http://www.w3.org/1999/xhtml" id="id521564"></a> 22286 22314 <div class="header">Description:</div> 22287 22315 <p xmlns="http://www.w3.org/1999/xhtml">When true, attempts to redefine (via DEFUN or DEFMETHOD) … … 22308 22336 <div> 22309 22337 <div class="refsect1" lang="en" xml:lang="en"> 22310 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32512"></a>22338 <a xmlns="http://www.w3.org/1999/xhtml" id="id571272"></a> 22311 22339 <div class="header">Description:</div> 22312 22340 <p xmlns="http://www.w3.org/1999/xhtml">Arranges that the outermost special bindings of *PACKAGE* … … 22332 22360 <div> 22333 22361 <div class="refsect1" lang="en" xml:lang="en"> 22334 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 61338"></a>22362 <a xmlns="http://www.w3.org/1999/xhtml" id="id584401"></a> 22335 22363 <div class="header">Description:</div> 22336 22364 <p xmlns="http://www.w3.org/1999/xhtml">Arranges that the outermost special bindings of *PACKAGE* … … 22355 22383 <div> 22356 22384 <div class="refsect1" lang="en" xml:lang="en"> 22357 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 32104"></a>22385 <a xmlns="http://www.w3.org/1999/xhtml" id="id584446"></a> 22358 22386 <div class="header">Description:</div> 22359 22387 <p xmlns="http://www.w3.org/1999/xhtml">This variable is initialized each time an Clozure CL session … … 22380 22408 <div> 22381 22409 <div class="refsect1" lang="en" xml:lang="en"> 22382 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 37975"></a>22410 <a xmlns="http://www.w3.org/1999/xhtml" id="id582540"></a> 22383 22411 <div class="header">Description:</div> 22384 22412 <p xmlns="http://www.w3.org/1999/xhtml">Returns non-NIL if AltiVec is available.</p> … … 22398 22426 <div> 22399 22427 <div class="refsect1" lang="en" xml:lang="en"> 22400 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 38018"></a>22428 <a xmlns="http://www.w3.org/1999/xhtml" id="id582583"></a> 22401 22429 <div class="header">Description:</div> 22402 22430 <p xmlns="http://www.w3.org/1999/xhtml">Intended to control the expansion of certain lap macros. … … 22420 22448 <div> 22421 22449 <div class="refsect1" lang="en" xml:lang="en"> 22422 <a xmlns="http://www.w3.org/1999/xhtml" id="id51 0158"></a>22450 <a xmlns="http://www.w3.org/1999/xhtml" id="id511450"></a> 22423 22451 <div class="header">Arguments and Values:</div> 22424 22452 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">reglist</span></i>---A list of vector register names (vr0 .. vr31).</p> … … 22426 22454 </div> 22427 22455 <div class="refsect1" lang="en" xml:lang="en"> 22428 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 10199"></a>22456 <a xmlns="http://www.w3.org/1999/xhtml" id="id581438"></a> 22429 22457 <div class="header">Description:</div> 22430 22458 <p xmlns="http://www.w3.org/1999/xhtml">Specifies the set of AltiVec registers used in body. If … … 22452 22480 <div> 22453 22481 <div class="refsect1" lang="en" xml:lang="en"> 22454 <a xmlns="http://www.w3.org/1999/xhtml" id="id5 60934"></a>22482 <a xmlns="http://www.w3.org/1999/xhtml" id="id581499"></a> 22455 22483 <div class="header">Arguments and Values:</div> 22456 22484 <p><i><span xmlns="http://www.w3.org/1999/xhtml" class="term">base</span></i>---Any available general-purpose register.</p> … … 22461 22489 </div> 22462 22490 <div class="refsect1" lang="en" xml:lang="en"> 22463 <a xmlns="http://www.w3.org/1999/xhtml" id="id 485784"></a>22491 <a xmlns="http://www.w3.org/1999/xhtml" id="id584578"></a> 22464 22492 <div class="header">Description:</div> 22465 22493 <p xmlns="http://www.w3.org/1999/xhtml">Generates code which allocates a 16-byte aligned buffer … … 23139 23167 <a href="#Symbol-Index">Symbol Index</a> 23140 23168 </div> 23141 <p xmlns="http://www.w3.org/TR/xhtml1/transitional" xmlns:date="http://exslt.org/dates-and-times" class="footer">This document was last modified at 18:0 on December 30, 2010, in UTC.<br></br>It uses version 1.75.2 of the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 14529<br></br>Using libxml 20706, libxslt 10126 and libexslt 815.</p>23169 <p xmlns="http://www.w3.org/TR/xhtml1/transitional" xmlns:date="http://exslt.org/dates-and-times" class="footer">This document was last modified at 8:0 on February 3, 2011, in UTC.<br></br>It uses version 1.75.2 of the Norman Walsh Docbook stylesheets.<br></br>Built from subversion rev 14634<br></br>Using libxml 20706, libxslt 10126 and libexslt 815.</p> 23142 23170 </body> 23143 23171 </html>
Note:
See TracChangeset
for help on using the changeset viewer.
