MirOS Manual: ctermid(3)

CTERMID(3)                 BSD Programmer's Manual                  CTERMID(3)

NAME

     ctermid - generate terminal pathname

SYNOPSIS

     #include <stdio.h>

     char *
     ctermid(char *buf);

DESCRIPTION

     The ctermid() function generates a string, that, when used as a pathname,
     refers to the current controlling terminal of the calling process.

     If buf is a null pointer, a pointer to a static area is returned. Other-
     wise, the pathname is copied into the memory referenced by buf. The argu-
     ment buf is assumed to point to an array at least L_ctermid (as defined
     in the include file <stdio.h>) bytes long.

     The current implementation simply generates "/dev/tty".

RETURN VALUES

     Upon successful completion, a non-null pointer is returned. Otherwise, a
     null pointer is returned and the global variable errno is set to indicate
     the error.

ERRORS

     The current implementation detects no error conditions.

SEE ALSO

     ttyname(3)

STANDARDS

     The ctermid() function conforms to IEEE Std 1003.1-1988 ("POSIX").

BUGS

     By default the ctermid() function writes all information to an internal
     static object. Subsequent calls to ctermid() will modify the same object.

MirOS BSD #10-current            June 4, 1993                                1

Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.