Module Name: src
Committed By: riastradh
Date: Thu Nov 23 21:30:03 UTC 2023
Modified Files:
src/share/man/man7: stack.7
Log Message:
stack(7): Clarify some wording and diagrams.
PR pkg/57708
XXX pullup-10
To generate a diff of this commit:
cvs rdiff -u -r1.2 -r1.3 src/share/man/man7/stack.7
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man7/stack.7
diff -u src/share/man/man7/stack.7:1.2 src/share/man/man7/stack.7:1.3
--- src/share/man/man7/stack.7:1.2 Thu Nov 23 21:27:08 2023
+++ src/share/man/man7/stack.7 Thu Nov 23 21:30:03 2023
@@ -1,4 +1,4 @@
-.\" $NetBSD: stack.7,v 1.2 2023/11/23 21:27:08 riastradh Exp $
+.\" $NetBSD: stack.7,v 1.3 2023/11/23 21:30:03 riastradh Exp $
.\"
.\" Copyright (c) 2023 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -187,15 +187,15 @@ are defined in
.Ss Non-main threads
Threads created with
.Xr pthread_create 3
-have stacks allocated at dynamically chosen addresses, and cannot be
-resized after creation.
+have stacks allocated at dynamically chosen addresses, and the stacks
+cannot be resized after creation.
On architectures where the stack grows down, the layout is:
.Bd -literal
+--------------------+ stackaddr
+| stack |
| . |
| . | <-- stack pointer (varies during execution)
| . |
-| stack |
+--------------------+ stackaddr - stacksize
| guard/redzone |
+--------------------+ stackaddr - stacksize - guardsize
