Soporte para Mapeo Perf¶
On supported platforms (Linux and macOS), the runtime can take
advantage of perf map files to make Python functions visible to an external
profiling tool (such as perf or
samply). A running process may create a
file in the /tmp
directory, which contains entries that can map a section
of executable code to a name. This interface is described in the
documentation of the Linux Perf tool.
En Python, estas API auxiliares pueden ser utilizadas por bibliotecas y funciones que dependen de la generación de código de máquina sobre la marcha.
Note that holding an attached thread state is not required for these APIs.
-
int PyUnstable_PerfMapState_Init(void)¶
- This is Unstable API. It may change without warning in minor releases.
Abre el archivo
/tmp/perf-$pid.map
, a menos que ya esté abierto, y crea un bloqueo para garantizar escrituras seguras para hilos en el archivo (siempre que las escrituras se realicen mediantePyUnstable_WritePerfMapEntry()
). Normalmente, no es necesario llamar a esto explícitamente; solo usePyUnstable_WritePerfMapEntry()
e inicializará el estado en la primera llamada.Retorna
0
en caso de éxito,-1
en caso de fallo al crear/abrir el fichero perf map, o-2
en caso de fallo al crear un bloqueo. Compruebaerrno
para más información sobre la causa de un fallo.
-
int PyUnstable_WritePerfMapEntry(const void *code_addr, unsigned int code_size, const char *entry_name)¶
- This is Unstable API. It may change without warning in minor releases.
Escribe una única entrada en el fichero
/tmp/perf-$pid.map
. Esta función es segura para hilos. Aquí hay un ejemplo de entrada:# address size name 7f3529fcf759 b py::bar:/run/t.py
Llamará a
PyUnstable_PerfMapState_Init()
antes de escribir la entrada, si el fichero perf map no está ya abierto. Retorna0
en caso de éxito, o los mismos códigos de error quePyUnstable_PerfMapState_Init()
en caso de fallo.
-
void PyUnstable_PerfMapState_Fini(void)¶
- This is Unstable API. It may change without warning in minor releases.
Cierra el fichero perf map abierto por
PyUnstable_PerfMapState_Init()
. Esto es llamado por el propio tiempo de ejecución durante el cierre del intérprete. En general, no debería haber una razón para llamar explícitamente a esto, excepto para manejar escenarios específicos como la bifurcación.