posix_ctermid

Get path name of controlling terminal

&reftitle.description; ``string``false```posix_ctermid`

Generates a `string` which is the pathname for the current controlling terminal for the process. On error this will set errno, which can be checked using `posix_get_last_error`

&reftitle.parameters; &no.function.parameters;
&reftitle.returnvalues;

Upon successful completion, returns `string` of the pathname to the current controlling terminal. Otherwise &false; is returned and errno is set, which can be checked with `posix_get_last_error`.

&reftitle.examples;

### `posix_ctermid` example

This example will display the path to the current TTY.

    <?php
    echo "I am running from ".posix_ctermid();
    ?>

&reftitle.seealso;

- `posix_ttyname`
- `posix_get_last_error`