From: Eduardo Villalpando Mello Date: Sun, 24 May 2026 11:54:36 +0000 (-0700) Subject: gh-148932: Docs / `profiling.sampling` Windows limitations (#150272) X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=0f32750fe26428de5e439803cf57f51847c81ce8;p=thirdparty%2FPython%2Fcpython.git gh-148932: Docs / `profiling.sampling` Windows limitations (#150272) --- diff --git a/Doc/library/profiling.sampling.rst b/Doc/library/profiling.sampling.rst index aeb1a429b585..39b6ea4e31cd 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 ---------------------