Manual Pages for UNIX Operating System command usage for man ctermid_r

Standard C Library Functions                          ctermid(3C)



NAME
     ctermid, ctermid_r - generate path name for controlling ter-
     minal

SYNOPSIS
     #include 

     char *ctermid(char *s);


     char *ctermid_r(char *s);


DESCRIPTION
  ctermid()
     The ctermid() function generates the path name of  the  con-
     trolling terminal for the current process and stores it in a
     string.


     If s is a null pointer, the string is stored in an  internal
     static area whose address is returned and whose contents are
     overwritten at the next call to ctermid(). Otherwise,  s  is
     assumed  to point to a character array of at least L_ctermid
     elements. The path name is placed  in  this  array  and  the
     value of s is returned. The constant L_ctermid is defined in
     the header .

  ctermid_r()
     The ctermid_r() function behaves as ctermid() except that if
     s is a null pointer, the function returns NULL.

USAGE
     The difference between ctermid()  and  ttyname(3C)  is  that
     ttyname()  must  be passed a file descriptor and returns the
     actual name  of  the  terminal  associated  with  that  file
     descriptor, while ctermid() returns a string (/dev/tty) that
     will refer to the terminal if  used  as  a  file  name.  The
     ttyname() function is useful only if the process already has
     at least one file open to a terminal.


     The ctermid() function is unsafe in  multithreaded  applica-
     tions.   The  ctermid_r()  function is MT-Safe and should be
     used instead.


     When compiling multithreaded applications,  the   _REENTRANT
     flag  must be defined on the compile line.  This flag should
     be used only with multithreaded applications.





SunOS 5.11          Last change: 25 Jul 2000                    1






Standard C Library Functions                          ctermid(3C)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
   |        ATTRIBUTE TYPE       |        ATTRIBUTE VALUE      |
   | ____________________________|_____________________________|_
   |  Interface Stability        |  ctermid() is Standard      |
   | ____________________________|_____________________________|_
   |  MT-Level                   |  ctermid()    is     Unsafe;|
   |                             |  ctermid_r() is MT-Safe     |
   |_____________________________|_____________________________|


SEE ALSO
     ttyname(3C), attributes(5)





































SunOS 5.11          Last change: 25 Jul 2000                    2