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

#include <stdlib.h>

int grantpt(int fd);

La fonction grantpt() modifie le mode et l'appartenant du pseudo-terminal esclace 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 configure errno avec le code d'erreur.

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.

EACCES

Le pseudo-terminal esclave n'est pas accessible.

POSIX 1003.1-2001

Il s'agit d'une partie du support pty d'Unix98, voir pts(4). De nombreux systèmes implémente 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), getpt(3), ptsname(3), unlockpt(3), pts(4)

Christophe Blaess, 2003.