getpt(3)

✨ getpt — open a new pseudoterminal master ✨

okay bestie, we're in the library functions manual (getpt(3)) and this one is short but it's got LORE, so sit with me 💅

---

🌸 NAME 🌸

getpt — open a new pseudoterminal master

like, it gets you a pty. that's the whole job. that's the girlbossery.

---

📚 LIBRARY 📚

Standard C library (libc, -lc)

---

🎀 SYNOPSIS 🎀

#define _GNU_SOURCE             /* See feature_test_macros(7) */
#include <stdlib.h>

int getpt(void);

heads up: that #define _GNU_SOURCE is not optional, bestie. no define, no function. see feature_test_macros(7) for the receipts.

---

🦋 DESCRIPTION 🦋

so getpt() opens a brand new pseudoterminal device and hands you back a file descriptor that refers to that device. that's it, that's the function 🫶

it is equivalent to opening the pseudoterminal multiplexer device like this:

open("/dev/ptmx", O_RDWR);

on Linux systems — but here's the plot twist — the pseudoterminal multiplexer device is located elsewhere on some systems that use the GNU C library. so like, don't be out here hardcoding assumptions, iykyk 🧚

---

💖 RETURN VALUE 💖

• on a good day? getpt() returns an open file descriptor. slay. ✨
• on a bad day? it returns -1 and sets errno to tell you what went wrong. not slay, but at least it's honest 💀

---

😭 ERRORS 😭

getpt() can fail with various errors described in open(2). go read that one, it's the whole buffet.

---

👑 ATTRIBUTES 👑

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

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

translation: it's thread safe, bestie, go wild (responsibly)

---

⭐ VERSIONS ⭐

use posix_openpt(3) instead.

fr fr. this one's giving deprecated energy. getpt() is lowkey the older sibling and posix_openpt(3) is the one that ate. 💅

---

🌈 STANDARDS 🌈

GNU.

---

🍓 HISTORY 🍓

glibc 2.1.

so it's been around a minute. respect the elders 🫡

---

💜 SEE ALSO 💜

• grantpt(3)
• posix_openpt(3)
• ptsname(3)
• unlockpt(3)
• ptmx(4)
• pty(7)

---

and that's the page, bestie!! 🎀 this was pulled straight from Linux man-pages 6.20, dated 2025-12-26, and you just read getpt(3). go forth and open your pseudoterminals responsibly ✨💖 🦋