*** UNIX MANUAL PAGE BROWSER ***

A Nergahak database for man pages research.

Navigation

Directory Browser

1Browse 4.4BSD4.4BSD
1Browse Digital UNIXDigital UNIX 4.0e
1Browse FreeBSDFreeBSD 14.3
1Browse MINIXMINIX 3.4.0rc6-d5e4fc0
1Browse NetBSDNetBSD 10.1
1Browse OpenBSDOpenBSD 7.7
1Browse UNIX v7Version 7 UNIX
1Browse UNIX v10Version 10 UNIX

Manual Page Search

Manual Page Result

0 Command: pthread_attr_setguardsize_np | Section: 3 | Source: Digital UNIX | File: pthread_attr_setguardsize_np.3.gz
pthread_at...ardsize_np(3) Library Functions Manual pthread_at...ardsize_np(3) NAME pthread_attr_setguardsize_np - Changes the guardsize attribute of the specified thread attributes object. LIBRARY DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS #include <pthread.h> int pthread_attr_setguardsize_np( pthread_attr_t *attr, size_t guardsize); STANDARDS None PARAMETERS Address of the thread attributes object whose guardsize attribute is to be modified. New value for the guardsize attribute of the thread at- tributes object specified by attr. DESCRIPTION This routine uses the value specified in the guardsize argument to set the guardsize attribute of the thread attributes object specified in the attr argument. When creating a thread, use a thread attributes object to specify non- default values for thread attributes. The guardsize attribute of a thread attributes object specifies the minimum size (in bytes) of the guard area for the stack of a new thread. A guard area can help a multithreaded program detect overflow of a thread's stack. A guard area is a region of no-access memory that DEC- threads allocates at the overflow end of the thread's stack. When any thread attempts to access a memory location within this region, a mem- ory addressing violation occurs. A new thread can be created with a default guardsize attribute value. This value is platform dependent, but will always be at least one "hardware protection unit" (that is, at least one page). For more in- formation, see the platform-specific appendixes of Guide to DECthreads. After this routine is called, due to platform-specific factors DEC- threads might reserve a larger guard area for the new thread than was specified in the guardsize argument. For more information, see the platform-specific appendixes of Guide to DECthreads. DECthreads allows your program to specify the size of a thread stack's guard area for two reasons: When a thread allocates large data struc- tures on its stack, a guard area with a size greater than the default size might be required to detect stack overflow. Overflow protection of a thread's stack can potentially waste system resources, such as for an application that creates a large number of threads that will never overflow their stacks. Your multithreaded program can conserve system resources by "turning off" a thread's stack guard area--that is, by specifying a guardsize attribute of zero. If a thread is created using a thread attributes object whose stackaddr attribute is set (using the pthread_attr_setstackaddr(3) routine), this routine ignores the ob- ject's guardsize attribute and provides no thread stack guard area for the new thread. NOTES This routine has been superseded by the pthread_attr_setguardsize(3) routine, as specified by the Single UNIX Specification, Version 2. RETURN VALUES If an error condition occurs, this routine returns an integer value in- dicating the type of error. Possible return values are as follows: Successful completion. The argument attr is invalid, or the argument guardsize contains an invalid value. ERRORS None RELATED INFORMATION Functions: pthread_attr_init(3), pthread_attr_getguardsize_np(3), pthread_attr_setstacksize(3), pthread_create(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_at...ardsize_np(3)

Navigation Options