ptsname man page on OSF1

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
OSF1 logo
[printable version]

ptsname(3)							    ptsname(3)

NAME
       ptsname, ptsname_r - Get the name of a slave pseudoterminal device

SYNOPSIS
       #include <stdlib.h>

       char *ptsname(
	       int masterfd );

       The following function is not defined in current industry standards and
       is supported only for backward compatibility. You should not use it  in
       new designs.

       int ptsname_r(
	       int masterfd,
	       char *slavename,
	       int len );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       ptsname(): XSH5.0

       Refer to the standards(5) reference page	 for  more  information	 about
       industry standards and associated tags.

PARAMETERS
       Specifies  a file descriptor that is returned from a successful open of
       the master pty.	Points to the character array for the resulting	 null-
       terminated  pathname  of	 the  slave  pty.  Specifies the length of the
       slave pty specified by slavename. This length must be 32 bytes.

DESCRIPTION
       The ptsname() function returns the name	of  the	 slave	pseudoterminal
       device associated with a master pseudoterminal device.

NOTES
       The  ptsname() function returns a pointer to thread-specific data. Sub‐
       sequent calls to this function from  the	 same  thread  overwrite  this
       data.

       [Tru64 UNIX]  The ptsname_r() function is an obsolete reentrant version
       of the ptsname() function. It is supported in order to  maintain	 back‐
       ward  compatibility  with previous versions of the operating system and
       should not be used in new designs.

RETURN VALUES
       Upon successful completion, the ptsname() function returns a pointer to
       a string that contains the pathname of the slave pseudoterminal device.
       The pathname has the form: /dev/pts /N. Upon failure, it returns a null
       pointer.	 The function can fail if the masterfd parameter is an invalid
       file descriptor or if the slave device name does not exist in the  file
       system.

       [Tru64  UNIX]  Upon  successful	completion,  the  ptsname_r() function
       stores a the string in slavename and returns a value of 0 (zero).  Upon
       failure, it returns a value of -1 and may place an appropriate value in
       the errno variable.

ERRORS
       If the following conditions occur, the ptsname_r() function sets	 errno
       to  the	following  value:  [Tru64  UNIX]  The  slavename  parameter is
       invalid or the len parameter is too small.

SEE ALSO
       Functions: openpty(3), pty(7)

       Standards: standards(5)

								    ptsname(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net