2 .\" Copyright (c) 2003 Bruce M Simpson <bms@spc.org>
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .Nd manage process stacks
41 .Fa "vm_map_t map" "vm_offset_t addrbos" "vm_size_t max_ssize" "vm_prot_t prot"
42 .Fa "vm_prot_t max" "int cow"
45 .Fn vm_map_growstack "struct proc *p" "vm_offset_t addr"
49 function maps a process stack for a new process image.
54 with a maximum size of
56 Copy-on-write flags passed in
58 are also applied to the new mapping.
59 Protection bits are supplied by
64 It is typically called by
69 function is responsible for growing a stack for the process
71 to the desired address
76 .Sh IMPLEMENTATION NOTES
81 to create its mappings.
87 functions acquire the process lock on
89 for the duration of the call.
95 if the mapping was allocated successfully.
98 if mapping the stack would exceed the process's VMEM resource limit,
99 or if the specified bottom-of-stack address is out of range for the map,
100 or if there is already a mapping at the address which would result,
103 could not be accommodated within the current mapping,
107 Other possible return values for this function are documented in
108 .Xr vm_map_insert 9 .
116 is already mapped, or if the stack was grown successfully.
122 is outside the stack range; this is done in order to preserve
123 compatibility with the deprecated
125 function previously located in the file
131 This manual page was written by
132 .An Bruce M Simpson Aq bms@spc.org .