TCGETPGRP(3)

NOMBRE
tcgetpgrp, tcsetpgrp - obtienen y establecen el grupo de procesos en primer plano de la terminal

SINOPSIS

#include <unistd.h>

pid_t tcgetpgrp(int fd);

int tcsetpgrp(int fd, pid_t pgrp);

DESCRIPCIÓN
La función tcgetpgrp() devuelve el identificador de grupo de procesos del grupo de procesos en primer plano en la terminal asociada a fd, que debe ser la terminal de control del proceso invocador.

La función tcsetpgrp() convierte el grupo de procesos con identificador pgrp en el grupo de procesos en primer plano en la terminal asociada a fd, que debe ser la terminal de control del proceso invocador, y debe estar todavía asociada con su sesión. Además, pgrp debe ser un grupo de procesos (no vacío) perteneciente a la misma sesión que el proceso invocador.

Si tcsetpgrp() es llamada por un miembro de un grupo de procesos en segundo plano en su sesión, y el proceso invocador no está bloqueando o ignorando SIGTTOU, se envía una señal SIGTTOU a todos los miembros de este grupo de procesos en segundo plano.

VALOR DEVUELTO
Cuando fd hace referencia a la terminal de control del proceso invocador, la función tcgetpgrp() devolverá el identificador del grupo de procesos en primer plano de esa terminal si hay uno, y algún valor mayor que 1 en caso contrario. Cuando fd no hace referencia a la terminal de control del proceso invocador, se devuelve -1 y se modifica errno con el valor apropiado.

Cuando tiene éxito, tcsetpgrp() devuelve 0. En otro caso, devuelve -1, y se modifica errno con el valor apropiado.

ERRORES

EBADF
    fd no es un descriptor de fichero válido.

EINVAL
    pgrp tiene un valor no válido.

EPERM
    pgrp tiene un valor válido, pero no es el identificador de grupo de procesos de un proceso en la misma sesión que el proceso invocador.

ENOTTY
    El proceso invocador no tiene una terminal de control, o tiene una pero no está descrita por fd, o, para tcsetpgrp(), esta terminal de control ha dejado de estar asociada con la sesión del proceso invocador.

OBSERVACIONES
Estas funciones fueron implementadas a través de los ioctls TIOCGPGRP y TIOCSPGRP.

HISTORIA
Estos ioctls aparecieron en 4.2 BSD. Las funciones son invenciones de POSIX.

CONFORME A
POSIX.1

VÉASE TAMBIÉN
setpgid(2), setsid(2)