GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VM_MAP_STACK (9)

NAME

vm_map_stack, vm_map_growstack - manage process stacks

CONTENTS

Synopsis
Description
Implementation Notes
Return Values
See Also
Authors

SYNOPSIS


.In sys/param.h
.In vm/vm.h
.In vm/vm_map.h int
.Fo vm_map_stack vm_map_t map vm_offset_t addrbos vm_size_t max_ssize vm_prot_t prot vm_prot_t max int cow
.Fc int vm_map_growstack struct proc *p vm_offset_t addr

DESCRIPTION

The vm_map_stack function maps a process stack for a new process image. The stack is mapped addrbos in map, with a maximum size of max_ssize. Copy-on-write flags passed in cow are also applied to the new mapping. Protection bits are supplied by prot and max.

It is typically called by execve(2).

The vm_map_growstack function is responsible for growing a stack for the process p to the desired address addr, similar to the legacy sbrk(2) call.

IMPLEMENTATION NOTES

The vm_map_stack function calls vm_map_insert(9) to create its mappings.

The vm_map_stack and vm_map_growstack functions acquire the process lock on p for the duration of the call.

RETURN VALUES

The vm_map_stack function returns KERN_SUCCESS if the mapping was allocated successfully.

Otherwise, if mapping the stack would exceed the process’s VMEM resource limit, or if the specified bottom-of-stack address is out of range for the map, or if there is already a mapping at the address which would result, or if max_ssize could not be accommodated within the current mapping, KERN_NO_SPACE is returned.

Other possible return values for this function are documented in vm_map_insert(9).

The vm_map_growstack function returns KERN_SUCCESS if addr is already mapped, or if the stack was grown successfully.

It also returns KERN_SUCCESS if addr is outside the stack range; this is done in order to preserve compatibility with the deprecated grow function previously located in the file vm_machdep.c.

SEE ALSO

vm_map(9), vm_map_insert(9)

AUTHORS

This manual page was written by
.An Bruce M Simpson Aq bms@spc.org .
Search for    or go to Top of page |  Section 9 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.