<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta name="robots" content="index,nofollow"> <title>Stabilizers - MLton Standard ML Compiler (SML Compiler)</title> <link rel="stylesheet" type="text/css" charset="iso-8859-1" media="all" href="common.css"> <link rel="stylesheet" type="text/css" charset="iso-8859-1" media="screen" href="screen.css"> <link rel="stylesheet" type="text/css" charset="iso-8859-1" media="print" href="print.css"> <link rel="Start" href="Home"> <link rel="Appendix" title="stabilizers_alpha_2006-09-29.tar.gz" href="http://mlton.org/pages/Stabilizers/attachments/stabilizers_alpha_2006-09-29.tar.gz"> <link rel="Appendix" title="stabilizers_alpha_2006-10-09.tar.gz" href="http://mlton.org/pages/Stabilizers/attachments/stabilizers_alpha_2006-10-09.tar.gz"> </head> <body lang="en" dir="ltr"> <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"> </script> <script type="text/javascript"> _uacct = "UA-833377-1"; urchinTracker(); </script> <table bgcolor = lightblue cellspacing = 0 style = "border: 0px;" width = 100%> <tr> <td style = " border: 0px; color: darkblue; font-size: 150%; text-align: left;"> <a class = mltona href="Home">MLton MLTONWIKIVERSION</a> <td style = " border: 0px; font-size: 150%; text-align: center; width: 50%;"> Stabilizers <td style = " border: 0px; text-align: right;"> <table cellspacing = 0 style = "border: 0px"> <tr style = "vertical-align: middle;"> </table> <tr style = "background-color: white;"> <td colspan = 3 style = " border: 0px; font-size:70%; text-align: right;"> <a href = "Home">Home</a> <a href = "TitleIndex">Index</a> </table> <div id="content" lang="en" dir="ltr"> <h2 id="head-c81b79df3c6448eae7c4f80428b54cd5692a17d7">Installation</h2> <ul> <li> <p> Stabilizers currently require the MLton sources, this should be fixed by the next release </p> </li> </ul> <h2 id="head-3229609e15436ec51bcf00818a69a84dbc58a0c2">License</h2> <ul> <li> <p> Stabilizers are released under the MLton License </p> </li> </ul> <h2 id="head-ed58f29743f8e14b9c8e13d41e070a1cc1d1c9f5">Instructions</h2> <ul> <li> <p> Download and build a source copy of MLton </p> </li> <li> <p> Extract the tar.gz file attached to this wiki page </p> </li> <li> <p> Some examples are provided in the "examples/" sub directory, more examples will be added to this page in the following week </p> </li> </ul> <h2 id="head-a1ce09c8340ea8a92a6ab955588a7dfba7597534">Bug reports / Suggestions</h2> <ul> <li> <p> Please send any errors you encounter to schatzp and lziarek at cs.purdue.edu </p> </li> <li> <p> We are looking to expand the usability of stabilizers </p> </li> <li> <p> Please send any suggestions and desired functionality to the above email addresses </p> </li> </ul> <h2 id="head-2c924e3088204ee77ba681f72be3444357932fca">Note</h2> <ul> <li> <p> This is an alpha release. We expect to have another release shortly with added functionality soon </p> </li> <li> <p> More documentation, such as signatures and descriptions of functionality, will be forthcoming </p> </li> </ul> <h2 id="head-9e9cf3221a30246219863f1d2366e36cb580debc">Documentation</h2> <pre class=code> <B><FONT COLOR="#0000FF">signature</FONT></B> STABLE = <B><FONT COLOR="#0000FF">sig</FONT></B> <B><FONT COLOR="#A020F0">type</FONT></B><B><FONT COLOR="#228B22"> checkpoint </FONT></B><B><FONT COLOR="#A020F0">val</FONT></B> stable: ('a -> 'b) -> ('a -> 'b) <B><FONT COLOR="#A020F0">val</FONT></B> stabilize: unit -> 'a <B><FONT COLOR="#A020F0">val</FONT></B> stableCP: (('a -> 'b) * (unit -> unit)) -> (('a -> 'b) * checkpoint) <B><FONT COLOR="#A020F0">val</FONT></B> stabilizeCP: checkpoint -> unit <B><FONT COLOR="#A020F0">val</FONT></B> unmonitoredAssign: ('a ref * 'a) -> unit <B><FONT COLOR="#A020F0">val</FONT></B> monitoredAssign: ('a ref * 'a) -> unit <B><FONT COLOR="#0000FF">end</FONT></B> </PRE> <p> </p> <p> <tt>Stable</tt> provides functions to manage stable sections. </p> <ul> <li> <p> <tt>type checkpoint</tt> <br> handle used to stabilize contexts other than the current one. </p> </li> <li class="gap"> <p> <tt>stable f</tt> <br> returns a function identical to <tt>f</tt> that will execute within a stable section. </p> </li> <li class="gap"> <p> <tt>stabilize ()</tt> <br> unrolls the effects made up to the current context to at least the nearest enclosing {{stable}}} section. These effects may have propagated to other threads, so all affected threads are returned to a globally consistent previous state. The return is undefined because control cannot resume after stabilize is called. </p> </li> <li class="gap"> <p> <tt>stableCP (f, comp)</tt> <br> returns a function <tt>f'</tt> and checkpoint tag <tt>cp</tt>. Function <tt>f'</tt> is identical to <tt>f</tt> but when applied will execute within a stable section. <tt>comp</tt> will be executed if <tt>f'</tt> is later stabilized. <tt>cp</tt> is used by <tt>stabilizeCP</tt> to stabilize a given checkpoint. </p> </li> <li class="gap"> <p> <tt>stabilizeCP cp</tt> <br> same as stabilize except that the (possibly current) checkpoint to stabilize is provided. </p> </li> <li class="gap"> <p> <tt>unmonitoredAssign (r, v)</tt> <br> standard assignment (<tt>:=</tt>). The version of CML distributed rebinds <tt>:=</tt> to a monitored version so interesting effects can be recorded. </p> </li> <li class="gap"> <p> <tt>monitoredAssign (r, v)</tt> <br> the assignment operator that should be used in programs that use stabilizers. <tt>:=</tt> is rebound to this by including CML. </p> </li> </ul> <h2 id="head-a479c9c34e878d07b4d67a73a48f432ad7dc53c8">Download</h2> <ul> <li> <p> <a href="http://mlton.org/pages/Stabilizers/attachments/stabilizers_alpha_2006-10-09.tar.gz"><img src="moin-www.png" alt="[WWW]" height="11" width="11">stabilizers_alpha_2006-10-09.tar.gz</a> </p> </li> </ul> <h2 id="head-a4bc8bf5caf54b18cea9f58e83dd4acb488deb17">Also see</h2> <ul> <li> <p> <a href = "References#ZiarekEtAl06">ZiarekEtAl06</a> </p> </li> </ul> </div> <p> <hr> Last edited on 2007-08-23 04:40:21 by <span title="c-71-57-91-146.hsd1.il.comcast.net"><a href="MatthewFluet">MatthewFluet</a></span>. </body></html>