openpty()
Find an available pseudo-tty
Synopsis:
#include <unix.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.
This function is in libc.a, but not in libc.so
(in order to save space).
Description:
The openpty() function finds and opens an available pseudo-tty.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Errors:
- ENOENT
- There are no ttys available.