ptsname() — Get name of the slave pseudoterminal device

Standards

Format

#include <stdlib.h>

char *ptsname(int fildes);

General description

The ptsname() function returns the name of the slave pseudoterminal device associated with a master pseudoterminal device. The fildes argument is a file descriptor that refers to the master device. ptsname() returns a pointer to a string containing the path name of the corresponding slave device.

Returned value

If successful, ptsname() returns a pointer to a string which is the name of the pseudoterminal slave device.

If unsuccessful, ptsname() returns a NULL pointer. This could occur if fildes is an invalid file descriptor or if the slave device name does not exist in the file system.

No errors are defined.

Related information

• stdlib.h
• grantpt() — Grant access to the slave pseudoterminal device
• open() — Open a file
• ttyname() — Get the name of a terminal
• unlockpt() — Unlock a pseudoterminal master and slave pair