ptsname()
QNX SDP8.0C Library ReferenceAPIDeveloper
Get the name of a slave pseudo-terminal device
Synopsis:
#include <stdlib.h>
char *ptsname( int filedes );
Arguments:
- filedes
- The file descriptor for the master pseudo-terminal.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The ptsname() function gets the name of the slave pseudo-terminal device associated with a master pseudo-terminal device.
The ptsname_r() function is a QNX OS function that's a reentrant version of ptsname().
Returns:
A pointer to a NUL-terminated string containing the pathname of the corresponding slave device, or NULL if an error occurred (errno is set).
Note:
Don't modify the string that this function returns.
The pointer might be invalidated or the string overwritten by a subsequent call to ptsname()
or if the calling thread is terminated.
Errors:
- EBADF
- The filedes argument isn't a valid file descriptor.
- ENOTTY
- The file associated with the filedes argument isn't a master pseudo-terminal device.
- EOVERFLOW
- The internal buffer is too small to hold the name.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | No |
Page updated: