- Latest (GraalVM for JDK 21)
- Dev Build
- GraalVM for JDK 21
- GraalVM for JDK 20
- GraalVM for JDK 17
- GraalVM 22.3
- GraalVM 22.2
- GraalVM 22.1
- GraalVM 22.0
- GraalVM 21.3
- Java Reference
- Java on Truffle
- LLVM Languages Reference
- Python Reference
- Installing Supported Packages
- Operating System Interfaces
- Python Code Parsing and pyc Files
- Jython Compatibility
- Tooling Support for Python
- Ruby Reference
- R Reference
- WebAssembly Reference
Operating System Interfaces
Truffle-based GraalVM languages usually implement the system related functions using the Truffle abstraction layer, which is OS independent and provides extension points for the users when embedding GraalVM Python or other Truffle based languages into Java applications. See, for example, Truffle FileSystem service-provider.
The Python standard library also provides OS abstraction, but exposes lower level interfaces, for instance, the OS module directly exposes some POSIX functions. On non-POSIX platforms, this interface is emulated to a degree.
GraalVM Python runtime provides two alternative implementations of the system related functionality offered by the builtin Python modules such as
Which implementation is used can be controlled by the option
PosixModuleBackend: valid values are
Native backend #
native backend calls directly the POSIX API in mostly the same way as CPython, the reference Python implementation, does.
This approach is the most compatible with CPython and provides bare access to the underlying OS interface without any emulation layer in between.
By default, this implementation bypasses the Truffle abstraction layer, therefore it is not sandboxed and does not support custom implementations of Truffle FileSystem service-provider and other Polyglot API providers related to system interfaces.
The native backend is chosen by default when GraalVM Python is started via the
graalpy or any other Python related launcher inside GraalVM.
The exception are Python related launchers with
-managed suffix available only in GraalVM Enterprise (e.g.,
graalpy-managed), which by default use the
java POSIX backend.
Limitations of the native backend #
os.forkis not supported
_posixsubprocess.fork_execdoes not support the
Java backend #
java backend uses the Truffle abstraction layer and therefore supports custom Polyglot API providers related to system interfaces and sandboxing.
Since this abstraction is POSIX agnostic, it does not expose all the necessary functionality. Some functionality is emulated, and some functionality is not supported at all.
The java backend is the default when GraalVM Python is run via the
Context API, i.e., embedded in Java applications, or when it is launched using Python related launchers with
-managed suffix available only in GraalVM Enterprise.
Limitations of the emulated backend #
GraalVM Python can log info about known incompatibility of functions executed at runtime, which includes the OS interface related functions.
To turn on this logging, use
--log.python.compatibility.level=FINE or other desired logging level.
Known limitations of the emulated layer are:
- Its state is disconnected from the actual OS state, which applies especially to:
- file descriptors: Python level file descriptors are not usable in native code
- current working directory: gets initialized to what was the actual current working
directory at the startup, but then it is maintained separately, i.e.,
chdirin Python does not change the actual current working directory of the process.
- umask: similarly to current working directory, but it is always initialized
0022regardless of the actual system value at startup.
- Resolution of file access/modification times depends on the JDK. The best the emulated backend can guarantee is seconds resolution.
os.accessand any other functionality based on
faccessatPOSIX function does not support:
- effective IDs
follow_symlinks=Falseunless the mode is only
Relation to Python native extensions #
Apart from operating system interfaces exposed as builtin Python level modules, Python native extensions executed via the GraalVM LLVM runtime may also access OS interfaces at the C level. How such accesses are handled depends on the GraalVM LLVM runtime configuration.
At this point, the only combination where OS handles, such as file descriptors, can be shared between Python and the C code of Python extensions is with
native PosixModuleBackend and
native mode of GraalVM LLVM runtime.
This combination is the default for the