Проект OpenNet: MAN grantpt (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

grantpt (3)

grantpt (3) ( Solaris man: Библиотечные вызовы )

>> grantpt (3) ( FreeBSD man: Библиотечные вызовы )

grantpt (3) ( Русские man: Библиотечные вызовы )

grantpt (3) ( Linux man: Библиотечные вызовы )

grantpt (3) ( POSIX man: Библиотечные вызовы )

BSD mandoc

NAME

grantpt

 
ptsname

 
unlockpt

 
posix_openpt

 - pseudo-terminal access functions

LIBRARY

Lb libc

SYNOPSIS

#include <stdlib.h>
int grantpt (int fildes);
char * ptsname (int fildes);
int unlockpt (int fildes);
#include <fcntl.h>
int posix_openpt (int mode);

DESCRIPTION

The grantpt (,);
ptsname (,);
unlockpt (,);
and posix_openpt ();
functions allow access to pseudo-terminal devices. The first three functions accept a file descriptor that references the master half of a pseudo-terminal pair. This file descriptor is created with posix_openpt (.);

The grantpt ();
function is used to establish ownership and permissions of the slave device counterpart to the master device specified with Fa fildes . The slave device's ownership is set to the real user ID of the calling process, and the permissions are set to user readable-writable and group writable. The group owner of the slave device is also set to the group ``tty '' if it exists on the system; otherwise, it is left untouched.

The ptsname ();
function returns the full pathname of the slave device counterpart to the master device specified with Fa fildes . This value can be used to subsequently open the appropriate slave after posix_openpt ();
and grantpt ();
have been called.

The unlockpt ();
function clears the lock held on the pseudo-terminal pair for the master device specified with Fa fildes .

The posix_openpt ();
function opens the first available master pseudo-terminal device and returns a descriptor to it. The Fa mode argument specifies the flags used for opening the device:

O_RDWR: Open for reading and writing.
O_NOCTTY: If set, do not allow the terminal to become the controlling terminal for the calling process.

RETURN VALUES

Rv -std grantpt unlockpt

The ptsname ();
function returns a pointer to the name of the slave device on success; otherwise a NULL pointer is returned and the global variable errno is set to indicate the error.

The posix_openpt ();
function returns a file descriptor to the first available master pseudo-terminal device on success; otherwise -1 is returned and the global variable errno is set to indicate the error.

ERRORS

The grantpt (,);
ptsname (,);
and unlockpt ();
functions may fail and set errno to:

Bq Er EINVAL: Fa fildes is not a master pseudo-terminal device.

In addition, the grantpt ();
function may set errno to:

Bq Er EACCES: The slave pseudo-terminal device could not be accessed.

The posix_openpt ();
function may fail and set errno to:

Bq Er EINVAL: Fa mode consists of an invalid mode bit.
Bq Er EAGAIN: The system has no available pseudo-terminal devices.

The grantpt (,);
ptsname (,);
and unlockpt ();
functions may also fail and set errno for any of the errors specified for the fstat(2) system call.

The posix_openpt ();
function may also fail and set errno for any of the errors specified for the open(2) system call.

STANDARDS

The grantpt (,);
ptsname (,);
unlockpt (,);
and posix_openpt ();
functions conform to St -p1003.1-2001 .

HISTORY

The grantpt (,);
ptsname (,);
unlockpt (,);
and posix_openpt ();
functions appeared in Fx 5.0 .

NOTES

The flag O_NOCTTY is included for compatibility; in Fx , opening a terminal does not cause it to become a process's controlling terminal.

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру