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

CONFORME A

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

NOTAS

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

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