[pypy-svn] r46374 - pypy/dist/pypy/doc/config

[arigo at codespeak.net]

Author: arigo
Date: Thu Sep  6 18:04:07 2007
New Revision: 46374

Modified:
   pypy/dist/pypy/doc/config/translation.sandbox.txt
Log:
More docs about --sandbox.


Modified: pypy/dist/pypy/doc/config/translation.sandbox.txt
==============================================================================
--- pypy/dist/pypy/doc/config/translation.sandbox.txt	(original)
+++ pypy/dist/pypy/doc/config/translation.sandbox.txt	Thu Sep  6 18:04:07 2007
@@ -1,2 +1,15 @@
 Generate a special fully-sandboxed executable.
-Experimental.
+
+The fully-sandboxed executable cannot be run directly, but
+only as a subprocess of an outer "controlling" process.  The
+sandboxed process is "safe" in the sense that it doesn't do
+any library or system call - instead, whenever it would like
+to perform such an operation, it marshals the operation name
+and the arguments to its stdout and it waits for the
+marshalled result on its stdin.  This controller process must
+handle these operation requests, in any way it likes, allowing
+full virtualization.
+
+For examples of controller process see
+``pypy/translator/sandbox/interact.py`` and
+``pypy/translator/sandbox/pypy_interact.py``.