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.

       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.

       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.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

       ┌─────────────────────────┬────────────────────┬───────────────────┐
       │Interfaz                 │ Atributo           │ Valor             │
       ├─────────────────────────┼────────────────────┼───────────────────┤
       │tcgetpgrp(), tcsetpgrp() │ Seguridad del hilo │ Multi-hilo seguro │
       └─────────────────────────┴────────────────────┴───────────────────┘

CONFORME A

       POSIX.1-2001, POSIX.1-2008.

NOTAS

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

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

VÉASE TAMBIÉN

       setpgid(2), setsid(2), credentials(7)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar  una
       descripción  del  proyecto, información sobre cómo informar errores y la última versión de
       esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del manual  fue  creada  por  Miguel  Pérez  Ibars
       <mpi79470@alu.um.es>

       Esta  traducción  es  documentación  libre;  lea  la  GNU General Public License Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con respecto a las condiciones  de
       copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción de esta página del manual, envíe un correo
       electrónico a debian-l10n-spanish@lists.debian.org ⟨⟩.