mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-28 00:01:33 -08:00
238 lines
No EOL
16 KiB
HTML
238 lines
No EOL
16 KiB
HTML
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>Reference — Memory Pool System 1.111.0 documentation</title>
|
|
|
|
<link rel="stylesheet" href="../_static/mps.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '../',
|
|
VERSION: '1.111.0',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="../_static/jquery.js"></script>
|
|
<script type="text/javascript" src="../_static/underscore.js"></script>
|
|
<script type="text/javascript" src="../_static/doctools.js"></script>
|
|
<link rel="copyright" title="Copyright" href="../copyright.html" />
|
|
<link rel="top" title="Memory Pool System 1.111.0 documentation" href="../index.html" />
|
|
<link rel="next" title="1. Interface conventions" href="interface.html" />
|
|
<link rel="prev" title="6. Advanced topics" href="../guide/advanced.html" />
|
|
</head>
|
|
<body>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="General Index"
|
|
accesskey="I">index</a></li>
|
|
<li class="right" >
|
|
<a href="interface.html" title="1. Interface conventions"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="../guide/advanced.html" title="6. Advanced topics"
|
|
accesskey="P">previous</a> |</li>
|
|
<li><a href="../index.html">Memory Pool System 1.111.0 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<div class="section" id="reference">
|
|
<span id="id1"></span><h1>Reference<a class="headerlink" href="#reference" title="Permalink to this headline">¶</a></h1>
|
|
<div class="toctree-wrapper compound">
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="interface.html">1. Interface conventions</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#support-policy">1.1. Support policy</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#language">1.2. Language</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#headers">1.3. Headers</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#index-4">1.4. Identifiers</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#types">1.5. Types</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#functions">1.6. Functions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#type-punning">1.7. Type punning</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#macros">1.8. Macros</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="interface.html#general-types">1.9. General types</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="error.html">2. Error handing</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="error.html#result-codes">2.1. Result codes</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="error.html#assertions">2.2. Assertions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="error.html#common-assertions-and-their-causes">2.3. Common assertions and their causes</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="error.html#varieties">2.4. Varieties</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="arena.html">3. Arenas</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#client-arenas">3.1. Client arenas</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#virtual-memory-arenas">3.2. Virtual memory arenas</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#arena-properties">3.3. Arena properties</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#arena-states">3.4. Arena states</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#running-garbage-collections">3.5. Running garbage collections</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#using-idle-time-for-collection">3.6. Using idle time for collection</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#arena-introspection">3.7. Arena introspection</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="arena.html#protection-interface">3.8. Protection interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="pool.html">4. Pools</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="pool.html#pool-classes">4.1. Pool classes</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="pool.html#pool-introspection">4.2. Pool introspection</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="allocation.html">5. Allocation</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#manual-allocation">5.1. Manual allocation</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#allocation-points">5.2. Allocation points</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#allocation-point-protocol">5.3. Allocation point protocol</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#example-allocating-a-symbol">5.4. Example: allocating a symbol</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#cautions">5.5. Cautions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#example-inserting-into-a-doubly-linked-list">5.6. Example: inserting into a doubly linked list</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="allocation.html#allocation-point-implementation">5.7. Allocation point implementation</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="format.html">6. Object formats</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="format.html#creating-an-object-format">6.1. Creating an object format</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="format.html#cautions">6.2. Cautions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="format.html#format-methods">6.3. Format methods</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="format.html#object-format-introspection">6.4. Object format introspection</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="scanning.html">7. Scanning</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#scanning-protocol">7.1. Scanning protocol</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#tagged-references">7.2. Tagged references</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#critical-path">7.3. Critical path</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#ambiguous-references">7.4. Ambiguous references</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#unfixed-references">7.5. Unfixed references</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#example-scheme-objects">7.6. Example: Scheme objects</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#scanning-interface">7.7. Scanning interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="scanning.html#fixing-interface">7.8. Fixing interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="thread.html">8. Threads</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="thread.html#thread-safety">8.1. Thread safety</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="thread.html#thread-registration">8.2. Thread registration</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="thread.html#signal-handling-issues">8.3. Signal handling issues</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="thread.html#thread-interface">8.4. Thread interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="root.html">9. Roots</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#registering-roots">9.1. Registering roots</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#cautions">9.2. Cautions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#thread-roots">9.3. Thread roots</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#ranks">9.4. Ranks</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#root-modes">9.5. Root modes</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#root-interface">9.6. Root interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="root.html#root-introspection">9.7. Root introspection</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="collection.html">10. Garbage collection</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="collection.html#generation-chains">10.1. Generation chains</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="collection.html#scheduling-of-collections">10.2. Scheduling of collections</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="collection.html#garbage-collection-start-messages">10.3. Garbage collection start messages</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="collection.html#garbage-collection-messages">10.4. Garbage collection messages</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="message.html">11. Messages</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="message.html#finalization-messages">11.1. Finalization messages</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="message.html#example-interactive-chatter">11.2. Example: interactive chatter</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="message.html#message-types">11.3. Message types</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="message.html#message-interface">11.4. Message interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="message.html#message-queue-interface">11.5. Message queue interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="finalization.html">12. Finalization</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="finalization.html#multiple-finalizations">12.1. Multiple finalizations</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="finalization.html#cautions">12.2. Cautions</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="finalization.html#finalization-interface">12.3. Finalization interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="finalization.html#finalization-messages">12.4. Finalization messages</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="location.html">13. Location dependency</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#terminology">13.1. Terminology</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#creating-dependencies">13.2. Creating dependencies</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#adding-dependencies">13.3. Adding dependencies</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#testing-dependencies-for-staleness">13.4. Testing dependencies for staleness</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#thread-safety">13.5. Thread safety</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="location.html#location-dependency-interface">13.6. Location dependency interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="cache.html">14. Segregated allocation caches</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="cache.html#cache-interface">14.1. Cache interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="cache.html#allocation-interface">14.2. Allocation interface</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="pattern.html">15. Allocation patterns</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="pattern.html#ramp-allocation">15.1. Ramp allocation</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="frame.html">16. Allocation frames</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="debugging.html">17. Debugging pools</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="telemetry.html">18. Telemetry</a><ul>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#telemetry-utilities">18.1. Telemetry utilities</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#example">18.2. Example</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#event-categories">18.3. Event categories</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#environment-variables">18.4. Environment variables</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#decoding-the-telemetry-stream">18.5. Decoding the telemetry stream</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#loading-the-telemetry-stream-into-sqlite">18.6. Loading the telemetry stream into SQLite</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#telemetry-interface">18.7. Telemetry interface</a></li>
|
|
<li class="toctree-l2"><a class="reference internal" href="telemetry.html#telemetry-labels">18.8. Telemetry labels</a></li>
|
|
</ul>
|
|
</li>
|
|
<li class="toctree-l1"><a class="reference internal" href="weak.html">19. Weak references</a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<p class="logo"><a href="../index.html">
|
|
<img class="logo" src="../_static/logo.png" alt="Logo"/>
|
|
</a></p>
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="../guide/advanced.html"
|
|
title="previous chapter">6. Advanced topics</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="interface.html"
|
|
title="next chapter">1. Interface conventions</a></p><h4>Contact us</h4>
|
|
|
|
<p class="topless"><a href="mailto:mps-questions@ravenbrook.com">mps-questions@ravenbrook.com</a></p>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="General Index"
|
|
>index</a></li>
|
|
<li class="right" >
|
|
<a href="interface.html" title="1. Interface conventions"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="../guide/advanced.html" title="6. Advanced topics"
|
|
>previous</a> |</li>
|
|
<li><a href="../index.html">Memory Pool System 1.111.0 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer">
|
|
© <a href="../copyright.html">Copyright</a> 2012, Ravenbrook Limited.
|
|
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
|
|
</div>
|
|
</body>
|
|
</html> |