openpty, login_tty, forkpty -
функции
для работы
с
терминалом
System utilities library (
libutil,
-lutil)
#include <pty.h>
int openpty(int *amaster, int *aslave, char *name,
const struct termios *termp,
const struct winsize *winp);
pid_t forkpty(int *amaster, char *name,
const struct termios *termp,
const struct winsize *winp);
#include <utmp.h>
int login_tty(int fd);
Функция
openpty()
ищет
доступный
псевдотерминал
и
возвращает
файловые
дескрипторы
для его
основного
и
подчинённого
устройств
в
amaster и
aslave.
Если
name не
равно NULL, то
имя файла
подчинённого
устройства
возвращается
в
name. Если
termp
не равно NULL,
то
параметры
терминала
подчинённого
устройства
будут
установлены
в значения,
указанные
в
termp. Если
winp
не равно NULL,
то размер
окна
подчинённого
устройства
будет
установлен
согласно
значениям,
указанным
в
winp.
The
login_tty() function prepares for a login on the terminal referred to
by the file descriptor
fd (which may be a real terminal device, or the
slave of a pseudoterminal as returned by
openpty()) by creating a new
session, making
fd the controlling terminal for the calling process,
setting
fd to be the standard input, output, and error streams of the
current process, and closing
fd.
The
forkpty() function combines
openpty(),
fork(2), and
login_tty() to create a new process operating in a pseudoterminal. A
file descriptor referring to master side of the pseudoterminal is returned in
amaster. If
name is not NULL, the buffer it points to is used to
return the filename of the slave. The
termp and
winp arguments,
if not NULL, will determine the terminal attributes and window size of the
slave side of the pseudoterminal.
Если вызов
openpty(),
login_tty() или
forkpty()
завершается
с ошибкой,
то
возвращается
-1 и
errno
указывает
на тип
ошибки.
Иначе,
openpty(),
login_tty()
и дочерний
процесс
forkpty()
возвращают
0, и
родительский
процесс
forkpty()
возвращает
ID дочернего
процесса.
Вызов
openpty()
завершается
ошибкой
если:
- ENOENT
- Нет
доступных
терминалов.
Завершается
ошибкой
функция
login_tty(),
если
ioctl(2) не
может
назначить
fd
управляющему
терминалу
вызываемого
процесса.
Завершается
ошибкой
функция
forkpty(),
если не
сработает
хотя бы
одна из
функций
openpty()
или
fork(2).
Описание
терминов
данного
раздела
смотрите в
attributes(7).
| Интерфейс |
Атрибут |
Значение |
|
forkpty(), openpty() |
Безвредность
в нитях |
MT-Safe locale |
|
login_tty() |
Безвредность
в нитях |
MT-Unsafe race:ttyname |
Данные
функции BSD
есть в glibc. Они
не
стандартизированы
в POSIX.
Модификаторы
const были
добавлены
в
аргументы
указателей
на
структуры
openpty() и
forkpty() в glibc 2.8.
Before glibc 2.0.92,
openpty() returns file descriptors for a BSD
pseudoterminal pair; since glibc 2.0.92, it first attempts to open a UNIX 98
pseudoterminal pair, and falls back to opening a BSD pseudoterminal pair if
that fails.
Невозможно
определить
сколько
места
должно
быть
зарезервировано
для
name.
Поэтому,
вызов
openpty()
или
forkpty() со
значением
name не равным
NULL может быть
небезопасен.
fork(2),
ttyname(3),
pty(7)
Русский
перевод
этой
страницы
руководства
был сделан
Azamat Hackimov <
[email protected]>, Konstantin Shvaykovskiy
<
[email protected]>, Yuri Kozlov <
[email protected]> и
Иван
Павлов <
[email protected]>
Этот
перевод
является
бесплатной
документацией;
прочитайте
Стандартную
общественную
лицензию GNU
версии 3
или более
позднюю,
чтобы
узнать об
условиях
авторского
права. Мы не
несем
НИКАКОЙ
ОТВЕТСТВЕННОСТИ.
Если вы
обнаружите
ошибки в
переводе
этой
страницы
руководства,
пожалуйста,
отправьте
электронное
письмо на
[email protected]