Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-06-28 03:41:13 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.14] Add prominent crash warning to ctypes docs (GH-150410) (GH-150548)

Browse source 
(cherry picked from commit b53f6ca850)

Co-authored-by: Stan Ulbrych <stan@python.org>
Co-authored-by: Petr Viktorin <encukou@gmail.com>
This commit is contained in:
Miss Islington (bot) 2026-05-28 12:24:04 +02:00 • committed by GitHub
parent eb9c97b1a1
commit e4a23c8ff6
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 10 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/library/ctypes.rst
View file

@ -16,6 +16,14 @@ used to wrap these libraries in pure Python.
.. include:: ../includes/optional-module.rst
.. warning::
:mod:`!ctypes` provides low-level access to native libraries and the
process's memory, bypassing Python's safety mechanisms and allowing
execution of arbitrary native code.
Incorrect use can corrupt data and objects, reveal sensitive information,
cause crashes, or otherwise compromise the running process.
.. _ctypes-ctypes-tutorial:
@ -200,10 +208,8 @@ argument values::
OSError: exception: access violation reading 0x00000020
>>>
There are, however, enough ways to crash Python with :mod:`!ctypes`, so you
should be careful anyway. The :mod:`faulthandler` module can be helpful in
debugging crashes (e.g. from segmentation faults produced by erroneous C library
calls).
The :mod:`faulthandler` module can help debug crashes,
such as segmentation faults produced by erroneous C library calls.
``None``, integers, bytes objects and (unicode) strings are the only native
Python objects that can directly be used as parameters in these function calls.