posix_ttyname

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_ttynameDetermine terminal device name

Description

posix_ttyname(resource|int $file_descriptor): string|false

Returns a string for the absolute path to the current terminal device that is open on the file descriptor file_descriptor.

Parameters

file_descriptor

The file descriptor, which is expected to be either a file resource or an int. An int will be assumed to be a file descriptor that can be passed directly to the underlying system call.

Return Values

On success, returns a string of the absolute path of the file_descriptor. On failure, returns false

Errors/Exceptions

On invalid file_descriptor integer values an E_WARNING is raised.

Changelog

Version Description
8.3.0 Type error E_WARNINGs are now raised for integer coercions following the usual PHP type coercion semantics.
8.3.0 On invalid file_descriptor integer values an E_WARNING is now raised.

See Also

add a note add a note

User Contributed Notes 1 note

up
0
casper at bcx dot nl
18 years ago
<?php
    var_dump
( posix_ttyname(STDOUT) );
?>

returns:
string(10) "/dev/pts/0"

When using pseudo terminal 1 (ie ssh)
To Top