Skip to content

Commit 0f7151c

Browse files
committed
A little more warning about multi-context C extensions
1 parent 937fcd9 commit 0f7151c

File tree

1 file changed

+1
-0
lines changed

1 file changed

+1
-0
lines changed

docs/user/Native-Extensions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,5 +50,6 @@ The implementation also relies on `venv` to work, even if you are not using exte
5050
To support creating multiple GraalPy contexts that access native modules within the same JVM or Native Image, we need to isolate them from each other.
5151
The current strategy for this is to copy the libraries and modify them such that the dynamic library loader of the operating system will isolate them for us.
5252
To do this, all GraalPy contexts in the same process (not just those in the same engine!) must set the `python.IsolateNativeModules` option to `true`.
53+
You should test your applications thoroughly if you want to use this feature, as there are many possiblities for native code to sidestep the library isolation through other process-wide global state.
5354

5455
For more details on this, see [our implementation details](https://github.com/oracle/graalpython/blob/master/docs/contributor/IMPLEMENTATION_DETAILS.md#c-extension-copying).

0 commit comments

Comments
 (0)