Claves IPC nativas
Las clases ` QSharedMemory ` y ` QSystemSemaphore ` identifican sus recursos mediante un identificador válido para todo el sistema conocido como «clave». Tanto el valor de bajo nivel de la clave como su tipo se encapsulan en Qt mediante la clase ` QNativeIpcKey `. Dicha clase también proporciona los medios adecuados para intercambiar la clave con otros procesos, a través de ` QNativeIpcKey::toString()` y ` QNativeIpcKey::fromString()`.
Actualmente, Qt admite tres backends distintos para esas dos clases, que se corresponden con los valores disponibles en la enumeración ` QNativeIpcKey::Type `.
- Extensiones POSIX en tiempo real (IEEE 1003.1b, POSIX.1b)
- Interfaces de sistema X/Open (XSI) o System V (SVr4), aunque ahora también forman parte de POSIX
- Primitivas de Windows
Como su nombre indica, las primitivas de Windows solo están disponibles en el sistema operativo Windows, donde constituyen el backend predeterminado. Las otras dos suelen estar disponibles en los sistemas operativos Unix. La siguiente tabla ofrece una visión general de la disponibilidad habitual desde Qt 6.6:
| Sistema operativo | POSIX | System V | Windows |
|---|---|---|---|
| Android | |||
| INTEGRITY | |||
| QNX | Sí | ||
| macOS | Sí | Normalmente (1) | |
| Otros sistemas operativos de Apple | Sí | ||
| Otros sistemas Unix | Sí | Sí | |
| Windows | Rara vez (2) | Sí |
Nota: 1 Las aplicaciones de macOS en entorno aislado, entre las que se incluyen todas las distribuidas a través de la App Store de Apple, no pueden utilizar objetos System V.
Nota: 2 Algunos entornos de ejecución de C compatibles con GCC en Windows ofrecen soporte para memoria compartida compatible con POSIX, pero esto es poco habitual. Siempre está ausente con el compilador de Microsoft.
Para determinar si se admite un tipo de clave determinado, las aplicaciones deben llamar a QSharedMemory::isKeyTypeSupported() y a QSystemSemaphore::isKeyTypeSupported().
QNativeIpcKey También ofrece compatibilidad con aplicaciones Qt anteriores a su introducción. Las secciones siguientes detallan las limitaciones de los backends, el contenido de las propias claves de cadena y la compatibilidad.
Formato de clave seguro multiplataforma
QNativeIpcKey::setNativeKey() y QNativeIpcKey::nativeKey() gestionan la clave nativa de bajo nivel, que puede utilizarse con las API nativas y compartirse con otros procesos ajenos a Qt (véase más abajo la API). Este formato no suele ser multiplataforma, por lo que tanto QSharedMemory como QSystemSemaphore proporcionan una función para traducir una cadena identificadora multiplataforma a la clave nativa: QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey().
La longitud de la clave multiplataforma en la mayoría de las plataformas es la misma que la de un nombre de archivo, pero en las plataformas de Apple está muy limitada a solo 30 bytes utilizables (ten en cuenta la codificación UTF-8 si utilizas caracteres fuera del rango US-ASCII). El formato de la clave también es similar al de un componente de ruta de archivo, lo que significa que no debe contener ningún carácter no permitido en los nombres de archivo, en particular aquellos que separan los componentes de la ruta (barra y barra invertida), con la excepción de las aplicaciones en entorno aislado (sandbox) en los sistemas operativos de Apple. A continuación se muestran algunos buenos ejemplos de claves multiplataforma: «myapp», «org.example.myapp», «org.example.myapp-12345». Ten en cuenta que es responsabilidad del llamante evitar claves demasiado largas y asegurarse de que la clave contenga caracteres válidos en la plataforma correspondiente. Qt truncará de forma silenciosa las claves que sean demasiado largas.
Limitaciones del entorno de pruebas de Apple: si la aplicación se ejecuta dentro de un entorno de pruebas en un sistema operativo de Apple, la clave debe tener un formato muy específico: <application group identifier>/<custom identifier>. El entorno de pruebas es obligatorio para todas las aplicaciones distribuidas a través de la App Store de Apple. Consulte la documentación de Apple aquí y aquí para obtener más información, incluido cómo obtener el identificador de grupo de la aplicación.
Formato de clave nativo
En esta sección se detalla el formato de las claves nativas de los backends compatibles.
POSIX en tiempo real
Las claves nativas se asemejan a los nombres de archivo y pueden contener cualquier carácter que admitan los nombres de archivo, excepto la barra inclinada. POSIX exige que el primer carácter del nombre de la clave sea una barra inclinada y no especifica si se permiten barras inclinadas adicionales. En la mayoría de los sistemas operativos, la longitud de la clave es la misma que la de un nombre de archivo, pero en los sistemas operativos de Apple está limitada a 32 caracteres (esto incluye la primera barra y el carácter nulo final, por lo que solo son posibles 30 caracteres utilizables).
A continuación se muestran algunos buenos ejemplos de claves POSIX nativas: «/myapp», «/org.example.myapp», «/org.example.myapp-12345».
Las funciones QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey() simplemente añaden la barra al principio. En los sistemas operativos de Apple, además, truncan el resultado al tamaño disponible.
Windows
Los tipos de clave de Windows son nombres de objetos del núcleo NT y pueden tener una longitud de hasta MAX_PATH (260) caracteres. Tienen el aspecto de rutas relativas (es decir, no comienzan con una barra invertida ni con una letra de unidad), pero, a diferencia de los nombres de archivo en Windows, distinguen entre mayúsculas y minúsculas.
Los siguientes son buenos ejemplos de claves nativas de Windows: «myapp», «org.example.myapp», «org.example.myapp-12345».
Las funciones QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey() insertan un prefijo para eliminar la ambigüedad entre la memoria compartida y los semáforos del sistema, respectivamente.
Interfaces del sistema X/Open (XSI) / System V
Las claves de System V adoptan la forma del nombre de un archivo en el sistema y, por lo tanto, tienen exactamente las mismas limitaciones que las rutas de archivo. Tanto QSharedMemory como QSystemSemaphore crearán este archivo si no existe al crear el objeto. Si la eliminación automática está desactivada, también puede compartirse entre QSharedMemory y QSystemSemaphore sin conflicto y puede ser cualquier archivo existente (por ejemplo, puede ser el propio ejecutable del proceso; véase QCoreApplication::applicationFilePath()). La ruta debe ser absoluta para evitar errores debidos a los diferentes directorios actuales.
QSharedMemory::platformSafeKey() y QSystemSemaphore::platformSafeKey() siempre devuelven una ruta absoluta. Si la entrada ya era absoluta, devolverán la entrada sin cambios. De lo contrario, antepondrán una ruta adecuada en la que la aplicación suele tener permiso para crear archivos.
Propiedad
Los objetos de memoria compartida y de semáforo del sistema deben crearse antes de su uso, lo cual se lleva a cabo con ` QSharedMemory::create()` o pasando ` QSystemSemaphore::Create ` al constructor, respectivamente.
En sistemas Unix, las clases de Qt que crearon el objeto se encargarán de liberarlo. Por lo tanto, si la aplicación que utiliza ese objeto C++ se cierra de forma anómala (un fallo, qFatal(), etc.), el objeto puede quedar abandonado. Si eso ocurre, es posible que las aplicaciones no puedan volver a crear el objeto y, en su lugar, deberían asociarse a uno ya existente. Por ejemplo, para QSharedMemory:
if (!shm.create(4096) && shm.error() == QSharedMemory::AlreadyExists)
shm.attach();Volver a vincularse a un ` QSystemSemaphore ` probablemente no sea aconsejable, ya que el contador de tokens que contiene probablemente se encuentre en un estado desconocido y, por lo tanto, pueda provocar interbloqueos.
POSIX en tiempo real
La propiedad de los objetos POSIX Realtime sigue el modelo de los archivos, en el sentido de que existen independientemente de si algún proceso los utiliza o no. Qt no puede determinar si el objeto sigue en uso, por lo que la eliminación automática lo eliminará incluso en ese caso, lo que hará imposible vincularse al mismo objeto, pero no afectará a las vinculaciones existentes.
Antes de Qt 6.6, Qt nunca limpiaba los objetos POSIX Realtime, excepto en QNX.
Interfaces del sistema X/Open (XSI) / System V
Hay dos recursos gestionados por las clases de Qt: el archivo al que hace referencia la clave y el propio objeto. ` QSharedMemory ` gestiona el objeto de forma cooperativa: la última conexión se encarga de eliminar el propio objeto y, a continuación, de eliminar el archivo de clave. ` QSystemSemaphore ` eliminará el objeto si y solo si se le ha pasado ` QSystemSemaphore::Create`; además, si creó el archivo de clave, también lo eliminará.
Desde Qt 6.6, es posible indicar a cualquiera de las dos clases que no realice la limpieza.
Windows
El sistema operativo es el propietario del objeto y se encargará de su limpieza una vez que se haya cerrado el último identificador del objeto.
Interoperabilidad con aplicaciones antiguas de Qt
La clase ` QNativeIpcKey ` se introdujo en Qt 6.6. Antes de esta versión, los backends ` QSharedMemory ` y ` QSystemSemaphore ` se determinaban en el momento de la propia compilación de Qt. En los sistemas Windows, siempre se utilizaba el backend de Windows. En los sistemas Unix, se utilizaba por defecto el backend de System V si el script de configuración determinaba que estaba disponible. Si no lo estaba, se recurría al de POSIX. El backend de POSIX podía seleccionarse explícitamente mediante la opción « -feature-ipc_posix » del script de configuración de Qt; si se habilitaba, se definía la macro « QT_POSIX_IPC ».
Qt 6.6 conserva la opción del script de configuración, pero ya no controla la disponibilidad de los backends. En su lugar, cambia el valor que devuelve QNativeIpcKey::legacyDefaultTypeForOs(). Las aplicaciones que necesiten mantener la compatibilidad deben utilizar exclusivamente este tipo de clave para garantizar la interoperabilidad.
La API tanto de QSharedMemory como de QSystemSemaphore incorporaba el concepto de clave multiplataforma, que ahora ha quedado obsoleto en favor del uso de QSharedMemory::legacyNativeKey() y QSystemSemaphore::legacyNativeKey(). Estas dos funciones generan la misma clave nativa que las funciones obsoletas de versiones anteriores. Si el código antiguo era, por ejemplo:
QSharedMemory shm("org.example.myapplication");
QSystemSemaphore sem("org.example.myapplication");Se puede actualizar para que quede así:
QSharedMemory shm(QSharedMemory::legacyNativeKey("org.example.myapplication"));
QSystemSemaphore sem(QSystemSemaphore::legacyNativeKey("org.example.myapplication"));Si las dos aplicaciones intercambiaban claves nativas, no es necesario actualizar código como este:
QSharedMemory shm;
shm.setNativeKey(key);No obstante, si la aplicación más antigua aceptaba una clave nativa, la nueva puede optar por utilizar ` platformSafeKey() ` con un segundo argumento de ` QNativeIpcKey::legacyDefaultTypeForOs()`.
Interfaces del sistema X/Open (XSI) / System V
Nunca utilices archivos existentes para las claves de ` QSharedMemory `, ya que la antigua aplicación Qt podría intentar eliminarlos. En su lugar, deja que ` QSharedMemory ` las cree.
Interoperabilidad con aplicaciones que no son de Qt
La interoperabilidad con aplicaciones ajenas a Qt es posible, con algunas limitaciones:
- La creación de segmentos de memoria compartida no debe producirse simultáneamente
- QSharedMemory no hay soporte para bloquear el segmento
La comunicación con aplicaciones que no son de Qt debe realizarse siempre a través de la clave nativa.
QSharedMemory Siempre se asigna todo el segmento a la memoria. La aplicación que no sea de Qt puede optar por asignar solo un subconjunto del mismo a la memoria, sin que ello tenga efectos negativos.
Tiempo real POSIX
La memoria compartida POSIX se puede abrir mediante shm_open() y los semáforos del sistema POSIX se pueden abrir mediante sem_open().
Ambas funciones admiten un parámetro « name » que es el resultado de ` QNativeIpcKey::nativeKey()`, codificado para nombres de archivo mediante ` QFile::encodeName()` / ` QFile::decodeName()`.
Windows
Los objetos de memoria compartida de Windows se pueden abrir mediante CreateFileMappingW y los objetos de semáforo del sistema de Windows se pueden abrir mediante CreateSemaphoreW. A pesar de que el nombre de ambas funciones comienza por «Create», permiten asociarse a objetos ya existentes.
El parámetro « lpName » de dichas funciones es el resultado de « QNativeIpcKey::nativeKey()», sin transformación.
Si la aplicación externa utiliza la versión no Unicode de dichas funciones (que terminan en «A»), el nombre se puede convertir a y desde 8 bits mediante QString.
Interfaces del sistema X/Open (XSI) / System V
La memoria compartida de System V se puede obtener mediante shmget() y los semáforos del sistema de System V se pueden obtener mediante semget().
El parámetro key de cualquiera de estas funciones es el resultado de la función ftok() cuando se le pasa el nombre de archivo obtenido mediante QNativeIpcKey::nativeKey() con un id de 81 o 0x51 (la letra mayúscula «Q» en ASCII).
Los objetos de semáforo de System V pueden contener varios semáforos, pero QSystemSemaphore solo utiliza el primero (número 0 para sem_num).
Tanto QSharedMemory como QSystemSemaphore eliminan por defecto el objeto mediante la operación IPC_RMID con los valores shmctl() y semctl(), respectivamente, si son el último enlace.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.