166492cf0SYuri Pankov.\" 266492cf0SYuri Pankov.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for 366492cf0SYuri Pankov.\" permission to reproduce portions of its copyrighted documentation. 466492cf0SYuri Pankov.\" Original documentation from The Open Group can be obtained online at 5c10c16deSRichard Lowe.\" http://www.opengroup.org/bookstore/. 666492cf0SYuri Pankov.\" 766492cf0SYuri Pankov.\" The Institute of Electrical and Electronics Engineers and The Open 866492cf0SYuri Pankov.\" Group, have given us permission to reprint portions of their 966492cf0SYuri Pankov.\" documentation. 1066492cf0SYuri Pankov.\" 1166492cf0SYuri Pankov.\" In the following statement, the phrase ``this text'' refers to portions 1266492cf0SYuri Pankov.\" of the system documentation. 1366492cf0SYuri Pankov.\" 1466492cf0SYuri Pankov.\" Portions of this text are reprinted and reproduced in electronic form 1566492cf0SYuri Pankov.\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition, 1666492cf0SYuri Pankov.\" Standard for Information Technology -- Portable Operating System 1766492cf0SYuri Pankov.\" Interface (POSIX), The Open Group Base Specifications Issue 6, 1866492cf0SYuri Pankov.\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics 1966492cf0SYuri Pankov.\" Engineers, Inc and The Open Group. In the event of any discrepancy 2066492cf0SYuri Pankov.\" between these versions and the original IEEE and The Open Group 2166492cf0SYuri Pankov.\" Standard, the original IEEE and The Open Group Standard is the referee 2266492cf0SYuri Pankov.\" document. The original Standard can be obtained online at 2366492cf0SYuri Pankov.\" http://www.opengroup.org/unix/online.html. 2466492cf0SYuri Pankov.\" 25c10c16deSRichard Lowe.\" This notice shall appear on any product containing this material. 2666492cf0SYuri Pankov.\" 2766492cf0SYuri Pankov.\" The contents of this file are subject to the terms of the 2866492cf0SYuri Pankov.\" Common Development and Distribution License (the "License"). 2966492cf0SYuri Pankov.\" You may not use this file except in compliance with the License. 3066492cf0SYuri Pankov.\" 3166492cf0SYuri Pankov.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 3266492cf0SYuri Pankov.\" or http://www.opensolaris.org/os/licensing. 3366492cf0SYuri Pankov.\" See the License for the specific language governing permissions 3466492cf0SYuri Pankov.\" and limitations under the License. 3566492cf0SYuri Pankov.\" 3666492cf0SYuri Pankov.\" When distributing Covered Code, include this CDDL HEADER in each 3766492cf0SYuri Pankov.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. 3866492cf0SYuri Pankov.\" If applicable, add the following below this CDDL HEADER, with the 3966492cf0SYuri Pankov.\" fields enclosed by brackets "[]" replaced with your own identifying 4066492cf0SYuri Pankov.\" information: Portions Copyright [yyyy] [name of copyright owner] 4166492cf0SYuri Pankov.\" 4266492cf0SYuri Pankov.\" 4366492cf0SYuri Pankov.\" Copyright 1989 AT&T 4466492cf0SYuri Pankov.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved 4566492cf0SYuri Pankov.\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved. 461fa2a664SJoshua M. Clulow.\" Copyright 2022 Oxide Computer Company 4766492cf0SYuri Pankov.\" 481fa2a664SJoshua M. Clulow.Dd February 5, 2022 491fa2a664SJoshua M. Clulow.Dt PTSNAME 3C 501fa2a664SJoshua M. Clulow.Os 511fa2a664SJoshua M. Clulow.Sh NAME 521fa2a664SJoshua M. Clulow.Nm ptsname 531fa2a664SJoshua M. Clulow.Nd get the name of the subsidiary device of a pseudo-terminal 541fa2a664SJoshua M. Clulow.Sh SYNOPSIS 551fa2a664SJoshua M. Clulow.In stdlib.h 561fa2a664SJoshua M. Clulow.Ft char * 571fa2a664SJoshua M. Clulow.Fo ptsname 581fa2a664SJoshua M. Clulow.Fa "int fildes" 591fa2a664SJoshua M. Clulow.Fc 601fa2a664SJoshua M. Clulow.Sh DESCRIPTION 611fa2a664SJoshua M. ClulowThe 621fa2a664SJoshua M. Clulow.Fn ptsname 631fa2a664SJoshua M. Clulowfunction returns the name of the pseudo-terminal subsidiary device associated 641fa2a664SJoshua M. Clulowwith a pseudo-terminal manager device. 651fa2a664SJoshua M. ClulowThe 661fa2a664SJoshua M. Clulow.Fa fildes 671fa2a664SJoshua M. Clulowargument is a file descriptor returned from a successful open of the 681fa2a664SJoshua M. Clulowpseudo-terminal manager device; e.g., by calling 691fa2a664SJoshua M. Clulow.Xr posix_openpt 3C 701fa2a664SJoshua M. Clulowor by performing an 711fa2a664SJoshua M. Clulow.Xr open 2 721fa2a664SJoshua M. Clulowof the 73*bbf21555SRichard Lowe.Xr ptm 4D 741fa2a664SJoshua M. Clulowdevice. 751fa2a664SJoshua M. Clulow.Pp 761fa2a664SJoshua M. ClulowThe 771fa2a664SJoshua M. Clulow.Fn ptsname 781fa2a664SJoshua M. Clulowfunction returns a pointer to a string containing the null-terminated 791fa2a664SJoshua M. Clulowpath name of the subsidiary device. 801fa2a664SJoshua M. ClulowThis string is of the form 811fa2a664SJoshua M. Clulow.Pa /dev/pts/N , 821fa2a664SJoshua M. Clulowwhere 831fa2a664SJoshua M. Clulow.Sy N 841fa2a664SJoshua M. Clulowis a non-negative integer. 851fa2a664SJoshua M. Clulow.Sh RETURN VALUES 861fa2a664SJoshua M. ClulowIf successful, the 871fa2a664SJoshua M. Clulow.Fn ptsname 881fa2a664SJoshua M. Clulowfunction returns a pointer to a string which is the name of the pseudo-terminal 891fa2a664SJoshua M. Clulowsubsidiary device. 901fa2a664SJoshua M. ClulowThis value points to a static data area that is overwritten by each call to 911fa2a664SJoshua M. Clulow.Fn ptsname . 921fa2a664SJoshua M. Clulow.Pp 931fa2a664SJoshua M. ClulowUpon failure, 941fa2a664SJoshua M. Clulow.Fn ptsname 951fa2a664SJoshua M. Clulowreturns 961fa2a664SJoshua M. Clulow.Dv NULL . 971fa2a664SJoshua M. ClulowThis could occur if 981fa2a664SJoshua M. Clulow.Fa fildes 991fa2a664SJoshua M. Clulowis an invalid file descriptor or if the subsidiary device name does not exist 1001fa2a664SJoshua M. Clulowin the file system. 1011fa2a664SJoshua M. Clulow.Sh INTERFACE STABILITY 1021fa2a664SJoshua M. Clulow.Sy Committed 1031fa2a664SJoshua M. Clulow.Sh MT LEVEL 1041fa2a664SJoshua M. Clulow.Sy Safe 1051fa2a664SJoshua M. Clulow.Sh SEE ALSO 1061fa2a664SJoshua M. Clulow.Xr open 2 , 1071fa2a664SJoshua M. Clulow.Xr grantpt 3C , 1081fa2a664SJoshua M. Clulow.Xr posix_openpt 3C , 1091fa2a664SJoshua M. Clulow.Xr ttyname 3C , 1101fa2a664SJoshua M. Clulow.Xr unlockpt 3C , 111*bbf21555SRichard Lowe.Xr ptm 4D , 112*bbf21555SRichard Lowe.Xr pts 4D , 113*bbf21555SRichard Lowe.Xr attributes 7 , 114*bbf21555SRichard Lowe.Xr standards 7 115