From 0d8b8175c5f82782608130bea227915bfbe896a9 Mon Sep 17 00:00:00 2001
From: auronandace <auronandace@googlemail.com>
Date: Mon, 1 Jun 2026 08:20:53 +0100
Subject: [PATCH] verify netdb header includes

---
 src/header/netdb/cbindgen.toml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/header/netdb/cbindgen.toml b/src/header/netdb/cbindgen.toml
index b031875f72..be918c0426 100644
--- a/src/header/netdb/cbindgen.toml
+++ b/src/header/netdb/cbindgen.toml
@@ -1,4 +1,12 @@
+# POSIX header spec: https://pubs.opengroup.org/onlinepubs/9799919799/basedefs/netdb.h.html
+#
+# Spec quotations relating to includes:
+# - "The <netdb.h> header shall define the uint32_t type as described in <inttypes.h>."
+# - "The <netdb.h> header shall define the socklen_t type through typedef, as described in <sys/socket.h>."
+# - "Inclusion of the <netdb.h> header may also make visible all symbols from <netinet/in.h>, <sys/socket.h>, and <inttypes.h>."
+#
 # netinet/in.h brings in sys/socket.h
+# features.h needed for deprecated annotations
 sys_includes = ["inttypes.h", "netinet/in.h", "features.h"]
 include_guard = "_RELIBC_NETDB_H"
 trailer = """