Standard C Library Functions                          ctermid(3C)



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

SYNOPSIS
     #include 

     char *ctermid(char *s);


     char *ctermidr(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 Lctermid
     elements. The path name is placed  in  this  array  and  the
     value of s is returned. The constant Lctermid is defined in
     the header .

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

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  ctermidr()  function is MT-Safe and should be
     used instead.


     When compiling multithreaded applications,  the   RENTRANT
     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)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE      
    
     Interface Stability          ctermid() is Standard      
    
     MT-Level                     ctermid()    is     Unsafe;
                                  ctermidr() is MT-Safe     
   


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





































SunOS 5.11          Last change: 25 Jul 2000                    2