ИМЯ¶

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

СИНТАКСИС¶

#include <stdlib.h>

int grantpt(int fd);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

grantpt():

ОПИСАНИЕ¶

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

Поведение grantpt() не определено, если установлен обработчик сигналов для перехвата сигналов SIGCHLD.

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

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

ОШИБКИ¶

EACCES

Невозможно получить доступ к соответствующему подчинённому псевдотерминалу.

EBADF

Аргумент fd не является правильным открытым файловым дескриптором.

EINVAL

Значение fd корректно, но не связано с основным псевдотерминалом.

ВЕРСИИ¶

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

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

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

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

ЗАМЕЧАНИЯ¶

Является частью поддержки псевдотерминалов UNIX 98 (смотрите pts(4)).

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

СМ. ТАКЖЕ¶

open(2), posix_openpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.