SEMCTL(2)

NOMBRE
semctl - operaciones de control de semáforos

SINOPSIS
# include <sys/types.h>
# include <sys/ipc.h>
# include <sys/sem.h>

int semctl ( int semid, int semnun, int cmd, union semun arg )

DESCRIPCION
La función realiza la operación de control especificada por cmd en el conjunto de semáforos (o en el semáforo sumun-avo del grupo) identificado por semid. El primer semáforo del conjunto está indicado por el valor 0 para semun.

El tipo de arg es la unión

union semun {
        int val; /* usado para SETVAL solo*/
        struct semid_ds *buf; /* para IPC_STAT e IPC_SET */
        ushort *array; /* usado para GETALL y SETALL */
};

Valores válidos para cmd son

IPC_STAT
    Copiar información de la estructura de datos del conjunto de semáforos en la estructura apuntada por arg.buf. El argumento semnum es ignorado. El proceso que realiza la llamada debe tener privilegios de acceso de lectura en el conjunto de semáforos.

IPC_SET
    Escribir los valores de algunos miembros de la estructura semid_ds apuntada por arg.buf a la estructura de datos del conjunto de semáforos, actualizando tambien su miembro sem_ctime Los miembros de la estructura provista por el usuario struct semid_ds a los que apunta arg.buf son

            sem_perm.uid
            sem_perm.gid
            sem_perm.mode   /* solo los 9 bits más bajos */

    El ID de usuario efectivo del proceso que realiza la llamada debe ser o de super-usuario, o el del creador o propietario del conjunto de semáforos. El argumento semnum es ignorado.

IPC_RMID
    Borrar inmediatamente el conjunto de semáforos y sus estructuras de datos, despertando todos los procesos en espera (devuelve un error, y errno puesto a EIDRM). El ID de usuario efectivo del proceso que realiza la llamada debe ser o de super-usuario, o el del creador o propietario del conjunto de semáforos. El argumento semnum es ignorado.

GETALL
    Devuelve semval para todos los semáforos del conjunto, en arg.array. El argumento semnum es ignorado. El proceso que realiza la llamada ha de tener privilegios de lectura en el conjunto de semáforos.

GETNCNT
    La llamada al sistema devuelve el valor de semncnt para el semno-avo semáforo del conjunto (p.ej. el número de procesos esperando que aumente semval para el semno-avo semáforo del conjunto). El proceso que realiza la llamada ha de tener privilegios de lectura en el conjunto de semáforos.

GETPID
    La llamada al sistema devuelve el valor de sempid para el semno-avo semáforo del conjunto (p.ej. el pid del proceso que ejecutó la última llamada semop para el semno-avo semáforo del conjunto). El proceso que realiza la llamada ha de tener privilegios de lectura en el conjunto de semáforos.

GETVAL
    La llamada al sistema devuelve el valor de semval para el semno-avo semáforo del conjunto. El proceso que realiza la llamada ha de tener privilegios de lectura en el conjunto de semáforos.

GETZCNT
    La llamada al sistema devuelve el valor de semzcnt para el semno-avo semáforo del conjunto (p.ej. el número de procesos que esperan que semval del semno-avo semáforo del conjunto se ponga a 0). El proceso que realiza la llamada ha de tener privilegios de lectura en el conjunto de semáforos.

SETALL
    Poner semval para todos los semáforos del conjunto usando arg.array, acutalizando también el miembro sem_ctime de la estructura semid_ds asociada al conjunto. Los registros de anulación son limpiados, para los semáforos cambiados, en todos los procesos. Los procesos que están durmiendo en la cola de espera son despertados si algún semval se pone a 0 o se incrementa. El argumento semnum es ignorado. El proceso que realiza la llamada ha de tener privilegios de modificación en el conjunto de semáforos.

SETVAL
    Poner el valor de semval a arg.val para el semnum-avo semáforo del conjunto, actualizando también el miembro sem_ctime de la estructura semid_ds asociada al conjunto. El registro de anulación es limpiado, para el semáforo alterado, en todos los procesos. Los procesos que están durmiendo en la cola de espera son despertados si semval se pone a 0 o se incrementa. El proceso que realiza la llamada ha de tener privilegios de escritura en el conjunto de semáforos.

VALOR REGRESADO
Si falla, la llamada del sistema devuelve -1 , mientras errno indica el error. De otro modo, la llamada al sistema devuelve un valor no negativo, dependiendo de cmd como sigue:

GETNCNT
    el valor de semncnt.

GETPID
    el valor de sempid.

GETVAL
    el valor de semval.

GETZCNT
    el valor de semzcnt.

ERRORES
Para un retorno fallido, errno tendrá uno de los siguientes valores:

EACCESS
    El proceso que reliza la llamada no tiene los permisos necesarios para ejecutar cmd.

EFAULT
    La dirección a la que apunta arg.buf o arg.array no es accesible.

EIDRM
    El conjunto de semáforos se borró.

EINVAL
    Valor no válido para cmd o semid.

EPERM
    El argumento cmd tiene valor IPC_SET o IPC_RMID pero el user-ID del proceso que realiza la llamada no tiene suficientes privilegios para ejecutar el comando.

ERANGE
    El argumento cmd tiene el valor SETALL o SETVAL y el valor al que ha de ser puesto semval (para algún semáforo del conjunto) es menor que 0 o mayor que el valor SEMVMX de la implementación.

NOTAS
Las llamadas de control IPC_INFO, SEM_STAT y SEM_INFO son utilizadas por el programa ipcs(8) para proveer información sobre recursos asignados. En el futuro pueden ser modificadas según se necesite, o llevadas al interfaz del sistema de ficheros proc.

El siguiente límite de sistema para conjuntos de semáforos afecta a la llamada semctl :

SEMVMX
    Valor máximo para semval: depende de la implementación (32767).

CONFORMA CON
SVr4, SVID. SVr4 documenta más condiciones de error EINVAL y EOVERFLOW.

VEASE
ipc(5), shmget(2), shmat(2), shmdt(2).