grantpt − Accéder à un pseudo-terminal esclave.

#define _XOPEN_SOURCE

#include <stdlib.h>

int grantpt(int fd);

La fonction grantpt() modifie le mode et l’appartenant du pseudo-terminal esclave correspondant au pseudo-terminal maître référencé par fd. L’UID de l’esclave est rempli avec l’UID réel du processus appelant. Le GID est rempli avec une valeur non spécifiée (par ex : tty). Le mode de l’esclave est mis à 0620 (crw−−w−−−−).

Le comportement de grantpt() est indéterminé si un gestionnaire de signal est installé pour capturer SIGCHLD.

Lorsqu’elle réussit, la fonction grantpt() renvoie 0. Sinon, elle renvoie −1 et errno est positionnée en conséquence.

EACCES

Le pseudo-terminal esclave n’est pas accessible.

EBADF

L’argument fd n’est pas un descripteur valide.

EINVAL

L’argument fd est un descripteur mais pas associé avec un pseudo-terminal maître.

POSIX.1-2001.

Il s’agit d’une partie du support pty d’Unix98, voir pts(4). De nombreux systèmes implémentent cette fonction avec un assistant binaire Set−UID appelé « pt_chown ». Avec le mécanisme devpts de Linux, aucun assistant n’est nécessaire.

open(2), posix_openpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 21 juillet 2003 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 grantpt ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.