openpty()
QNX SDP8.0C Library ReferenceAPIDeveloper
Find an available pseudo-tty
Synopsis:
#include <unix.h>
#include <termios.h>
#include <sys/ioctl.h>
int openpty( int* amaster,
int* aslave,
char* name,
struct termios* termp,
struct winsize* winp );
Arguments:
- amaster
- A pointer to a location where openpty() can store the file descriptor of the master side of the pseudo-tty.
- aslave
- A pointer to a location where openpty() can store the file descriptor of the slave side of the pseudo-tty.
- name
- NULL, or a pointer to a buffer where openpty() can store the filename of the slave side of the pseudo-tty.
- termp
- NULL, or a pointer to a termios structure that describes the terminal's control attributes to apply to the slave side of the pseudo-tty.
- winp
- A pointer to a winsize structure that defines the window size to use for the slave side of the pseudo-tty.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The openpty() function finds and opens an available pseudo-tty.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Errors:
- EAGAIN
- There are no ttys available.
The openpty() function can also return any error code that the following functions indicate:
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | Yes |
| Thread | Yes |
Page updated: