.\" $OpenBSD: pthread_attr_setstackaddr.3,v 1.10 2008/12/18 09:30:32 guenther Exp $
.\" Manual page derived from TOG's UNIX98 documentation.
.\"
.\"  David Leonard, 2000. Public Domain.
.\"
.Dd $Mdocdate: December 18 2008 $
.Dt PTHREAD_ATTR_SETSTACKADDR 3
.Os
.Sh NAME
.Nm pthread_attr_setstackaddr ,
.Nm pthread_attr_getstackaddr
.Nd set and get stackaddr attribute
.Sh SYNOPSIS
.Fd #include <pthread.h>
.Ft int
.Fn pthread_attr_setstackaddr "pthread_attr_t *attr" "void *stackaddr"
.Ft int
.Fn pthread_attr_getstackaddr "const pthread_attr_t *attr" "void **stackaddr"
.Sh DESCRIPTION
The functions
.Fn pthread_attr_setstackaddr
and
.Fn pthread_attr_getstackaddr ,
respectively, set and get the thread
creation
.Va stackaddr
attribute in the
.Fa attr
object.
.Pp
The
.Va stackaddr
attribute specifies the location of storage to be
used for the created thread's stack.
The size of the storage is at least
.Dv PTHREAD_STACK_MIN .
.Sh RETURN VALUES
Upon successful completion,
.Fn pthread_attr_setstackaddr
and
.Fn pthread_attr_getstackaddr
return a value of 0.
Otherwise, an error number is returned to indicate the error.
.Pp
The
.Fn pthread_attr_getstackaddr
function stores the
.Va stackaddr
attribute value in
.Fa stackaddr
if successful.
.Sh ERRORS
No errors are defined.
.Pp
These functions will not return an error code of
.Bq Er EINTR .
.Sh SEE ALSO
.Xr pthread_attr_init 3 ,
.Xr pthread_attr_setdetachstate 3 ,
.Xr pthread_attr_setguardsize 3 ,
.Xr pthread_attr_setstack 3 ,
.Xr pthread_attr_setstacksize 3 ,
.Xr pthread_create 3 ,
.Xr pthreads 3
.Sh STANDARDS
.Fn pthread_attr_setstackaddr
and
.Fn pthread_attr_getstackaddr
conform to ISO/IEC 9945-1 ANSI/IEEE
.Pq Dq Tn POSIX
Std 1003.1 Second Edition 1996-07-12.