Scroll to navigation

openpty(3) Library Functions Manual openpty(3)

ИМЯ

openpty, login_tty, forkpty - функции для работы с терминалом

LIBRARY

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() завершается ошибкой если:

Нет доступных терминалов.

Завершается ошибкой функция 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 <azamat.hackimov@gmail.com>, Konstantin Shvaykovskiy <kot.shv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.

15 декабря 2022 г. Linux man-pages 6.03