]>
Commit | Line | Data |
---|---|---|
2d6c6dd1 | 1 | .\" %%%LICENSE_START(PUBLIC_DOMAIN) |
fea681da | 2 | .\" This page is in the public domain. - aeb |
2d6c6dd1 | 3 | .\" %%%LICENSE_END |
fea681da | 4 | .\" |
d17763e0 | 5 | .TH UNLOCKPT 3 2013-12-09 "" "Linux Programmer's Manual" |
fea681da | 6 | .SH NAME |
b218b023 | 7 | unlockpt \- unlock a pseudoterminal master/slave pair |
fea681da MK |
8 | .SH SYNOPSIS |
9 | .nf | |
b80f966b | 10 | .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */" |
fea681da MK |
11 | .br |
12 | .B #include <stdlib.h> | |
13 | .sp | |
14 | .BI "int unlockpt(int " fd ");" | |
15 | .fi | |
16 | .SH DESCRIPTION | |
17 | The | |
31e9a9ec | 18 | .BR unlockpt () |
b218b023 MK |
19 | function unlocks the slave pseudoterminal device |
20 | corresponding to the master pseudoterminal referred to by | |
fea681da MK |
21 | .IR fd . |
22 | .PP | |
31e9a9ec | 23 | .BR unlockpt () |
b218b023 | 24 | should be called before opening the slave side of a pseudoterminal. |
47297adb | 25 | .SH RETURN VALUE |
fea681da | 26 | When successful, |
31e9a9ec | 27 | .BR unlockpt () |
677f4766 MK |
28 | returns 0. |
29 | Otherwise, it returns \-1 and sets | |
fea681da MK |
30 | .I errno |
31 | appropriately. | |
32 | .SH ERRORS | |
33 | .TP | |
34 | .B EBADF | |
35 | The | |
36 | .I fd | |
37 | argument is not a file descriptor open for writing. | |
38 | .TP | |
39 | .B EINVAL | |
40 | The | |
41 | .I fd | |
b218b023 | 42 | argument is not associated with a master pseudoterminal. |
c343e74c MK |
43 | .SH VERSIONS |
44 | .BR unlockpt () | |
45 | is provided in glibc since version 2.1. | |
d17763e0 PH |
46 | .SH ATTRIBUTES |
47 | .SS Multithreading (see pthreads(7)) | |
48 | The | |
49 | .BR unlockpt () | |
50 | function is thread-safe. | |
47297adb | 51 | .SH CONFORMING TO |
68e1685c | 52 | POSIX.1-2001. |
47297adb | 53 | .SH SEE ALSO |
31e9a9ec | 54 | .BR grantpt (3), |
a856c2ea | 55 | .BR posix_openpt (3), |
31e9a9ec | 56 | .BR ptsname (3), |
88ab292b MK |
57 | .BR pts (4), |
58 | .BR pty (7) |