posix_openpt(3)

💖 posix_openpt(3) — Library Functions Manual 💖

okay bestie, gather round, because we're talking about posix_openpt from the Library Functions Manual, and honestly? it's giving "small function, big responsibilities" 👑

---

✨ NAME ✨

posix_openpt — open a pseudoterminal device 🎀

📚 LIBRARY 📚

Standard C library (libc, -lc) — yeah she lives in libc, no cap.

🌸 SYNOPSIS 🌸

#include <stdlib.h>
#include <fcntl.h>

int posix_openpt(int flags);

🦋 Feature Test Macro Requirements for glibc (see feature_test_macros(7)) 🦋

• posix_openpt(): _XOPEN_SOURCE >= 600

like, if you don't define that macro bestie, glibc is gonna pretend she doesn't know you 💀

---

💅 DESCRIPTION 💅

So what does she do? posix_openpt() opens an unused pseudoterminal master device, and hands you back a file descriptor you can use to refer to that device. that's it, that's the whole vibe. lowkey iconic.

The flags argument is a bit mask that ORs together zero or more of these flags:

• O_RDWR — opens the device for both reading and writing. literally it is so usual to specify this flag. like, everyone does. do it.
• O_NOCTTY — do not make this device the controlling terminal for the process. so if you're not tryna be in charge here, this is your girl 🙈

---

🫶 RETURN VALUE 🫶

On success, posix_openpt() returns a file descriptor (a nonnegative integer) which is the lowest numbered unused file descriptor. real "first available seat in the row" energy 🎟️

On failure, -1 is returned, and errno is set to indicate the error. so like, check errno, she's telling you what went wrong, listen to her 😭

---

🚨 ERRORS 🚨

See open(2). that's it, that's the whole section, go read that one bestie, she's got the receipts 📜

---

👑 ATTRIBUTES 👑

For an explanation of the terms used in this section, see attributes(7).

• Interface: posix_openpt()
  • Attribute: Thread safety
  • Value: MT-Safe ✨

so she's MT-Safe, meaning multiple threads can call her and she won't start drama. we love a drama-free queen 💅

---

⭐ STANDARDS ⭐

POSIX.1-2008. certified. official. periodt.

---

🌈 HISTORY 🌈

• glibc 2.2.1.
• POSIX.1-2001.

It is part of the UNIX 98 pseudoterminal support (see pts(4)). so she's been around a minute, and she's been serving the whole time 🕰️💖

---

💜 NOTES 💜

okay so some older UNIX implementations that support System V (aka UNIX 98) pseudoterminals don't have this function at all. rude, honestly. but bestie — it can be easily implemented by opening the pseudoterminal multiplexer device, like:

int
posix_openpt(int flags)
{
    return open("/dev/ptmx", flags);
}

look at her. three lines. a whole function. we stan a DIY icon 🛠️✨

Calling posix_openpt() creates a pathname for the corresponding pseudoterminal slave device. the pathname of the slave device can be obtained using ptsname(3). and here's the important bit, don't skip it:

The slave device pathname exists only as long as the master device is open. so if you close the master, the pathname just… evaporates. gone. poof. 🫧 be aware, bestie, or you will be confused later and it will not be cute.

---

🔥 SEE ALSO 🔥

open(2), getpt(3), grantpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)

---

that's the whole page, bestie, you ate that 🍓

signing off with love from Linux man-pages 6.20, dated 2026-02-08 — mwah 💋