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.

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