Name

ctermid - gets controlling terminal name

Library

libc.lib

Synopsis

  #include <stdio.h>
  char * ctermid (char *buf);
  char * ctermid_r (char *buf);

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.

Detailed 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 the NULL pointer, a pointer to a static area is returned. Otherwise, the pathname is copied into the memory referenced by buf. The argument buf is assumed to be at least L_ctermid (as defined in the include file

  #include <stdio.h )>bytes long.

The ctermid_r function provides the same functionality as ctermid except that if buf is a NULL pointer, NULL is returned.

The current implementation simply returns ‘/dev/tty.’


Errors

The current implementation detects no error conditions.

See also

The ctermid function conforms to -p1003.1-88.

Bugs

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

Feedback

For additional information or queries on this page send feedback

© 2008-2009 Nokia Corporation. All rights reserved. This documentation can be used in the connection with this Product to help and support the user.

Top