Soporte para Mapeo Perf
***********************

En las plataformas soportadas (en el momento de escribir esto, sólo
Linux), el tiempo de ejecución puede aprovechar *perf map files* para
hacer que las funciones de Python sean visibles para una herramienta
externa de perfiles (como perf). Un proceso en ejecución puede crear
un fichero en el directorio "/tmp", que contiene entradas que pueden
asignar una sección de código ejecutable a un nombre. Esta interfaz se
describe en la documentación de la herramienta Perf de Linux.

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.

Tenga en cuenta que para estas APIs no es necesario mantener el
Bloqueo Global del Intérprete (GIL).

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 mediante
   "PyUnstable_WritePerfMapEntry()"). Normalmente, no es necesario
   llamar a esto explícitamente; solo use
   "PyUnstable_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.
   Comprueba "errno" 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. Retorna "0" en
   caso de éxito, o los mismos códigos de error que
   "PyUnstable_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.
