pthread_attr_getname_np(3) [osf1 man page]
pthread_attr_getname_np(3) Library Functions Manual pthread_attr_getname_np(3) NAME
pthread_attr_getname_np - Obtain the object name attribute in a thread attributes object. LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS
#include <pthread.h> int pthread_attr_getname_np( const pthread_attr_t *attr, char *name, size_t len, void **mbz); PARAMETERS
Address of the thread attributes object whose object name attribute is to be obtained. Location to store the obtained object name. Length in bytes of buffer at the location specified by name. Reserved for future use. The value must be zero (0). DESCRIPTION
This routine copies the object name attribute from the thread attributes object specified by attr to the buffer at the location name. Before calling this routine, your program must allocate the buffer indicated by name. A new thread created using the thread attributes object is initialized with the object name that was set in that attributes object. The object name is a C language string and provides an identifier that is meaningful to a person debugging a DECthreads-based multithreaded application. The maximum number of characters in the object name is 31. If the specified thread attributes object has not been previously set with an object name, this routine copies a C language null string into the buffer at location name. This routine contrasts with pthread_getname_np, which obtains the object name from the thread object for an existing thread. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The value specified by attr is invalid. ERRORS
None RELATED INFORMATION
Functions: pthread_attr_setname_np(3), pthread_getname_np(3), pthread_setname_np(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_attr_getname_np(3)
Check Out this Related Man Page
pthread_attr_setstacksize(3) Library Functions Manual pthread_attr_setstacksize(3) NAME
pthread_attr_setstacksize - Changes the stacksize attribute in the specified thread attributes object. LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS
#include <pthread.h> int pthread_attr_setstacksize( pthread_attr_t *attr, size_t stacksize); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS
Thread attributes object to be modified. New value for the stacksize attribute of the thread attributes object specified by the attr argu- ment. The stacksize argument must be greater than or equal to PTHREAD_STACK_MIN. PTHREAD_STACK_MIN specifies the minimum size (in bytes) of stack needed for a thread. DESCRIPTION
This routine sets the stacksize attribute in the thread attributes object specified by the attr argument. Use this routine to adjust the size of the writable area of the stack for a new thread. The size of a thread's stack is fixed at the time of thread creation. Only the initial thread can dynamically extend its stack. Many compilers do not check for stack overflow. Ensure that the new thread's stack is sufficient for the resources required by routines that are called from the thread. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The value specified by attr is invalid, or the value specified by stacksize is less than PTHREAD_STACK_MIN or exceeds a DECthreads-imposed limit. ERRORS
None RELATED INFORMATION
Functions: pthread_attr_init(3), pthread_attr_getstacksize(3), pthread_create(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_attr_setstacksize(3)