From: Ondřej Surý <ondrej@isc.org>
Date: Tue, 5 Aug 2025 05:34:15 +0000 (+0200)
Subject: Document the current default stack sizes on different systems
X-Git-Tag: v9.21.11~7^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f23bdc29ef6d46741a43a683b2434bcc32a12ddd;p=thirdparty%2Fbind9.git

Document the current default stack sizes on different systems

The default stack sizes varies between operating systems and between
different system libc libraries from 128kB (Alpine Linux with MUSL) to
8M (Linux with glibc).  Document the different values used to justify
the value of THREAD_MINSTACKSIZE (currently set to 1MB).
---

diff --git a/lib/isc/thread_p.h b/lib/isc/thread_p.h
index 0fd02a9684a..b31e6c30387 100644
--- a/lib/isc/thread_p.h
+++ b/lib/isc/thread_p.h
@@ -17,6 +17,14 @@
 
 /*! \file */
 
+/*
+ * The current default stack sizes are as follows:
+ * - Linux glibc: 8MB
+ * - Linux musl: 128kB
+ * - FreeBSD: 2MB
+ * - OpenBSD: 512kB
+ * - NetBSD: 4MB
+ */
 #ifndef THREAD_MINSTACKSIZE
 #define THREAD_MINSTACKSIZE (1U * 1024 * 1024)
 #endif /* ifndef THREAD_MINSTACKSIZE */