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)