[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    ptsname(3C) manual page Table of Contents

Name

ptsname - get name of the slave pseudo-terminal device

Synopsis

#include <stdio.h>

char *ptsname(int fildes);

MT-Level

Safe

Description

The ptsname() function returns the name of the slave pseudo-terminal device associated with a master pseudo-terminal device. fildes is a file descriptor returned from a successful open of the master device. ptsname() returns a pointer to a string containing the null-terminated path name of the slave device of the form /dev/pts/N, where N is a non-negative integer.

Return Values

Upon successful completion, the function ptsname() returns a pointer to a string which is the name of the pseudo-terminal slave device. This value points to a static data area that is overwritten by each call to ptsname(). Upon failure, ptsname() returns NULL . This could occur if fildes is an invalid file descriptor or if the slave device name does not exist in the file system.

See Also

open(2) , grantpt(3C) , ttyname(3C) , unlockpt(3C)


Table of Contents