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.

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 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.
