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  -  NEEDSTACK (3)

NAME

needstack - check for execution stack overflow

CONTENTS

Synopsis
Description
Example
Source
See Also

SYNOPSIS

#include <u.h>

#include <libc.h>

int     needstack(int n)

DESCRIPTION

Stack overflow in the thread library leads to bugs that are difficult to diagnose. The Plan 9 libraries are careful about not allocating large structures on the stack, so typically four or eight kilobytes is plenty of stack for a thread. Other libraries are not always as careful. Calling needstack indicates to the thread library that an external routine is about to be called that will require n bytes of stack space. If there is not enough space left on the stack, the thread library prints an error and terminates the program. The call needstack(0) can be used to check whether the stack is currently overflowed.

Needstack is defined in libc.h so that library functions used in threaded and non-threaded contexts can call it. The implementation of needstack in lib9 is a no-op.

Needstack should be thought of as a comment checked at run time, like assert(3).

EXAMPLE

The X Window library implementation of XLookupString allocates some very large buffers on the stack, so /usr/local/plan9/src/libdraw/x11-itrans.c calls needstack(20*1024) before making calls to XLookupString. If a thread (in this case, the keyboard-reading thread used inside the draw(3) library) does not allocate a large enough stack, the problem is diagnosed immediately rather than left to corrupt memory.

SOURCE

/usr/local/plan9/src/lib9/needstack.c
/usr/local/plan9/src/libthread

SEE ALSO

thread(3)
Search for    or go to Top of page |  Section 3 |  Main Index


NEEDSTACK (3) -->

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