pthread_condattr_setpshared Subrutina

Finalidad

Establece el valor del atributo pshared de un objeto de atributos de condición.

Biblioteca

Biblioteca de hebras (libpthreads.a)

Sintaxis

#include <pthread.h>

int pthread_condattr_setpshared (attr, pshared)
pthread_condattr_t *attr;
int pshared;

Descripción

La subrutina pthread_condattr_setpshared establece el valor del atributo pshared del objeto de atributos de condición attr. Este atributo especifica el proceso de compartición de la variable de condición creada con este objeto de atributos.

Nota: El archivo de cabecera pthread.h debe ser el primer archivo incluido de cada archivo de origen utilizando la biblioteca de hebras. De lo contrario, se debe utilizar el distintivo de compilación -D_THREAD_SAFE o el compilador cc_r utilizado. En este caso, el distintivo se establece automáticamente.

Parámetros

Elemento Descripción
attr Especifica el objeto de atributos de condición.
pshared Especifica la compartición de proceso que se va a establecer. Debe tener uno de los valores siguientes:
PTHREAD_PROCESS_SHARED
Especifica que la variable de condición puede ser utilizada por cualquier hebra que tenga acceso a la memoria donde está asignada, incluso si estas hebras pertenecen a procesos diferentes.
PTHREAD_PROCESS_PRIVATE
Especifica que la variable de condición sólo la utilizarán las hebras del mismo proceso que la hebra que la ha creado. Es el valor predeterminado.

Valores de retorno

Al finalizar correctamente, se devuelve 0. De lo contrario, se devuelve un código de error.

Códigos de error

La subrutina pthread_condattr_setpshared no es satisfactoria si se cumple lo siguiente:

Elemento Descripción
EINVAL Los parámetros attr o pshared no son válidos.