https://github.com/python/cpython/commit/c3d21e5a11769ae318cb5c4c96a381a22629654e
commit: c3d21e5a11769ae318cb5c4c96a381a22629654e
branch: 3.15
author: Miss Islington (bot) <[email protected]>
committer: pablogsal <[email protected]>
date: 2026-05-24T12:02:45Z
summary:

[3.15] gh-148932: Docs / `profiling.sampling` Windows limitations (GH-150272) 
(#150330)

gh-148932: Docs / `profiling.sampling` Windows limitations (GH-150272)
(cherry picked from commit 0f32750fe26428de5e439803cf57f51847c81ce8)

Co-authored-by: Eduardo Villalpando Mello <[email protected]>

files:
M Doc/library/profiling.sampling.rst

diff --git a/Doc/library/profiling.sampling.rst 
b/Doc/library/profiling.sampling.rst
index aeb1a429b58515..39b6ea4e31cde7 100644
--- a/Doc/library/profiling.sampling.rst
+++ b/Doc/library/profiling.sampling.rst
@@ -387,6 +387,11 @@ This requires one of:
 On Windows, the profiler requires administrative privileges or the
 ``SeDebugPrivilege`` privilege to read another process's memory.
 
+*Note*: On Windows, ``python -m profiling.sampling`` fails inside a virtual
+environment because the venv's ``python.exe`` is just a launcher shim that
+re-executes the base interpreter as a child process. The shim itself isn't
+a Python process and has no ``PyRuntime`` section to attach to. Instead,
+run it from the global Python installation.
 
 Version compatibility
 ---------------------

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to