pthread_attr_setguardsize_np

Changes the guardsize attribute of the specified thread attributes object.

Syntax

pthread_attr_setguardsize_np( attr, guardsize );

Argument Data Type Access

attr opaque pthread_attr_t write guardsize size_t read

C Binding


#include 


int
pthread_attr_setguardsize_np (
         pthread_attr_t   *attr,
         size_t   guardsize);

Arguments

attr: Threads attributes object to be modified.
guardsize: New value for the guardsize attribute. The guardsize argument specifies the minimum size (in bytes) of the guard area for the stack of a thread.

Description

This routine sets the minimum size (in bytes) of the guard area for the stack of a thread that is created using the attributes object specified by the attr argument.

A guard area helps to detect stack overflows by preventing memory access beyond the thread's stack. Large guard areas are necessary when threads might allocate large structures on the stack.

The default value is platform dependent, but will always be at least one "hardware protection unit" (at least one page).

Return Values

If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows:

Return Description

0 Successful completion. [EINVAL] The value specified by attr is invalid.

Associated Routines

   pthread_attr_init
   pthread_attr_getguardsize_np