Ubuntu manuals

Provided by: manpages-es_1.55-10_all

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'ON

       La funcion 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 funcion 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  todavia  asociada con su sesion.  Ademas, pgrp debe ser un grupo
       de procesos (no vacio) perteneciente a la misma sesion que  el  proceso
       invocador.

       Si  tcsetpgrp()  es  llamada  por un miembro de un grupo de procesos en
       segundo plano en su sesion, y el proceso invocador no esta bloqueando o
       ignorando  SIGTTOU,  se envia una senal 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 funcion tcgetpgrp() devolvera el identificador del grupo
       de procesos en primer plano de esa terminal si hay uno, y  algun  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 exito, 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 valido.

       EINVAL pgrp tiene un valor no valido.

       EPERM  pgrp tiene un valor valido, pero no es el identificador de grupo
              de  procesos  de  un  proceso  en la misma sesion que el proceso
              invocador.

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

OBSERVACIONES

       Estas funciones fueron implementadas a traves 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'EASE TAMBI'EN

       setpgid(2), setsid(2)