grantpt

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NOM

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

SYNOPSIS


#include <stdlib.h>



int grantpt(int fd);

DESCRIPTION

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.

VALEUR RENVOYÉE

Lorsqu'elle réussit, la fonction grantpt() renvoie 0. Sinon, elle renvoie -1 et configure errno avec le code d'erreur.

ERREURS.

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.

CONFORMITÉ

POSIX 1003.1-2001

NOTES

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.

VOIR AUSSI

open(2), getpt(3), ptsname(3), unlockpt(3), pts(4)

TRADUCTION

Christophe Blaess, 2003.