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.\" Copyright (c) 1997, The Open Group. All Rights Reserved. 4566492cf0SYuri Pankov.\" Portions 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 UNLOCKPT 3C 501fa2a664SJoshua M. Clulow.Os 511fa2a664SJoshua M. Clulow.Sh NAME 521fa2a664SJoshua M. Clulow.Nm unlockpt 531fa2a664SJoshua M. Clulow.Nd unlock a pseudo-terminal device pair 541fa2a664SJoshua M. Clulow.Sh SYNOPSIS 551fa2a664SJoshua M. Clulow.In stdlib.h 561fa2a664SJoshua M. Clulow.Ft int 571fa2a664SJoshua M. Clulow.Fo unlockpt 581fa2a664SJoshua M. Clulow.Fa "int fildes" 591fa2a664SJoshua M. Clulow.Fc 601fa2a664SJoshua M. Clulow.Sh DESCRIPTION 611fa2a664SJoshua M. ClulowWhen a pseudo-terminal manager device is opened, whether through 621fa2a664SJoshua M. Clulow.Xr posix_openpt 3C 631fa2a664SJoshua M. Clulowor 641fa2a664SJoshua M. Clulow.Xr open 2 651fa2a664SJoshua M. Clulowon a 66*bbf21555SRichard Lowe.Xr ptm 4D 671fa2a664SJoshua M. Clulowdevice, the subsidiary device begins operation in a locked state. 681fa2a664SJoshua M. ClulowThe 691fa2a664SJoshua M. Clulow.Fn unlockpt 701fa2a664SJoshua M. Clulowfunction unlocks the pseudo-terminal subsidiary device associated with the 711fa2a664SJoshua M. Clulowmanager device to which 721fa2a664SJoshua M. Clulow.Fa fildes 731fa2a664SJoshua M. Clulowrefers. 741fa2a664SJoshua M. Clulow.Pp 751fa2a664SJoshua M. ClulowPortable applications must call 761fa2a664SJoshua M. Clulow.Fn unlockpt 771fa2a664SJoshua M. Clulowbefore opening the pseudo-terminal subsidiary device. 781fa2a664SJoshua M. Clulow.Sh RETURN VALUES 791fa2a664SJoshua M. Clulow.Rv -std unlockpt 801fa2a664SJoshua M. Clulow.Sh EXAMPLES 811fa2a664SJoshua M. ClulowSee 821fa2a664SJoshua M. Clulow.Xr posix_openpt 3C 831fa2a664SJoshua M. Clulowfor an example that includes a call to 841fa2a664SJoshua M. Clulow.Fn unlockpt . 851fa2a664SJoshua M. Clulow.Sh ERRORS 861fa2a664SJoshua M. ClulowThe 871fa2a664SJoshua M. Clulow.Fn unlockpt 881fa2a664SJoshua M. Clulowfunction may fail if: 891fa2a664SJoshua M. Clulow.Bl -tag -width Er 901fa2a664SJoshua M. Clulow.It Er EBADF 911fa2a664SJoshua M. ClulowThe 921fa2a664SJoshua M. Clulow.Fa fildes 931fa2a664SJoshua M. Clulowargument is not a file descriptor open for writing. 941fa2a664SJoshua M. Clulow.It Er EINVAL 951fa2a664SJoshua M. ClulowEINVAL 961fa2a664SJoshua M. ClulowThe 971fa2a664SJoshua M. Clulow.Fa fildes 981fa2a664SJoshua M. Clulowargument is not associated with a pseudo-terminal manager device. 991fa2a664SJoshua M. Clulow.El 1001fa2a664SJoshua M. Clulow.Sh INTERFACE STABILITY 1011fa2a664SJoshua M. Clulow.Sy Committed 1021fa2a664SJoshua M. Clulow.Sh MT LEVEL 1031fa2a664SJoshua M. Clulow.Sy Safe 1041fa2a664SJoshua M. Clulow.Sh SEE ALSO 1051fa2a664SJoshua M. Clulow.Xr open 2 , 1061fa2a664SJoshua M. Clulow.Xr grantpt 3C , 1071fa2a664SJoshua M. Clulow.Xr posix_openpt 3C , 1081fa2a664SJoshua M. Clulow.Xr ptsname 3C , 109*bbf21555SRichard Lowe.Xr ptm 4D , 110*bbf21555SRichard Lowe.Xr attributes 7 , 111*bbf21555SRichard Lowe.Xr standards 7 112