Linux repositories inspector
GNU
2017-09-15

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

grantpt - разрешает доступ для подчинённому псевдотерминалу

ОБЗОР

#include <stdlib.h>
int grantpt(int fd);
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
grantpt():

начиная с glibc 2.24:
_XOPEN_SOURCE >= 500 ||
(_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED)
glibc 2.23 и старее:
_XOPEN_SOURCE

ОПИСАНИЕ

Функция grantpt() изменяет режим и владельца для устройства подчинённого псевдотерминала, соответствующего основному псевдотерминалу, на который ссылается fd. Идентификатор пользователя подчинённого устанавливается в действительный UID вызывающего процесса. Идентификатор группы устанавливается в неопределенное значение (например, tty). Права доступа к подчинённому псевдотерминала назначаются как 0620 (crw--w----).
Поведение grantpt() не определено, если установлен обработчик сигналов для перехвата сигналов SIGCHLD.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении grantpt() возвращает 0. Иначе возвращается -1 и переменная errno устанавливается соответствующим образом.

ОШИБКИ

EACCES Невозможно получить доступ к соответствующему подчинённому псевдотерминалу.
EBADF Аргумент fd не является правильным открытым файловым дескриптором.
EINVAL Значение fd корректно, но не связано с основным псевдотерминалом.

ВЕРСИИ

Функция grantpt() появилась в glibc начиная с версии 2.1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
Интерфейс Атрибут Значение
grantpt() Безвредность в нитях MT-Safe locale

СООТВЕТСТВИЕ СТАНДАРТАМ

POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

Является частью поддержки псевдотерминалов UNIX 98 (смотрите pts(4)).
Многие системы реализуют эту функцию через вспомогательный исполняемый файл с установленным битом SUID, называемый «pt_chown». Благодаря файловой системе Linux devpts (начиная с Linux 2.2), ядро обычным образом устанавливает корректные значения владельца и права на подчинённый псевдотерминал когда открывается основной (posix_openpt(3)), поэтому grantpt() делать ничего не нужно. Таким образом, подобный вспомогательный файл не требуется ( и действительно, это значение пусто при сборке glibc, которая используется во многих системах).

СМОТРИТЕ ТАКЖЕ

⇧ Top