The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

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

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

posix_openpt (3)
  • posix_openpt (3) ( Solaris man: Библиотечные вызовы )
  • >> posix_openpt (3) ( FreeBSD man: Библиотечные вызовы )
  • posix_openpt (3) ( Linux man: Библиотечные вызовы )
  • posix_openpt (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.  

    SEE ALSO

    open(2), pty(4), tty(4)  

    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.


     

    Index

    NAME
    LIBRARY
    SYNOPSIS
    DESCRIPTION
    RETURN VALUES
    ERRORS
    SEE ALSO
    STANDARDS
    HISTORY
    NOTES


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру