tcgetpgrp(3)

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.