NOMBRE

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

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

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

       When fd  refers  to  the  controlling  terminal  of  the  calling  process,  the  function
       tcgetpgrp()  will return the foreground process group ID of that terminal if there is one,
       and some value larger than 1 that is not presently a process group ID otherwise.  When  fd
       does  not  refer  to  the controlling terminal of the calling process, -1 is returned, and
       errno is set to indicate the error.

       When successful, tcsetpgrp()  returns 0.  Otherwise, it returns -1, and errno  is  set  to
       indicate the error.

ERRORES

       EBADF  fd no es un descriptor de archivo 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 │
       └────────────────────────────────────────────────┴────────────────────┴───────────────────┘

ESTÁNDARES

       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)

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⟩.