SHUTDOWN(3POSIX)

✨ SHUTDOWN(3POSIX) ✨

okay so bestie, welcome to the POSIX Programmer's Manual 💖 this one's shutdown, from the 3POSIX corner of the man-page universe, and it's genuinely so useful once it clicks. pull up a chair 🎀

---

🌸 PROLOG 🌸

This manual page is part of the POSIX Programmer's Manual. Heads up though — the Linux implementation of this interface may differ (so like, go check the corresponding Linux manual page for the deets on Linux behavior), or honestly the interface may not even be implemented on Linux at all. no cap 🙈

---

👑 NAME 👑

shutdown — shut down socket send and receive operations. it's giving "we're done here" energy 💅

---

🦋 SYNOPSIS 🦋

#include <sys/socket.h>

int shutdown(int socket, int how);

---

💜 DESCRIPTION 💜

okay so the shutdown() function shall cause all or part of a full-duplex connection on the socket associated with the file descriptor socket to be shut down. like, you're closing the convo — maybe just one direction, maybe both 🌈

The shutdown() function takes the following arguments:

• socket — specifies the file descriptor of the socket. that's your lil handle for the connection, bestie 🫶
• how — specifies the type of shutdown. the values are as follows:
  • SHUT_RD — disables further receive operations. so you're done listening, periodt 🙉
  • SHUT_WR — disables further send operations. you've said your piece, no more sending 💬
  • SHUT_RDWR — disables further send and receive operations. both directions, full main character exit 👑

The shutdown() function disables subsequent send and/or receive operations on a socket, depending on the value of the how argument. that's the whole vibe check right there ✨

---

🔥 RETURN VALUE 🔥

Upon successful completion, shutdown() shall return 0; otherwise, -1 shall be returned and errno set to indicate the error. so 0 is the slay, -1 is the "something went wrong bestie" 😭

---

💀 ERRORS 💀

The shutdown() function shall fail if:

• EBADF — the socket argument is not a valid file descriptor. not a real fd, sorry 🚫
• EINVAL — the how argument is invalid. that's not one of the three values, babe 🙈
• ENOTCONN — the socket is not connected. there's literally nobody on the other end 💔
• ENOTSOCK — the socket argument does not refer to a socket. that's not a socket at all, it's giving impostor 🎭

The shutdown() function may fail if:

• ENOBUFS — insufficient resources were available in the system to perform the operation. the system is lowkey broke rn 😭

The following sections are informative. (yes, that means everything below is bonus content, not the actual spec 👀)

---

🎀 EXAMPLES 🎀

None. yeah, nothing here. iconic of them honestly 💅

---

🍓 APPLICATION USAGE 🍓

None. also nothing. we love a low-effort section ✨

---

🧚 RATIONALE 🧚

None. same energy, bestie 🌸

---

⭐ FUTURE DIRECTIONS ⭐

None. the future is unspecified and honestly, same 🌈

---

🌟 SEE ALSO 🌟

getsockopt(), pselect(), read(), recv(), recvfrom(), recvmsg(), send(), sendto(), setsockopt(), socket(), write()

The Base Definitions volume of POSIX.1‐2017, <sys_socket.h>

go read those too, iykyk 📚

---

💖 COPYRIGHT 💖

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

---

IEEE/The Open Group, 2017 — that's the source, the version and the date all rolled into one, and that's a wrap bestie 🫶💜 shutdown() understood, no cap, you ate 🎀✨