doc/guide/localhost/RunningOnCygwin

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <meta name="generator" content="AsciiDoc 8.6.9">
   6 <title>RunningOnCygwin</title>
   7 <link rel="stylesheet" href="./asciidoc.css" type="text/css">
   8 <link rel="stylesheet" href="./pygments.css" type="text/css">
   9
  10
  11 <script type="text/javascript" src="./asciidoc.js"></script>
  12 <script type="text/javascript">
  13 /*<![CDATA[*/
  14 asciidoc.install();
  15 /*]]>*/
  16 </script>
  17 <link rel="stylesheet" href="./mlton.css" type="text/css">
  18 </head>
  19 <body class="article">
  20 <div id="banner">
  21 <div id="banner-home">
  22 <a href="./Home">MLton 20180207</a>
  23 </div>
  24 </div>
  25 <div id="header">
  26 <h1>RunningOnCygwin</h1>
  27 </div>
  28 <div id="content">
  29 <div id="preamble">
  30 <div class="sectionbody">
  31 <div class="paragraph"><p>MLton runs on the <a href="http://www.cygwin.com/">Cygwin</a> emulation layer,
  32 which provides a Posix-like environment while running on Windows.  To
  33 run MLton with Cygwin, you must first install Cygwin on your Windows
  34 machine.  To do this, visit the Cygwin site from your Windows machine
  35 and run their <span class="monospaced">setup.exe</span> script.  Then, you can unpack the MLton
  36 binary <span class="monospaced">tgz</span> in your Cygwin environment.</p></div>
  37 <div class="paragraph"><p>To run MLton cross-compiled executables on Windows, you must install
  38 the Cygwin <span class="monospaced">dll</span> on the Windows machine.</p></div>
  39 </div>
  40 </div>
  41 <div class="sect1">
  42 <h2 id="_known_issues">Known issues</h2>
  43 <div class="sectionbody">
  44 <div class="ulist"><ul>
  45 <li>
  46 <p>
  47 Time profiling is disabled.
  48 </p>
  49 </li>
  50 <li>
  51 <p>
  52 Cygwin&#8217;s <span class="monospaced">mmap</span> emulation is less than perfect.  Sometimes it
  53 interacts badly with <span class="monospaced">Posix.Process.fork</span>.
  54 </p>
  55 </li>
  56 <li>
  57 <p>
  58 The <a href="https://raw.github.com/MLton/mlton/master/regression/socket.sml"><span class="monospaced">socket.sml</span></a> regression
  59 test fails.  We suspect this is not a bug and is simply due to our
  60 test relying on a certain behavior when connecting to a socket that
  61 has not yet accepted, which is handled differently on Cygwin than
  62 other platforms.  Any help in understanding and resolving this issue
  63 is appreciated.
  64 </p>
  65 </li>
  66 </ul></div>
  67 </div>
  68 </div>
  69 <div class="sect1">
  70 <h2 id="_also_see">Also see</h2>
  71 <div class="sectionbody">
  72 <div class="ulist"><ul>
  73 <li>
  74 <p>
  75 <a href="RunningOnMinGW">RunningOnMinGW</a>
  76 </p>
  77 </li>
  78 </ul></div>
  79 </div>
  80 </div>
  81 </div>
  82 <div id="footnotes"><hr></div>
  83 <div id="footer">
  84 <div id="footer-text">
  85 </div>
  86 <div id="footer-badges">
  87 </div>
  88 </div>
  89 </body>
  90 </html>