2008-10-25 03:03:47 +00:00
|
|
|
.\" Copyright (c) 2008 Linux Foundation, written by Michael Kerrisk
|
|
|
|
.\" <mtk.manpages@gmail.com>
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to make and distribute verbatim copies of this
|
|
|
|
.\" manual provided the copyright notice and this permission notice are
|
|
|
|
.\" preserved on all copies.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
|
.\" manual under the conditions for verbatim copying, provided that the
|
|
|
|
.\" entire resulting derived work is distributed under the terms of a
|
|
|
|
.\" permission notice identical to this one.
|
|
|
|
.\"
|
|
|
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
|
|
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
|
|
|
.\" responsibility for errors or omissions, or for damages resulting from
|
|
|
|
.\" the use of the information contained herein. The author(s) may not
|
|
|
|
.\" have taken the same level of care in the production of this manual,
|
|
|
|
.\" which is licensed free of charge, as they might when working
|
|
|
|
.\" professionally.
|
|
|
|
.\"
|
|
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
|
|
|
.\"
|
2008-11-11 13:35:25 +00:00
|
|
|
.TH PTHREAD_GETATTR_NP 3 2008-11-11 "Linux" "Linux Programmer's Manual"
|
2008-10-25 03:03:47 +00:00
|
|
|
.SH NAME
|
|
|
|
pthread_getattr_np \- get attributes of created thread
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.nf
|
|
|
|
.B #define _GNU_SOURCE
|
|
|
|
.B #include <pthread.h>
|
|
|
|
|
|
|
|
.BI "int pthread_getattr_np(pthread_t " thread ", pthread_attr_t *" attr );
|
|
|
|
.sp
|
|
|
|
Compile and link with \fI\-pthread\fP.
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
|
|
|
.BR pthread_getattr_np ()
|
|
|
|
function initializes the thread attributes object referred to by
|
|
|
|
.I attr
|
|
|
|
so that it contains actual attribute values describing the running thread
|
|
|
|
.IR thread .
|
|
|
|
|
|
|
|
The returned attribute values may differ from
|
|
|
|
the corresponding attribute values passed in the
|
|
|
|
.I attr
|
|
|
|
object that was used to create the thread using
|
|
|
|
.BR pthread_create (3).
|
|
|
|
In particular, the following attributes may differ:
|
|
|
|
.IP * 2
|
|
|
|
the detach state, since a joinable thread may have detached itself
|
|
|
|
after creation;
|
|
|
|
.IP *
|
|
|
|
the stack size,
|
|
|
|
which the implementation may align to a suitable boundary.
|
|
|
|
.IP *
|
|
|
|
and the guard size,
|
|
|
|
which the implementation may round upwards to a multiple of the page size,
|
|
|
|
or ignore (i.e., treat as 0),
|
|
|
|
if the application is allocating its own stack.
|
|
|
|
.PP
|
|
|
|
Furthermore, if the stack address attribute was not set
|
|
|
|
in the thread attributes object used to create the thread,
|
|
|
|
then the returned thread attributes object will report the actual
|
|
|
|
stack address that the implementation selected for the thread.
|
|
|
|
|
|
|
|
When the thread attributes object returned by
|
|
|
|
.BR pthread_getattr_np ()
|
|
|
|
is no longer required, it should be destroyed using
|
|
|
|
.BR pthread_attr_destroy (3).
|
|
|
|
.SH RETURN VALUE
|
|
|
|
On success, this function returns 0;
|
intro.1, time.1, adjtimex.2, capget.2, eventfd.2, fcntl.2, getrlimit.2, getsockopt.2, gettimeofday.2, intro.2, ioctl_list.2, ioperm.2, mlock.2, pivot_root.2, poll.2, prctl.2, ptrace.2, sched_setscheduler.2, select_tut.2, semget.2, sigaltstack.2, signalfd.2, sysctl.2, timer_settime.2, timerfd_create.2, wait.2, CPU_SET.3, argz_add.3, assert_perror.3, atexit.3, backtrace.3, bcmp.3, clearenv.3, ctime.3, dl_iterate_phdr.3, dlopen.3, ecvt.3, errno.3, error.3, ether_aton.3, exit.3, fenv.3, ferror.3, finite.3, flockfile.3, fnmatch.3, fpathconf.3, fpclassify.3, ftime.3, ftok.3, ftw.3, fwide.3, getaddrinfo.3, gethostbyname.3, getlogin.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getrpcent.3, getservent.3, glob.3, hsearch.3, inet.3, isalpha.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, longjmp.3, lsearch.3, malloc.3, matherr.3, mblen.3, mbsinit.3, mbtowc.3, on_exit.3, printf.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_equal.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, ptsname.3, putenv.3, putgrent.3, raise.3, rcmd.3, regex.3, rexec.3, rpc.3, rpmatch.3, rtnetlink.3, scandir.3, sem_init.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, signbit.3, stdio_ext.3, strtod.3, strtol.3, strtoul.3, system.3, termios.3, timeradd.3, tzset.3, ualarm.3, wctomb.3, xdr.3, st.4, tty_ioctl.4, core.5, elf.5, proc.5, bootparam.7, capabilities.7, icmp.7, ip.7, ipv6.7, math_error.7, mdoc.samples.7, mq_overview.7, pthreads.7, raw.7, regex.7, socket.7, tcp.7, tzselect.8: Global fix: s/non-zero/nonzero/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:40:55 +00:00
|
|
|
on error, it returns a nonzero error number.
|
2008-10-25 03:03:47 +00:00
|
|
|
.SH ERRORS
|
|
|
|
.TP
|
|
|
|
.B ENOMEM
|
|
|
|
.\" Can happen (but unlikely) while trying to allocate memory for cpuset
|
|
|
|
Insufficient memory.
|
|
|
|
.PP
|
|
|
|
In addition, if
|
|
|
|
.I thread
|
|
|
|
refers to the main thread, then
|
|
|
|
.BR pthread_getattr_np ()
|
2008-11-18 12:04:59 +00:00
|
|
|
can fail because of errors from various underlying calls:
|
2008-10-25 03:03:47 +00:00
|
|
|
.BR fopen (3),
|
|
|
|
if
|
|
|
|
.IR /proc/self/maps
|
|
|
|
can't be opened;
|
|
|
|
and
|
|
|
|
.BR getrlimit (2),
|
|
|
|
if the
|
|
|
|
.BR RLIMIT_STACK
|
|
|
|
resource limit is not supported.
|
|
|
|
.SH VERSIONS
|
|
|
|
This function is available in glibc since version 2.2.3.
|
|
|
|
.SH CONFORMING TO
|
accept.2, execve.2, futimesat.2, getresuid.2, getrlimit.2, madvise.2, mq_getsetattr.2, msgctl.2, nice.2, open.2, poll.2, setresuid.2, shmctl.2, sigaction.2, times.2, utimensat.2, __setfpucw.3, atoi.3, endian.3, err.3, euidaccess.3, fenv.3, fopencookie.3, fpurge.3, getgrouplist.3, getutmp.3, j0.3, lgamma.3, netlink.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, pthread_yield.3, random_r.3, readdir.3, rtnetlink.3, scanf.3, setenv.3, significand.3, sigsetops.3, strerror.3, strstr.3, sysv_signal.3, termios.3, timegm.3, unlocked_stdio.3, y0.3, locale.5, bootparam.7, feature_test_macros.7, ip.7, locale.7, pthreads.7, rtld-audit.7, nscd.8: Global fix: s/non-standard/nonstandard/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:37:52 +00:00
|
|
|
This function is a nonstandard GNU extension.
|
execve.2, fallocate.2, futex.2, sched_rr_get_interval.2, select_tut.2, shmget.2, timer_getoverrun.2, times.2, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cleanup_push_defer_np.3, pthread_getattr_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, sem_open.3, stdin.3, rtc.4, tty_ioctl.4, unix.7: Global fix: s/non-portable/nonportable/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 16:46:09 +00:00
|
|
|
hence the suffix "_np" (nonportable) in the name.
|
2008-10-25 03:03:47 +00:00
|
|
|
.SH EXAMPLE
|
|
|
|
The program below demonstrates the use of
|
|
|
|
.BR pthread_getattr_np ().
|
|
|
|
The program creates a thread that then uses
|
|
|
|
.BR pthread_getattr_np ()
|
|
|
|
to retrieve and display its guard size, stack address,
|
|
|
|
and stack size attributes.
|
|
|
|
Command-line arguments can be used to set these attributes
|
|
|
|
to values other than the default when creating the thread.
|
|
|
|
The shell sessions below demonstrate the use of the program.
|
|
|
|
|
|
|
|
In the first run, on an x86-32 system,
|
|
|
|
a thread is created using default attributes:
|
|
|
|
|
|
|
|
.in +4n
|
|
|
|
.nf
|
2009-09-27 07:26:35 +00:00
|
|
|
.RB "$" " ulimit \-s" " # No stack limit ==> default stack size is 2MB"
|
2008-10-25 03:03:47 +00:00
|
|
|
unlimited
|
eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-28 15:37:22 +00:00
|
|
|
.RB "$" " ./a.out"
|
2008-10-25 03:03:47 +00:00
|
|
|
Attributes of created thread:
|
|
|
|
Guard size = 4096 bytes
|
|
|
|
Stack address = 0x40196000 (EOS = 0x40397000)
|
|
|
|
Stack size = 0x201000 (2101248) bytes
|
|
|
|
.fi
|
|
|
|
.in
|
|
|
|
|
|
|
|
In the following run, we see that if a guard size is specified,
|
|
|
|
it is rounded up to the next multiple of the system page size
|
|
|
|
(4096 bytes on x86-32):
|
|
|
|
|
|
|
|
.in +4n
|
|
|
|
.nf
|
eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-28 15:37:22 +00:00
|
|
|
.RB "$" " ./a.out \-g 4097"
|
2008-10-25 03:03:47 +00:00
|
|
|
Thread attributes object after initializations:
|
|
|
|
Guard size = 4097 bytes
|
|
|
|
Stack address = (nil)
|
|
|
|
Stack size = 0x0 (0) bytes
|
|
|
|
|
|
|
|
Attributes of created thread:
|
|
|
|
Guard size = 8192 bytes
|
|
|
|
Stack address = 0x40196000 (EOS = 0x40397000)
|
|
|
|
Stack size = 0x201000 (2101248) bytes
|
|
|
|
.fi
|
|
|
|
.in
|
|
|
|
.\".in +4n
|
|
|
|
.\".nf
|
|
|
|
.\"$ ./a.out \-s 0x8000
|
|
|
|
.\"Thread attributes object after initializations:
|
|
|
|
.\" Guard size = 4096 bytes
|
|
|
|
.\" Stack address = 0xffff8000 (EOS = (nil))
|
|
|
|
.\" Stack size = 0x8000 (32768) bytes
|
|
|
|
.\"
|
|
|
|
.\"Attributes of created thread:
|
|
|
|
.\" Guard size = 4096 bytes
|
|
|
|
.\" Stack address = 0x4001e000 (EOS = 0x40026000)
|
|
|
|
.\" Stack size = 0x8000 (32768) bytes
|
|
|
|
.\".fi
|
|
|
|
.\".in
|
|
|
|
|
|
|
|
In the last run, the program manually allocates a stack for the thread.
|
|
|
|
In this case, the guard size attribute is ignored.
|
|
|
|
|
|
|
|
.in +4n
|
|
|
|
.nf
|
eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-28 15:37:22 +00:00
|
|
|
.RB "$" " ./a.out \-g 4096 \-s 0x8000 \-a"
|
2008-10-25 03:03:47 +00:00
|
|
|
Allocated thread stack at 0x804d000
|
|
|
|
|
|
|
|
Thread attributes object after initializations:
|
|
|
|
Guard size = 4096 bytes
|
|
|
|
Stack address = 0x804d000 (EOS = 0x8055000)
|
|
|
|
Stack size = 0x8000 (32768) bytes
|
|
|
|
|
|
|
|
Attributes of created thread:
|
|
|
|
Guard size = 0 bytes
|
|
|
|
Stack address = 0x804d000 (EOS = 0x8055000)
|
|
|
|
Stack size = 0x8000 (32768) bytes
|
|
|
|
.fi
|
|
|
|
.in
|
eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5: global fix: Add ".SS Program source" to EXAMPLE
Add ".SS Program source" to clearly distinguish shell session and
descriptive text from actual program code.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-28 15:51:05 +00:00
|
|
|
.SS Program source
|
eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getaddrinfo.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5: srcfix
s/\.R " "/\\\&/ as a way of getting a blank line after a .SS heading.
(Suggested by Sam Varshavchik <mrsam@courier-mta.com>)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-05 01:42:45 +00:00
|
|
|
\&
|
2008-10-25 03:03:47 +00:00
|
|
|
.nf
|
|
|
|
#define _GNU_SOURCE /* To get pthread_getattr_np() declaration */
|
|
|
|
#include <pthread.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <unistd.h>
|
|
|
|
#include <errno.h>
|
|
|
|
|
2008-11-11 13:35:25 +00:00
|
|
|
#define handle_error_en(en, msg) \\
|
|
|
|
do { errno = en; perror(msg); exit(EXIT_FAILURE); } while (0)
|
2008-10-25 03:03:47 +00:00
|
|
|
|
|
|
|
static void
|
|
|
|
display_stack_related_attributes(pthread_attr_t *attr, char *prefix)
|
|
|
|
{
|
|
|
|
int s;
|
|
|
|
size_t stack_size, guard_size;
|
|
|
|
void *stack_addr;
|
|
|
|
|
|
|
|
s = pthread_attr_getguardsize(attr, &guard_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_getguardsize");
|
2008-10-25 03:03:47 +00:00
|
|
|
printf("%sGuard size = %d bytes\\n", prefix, guard_size);
|
|
|
|
|
|
|
|
s = pthread_attr_getstack(attr, &stack_addr, &stack_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_getstack");
|
2008-10-25 03:03:47 +00:00
|
|
|
printf("%sStack address = %p", prefix, stack_addr);
|
|
|
|
if (stack_size > 0)
|
|
|
|
printf(" (EOS = %p)", (char *) stack_addr + stack_size);
|
|
|
|
printf("\\n");
|
|
|
|
printf("%sStack size = 0x%x (%d) bytes\\n",
|
|
|
|
prefix, stack_size, stack_size);
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
display_thread_attributes(pthread_t thread, char *prefix)
|
|
|
|
{
|
|
|
|
int s;
|
|
|
|
pthread_attr_t attr;
|
|
|
|
|
|
|
|
s = pthread_getattr_np(thread, &attr);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_getattr_np");
|
2008-10-25 03:03:47 +00:00
|
|
|
|
|
|
|
display_stack_related_attributes(&attr, prefix);
|
|
|
|
|
|
|
|
s = pthread_attr_destroy(&attr);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_destroy");
|
2008-10-25 03:03:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
static void * /* Start function for thread we create */
|
|
|
|
thread_start(void *arg)
|
|
|
|
{
|
|
|
|
printf("Attributes of created thread:\\n");
|
|
|
|
display_thread_attributes(pthread_self(), "\\t");
|
|
|
|
|
|
|
|
exit(EXIT_SUCCESS); /* Terminate all threads */
|
|
|
|
}
|
|
|
|
|
|
|
|
static void
|
|
|
|
usage(char *pname, char *msg)
|
|
|
|
{
|
|
|
|
if (msg != NULL)
|
|
|
|
fputs(msg, stderr);
|
|
|
|
fprintf(stderr, "Usage: %s [\-s stack-size [-a]]"
|
|
|
|
" [\-g guard-size]\\n", pname);
|
|
|
|
fprintf(stderr, "\\t\\t\-a means program should allocate stack\\n");
|
|
|
|
exit(EXIT_FAILURE);
|
|
|
|
}
|
|
|
|
|
|
|
|
static pthread_attr_t * /* Get thread attributes from command line */
|
|
|
|
get_thread_attributes_from_cl(int argc, char *argv[],
|
|
|
|
pthread_attr_t *attrp)
|
|
|
|
{
|
|
|
|
int s, opt, allocate_stack;
|
|
|
|
long stack_size, guard_size;
|
|
|
|
void *stack_addr;
|
|
|
|
pthread_attr_t *ret_attrp = NULL; /* Set to attrp if we initialize
|
|
|
|
a thread attributes object */
|
|
|
|
allocate_stack = 0;
|
|
|
|
stack_size = \-1;
|
|
|
|
guard_size = \-1;
|
|
|
|
|
|
|
|
while ((opt = getopt(argc, argv, "ag:s:")) != \-1) {
|
|
|
|
switch (opt) {
|
2008-11-06 16:44:25 +00:00
|
|
|
case \(aqa\(aq: allocate_stack = 1; break;
|
|
|
|
case \(aqg\(aq: guard_size = strtoul(optarg, NULL, 0); break;
|
|
|
|
case \(aqs\(aq: stack_size = strtoul(optarg, NULL, 0); break;
|
2008-10-25 03:03:47 +00:00
|
|
|
default: usage(argv[0], NULL);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (allocate_stack && stack_size == \-1)
|
|
|
|
usage(argv[0], "Specifying \-a without -s makes no sense\\n");
|
|
|
|
|
|
|
|
if (argc > optind)
|
|
|
|
usage(argv[0], "Extraneous command\-line arguments\\n");
|
|
|
|
|
|
|
|
if (stack_size >= 0 || guard_size > 0) {
|
|
|
|
ret_attrp = attrp;
|
|
|
|
|
|
|
|
s = pthread_attr_init(attrp);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_init");
|
2008-10-25 03:03:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if (stack_size >= 0) {
|
|
|
|
if (!allocate_stack) {
|
|
|
|
s = pthread_attr_setstacksize(attrp, stack_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_setstacksize");
|
2008-10-25 03:03:47 +00:00
|
|
|
} else {
|
|
|
|
s = posix_memalign(&stack_addr, sysconf(_SC_PAGESIZE),
|
|
|
|
stack_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "posix_memalign");
|
2008-10-25 03:03:47 +00:00
|
|
|
printf("Allocated thread stack at %p\\n\\n", stack_addr);
|
|
|
|
|
|
|
|
s = pthread_attr_setstack(attrp, stack_addr, stack_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_setstacksize");
|
2008-10-25 03:03:47 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (guard_size >= 0) {
|
|
|
|
s = pthread_attr_setguardsize(attrp, guard_size);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_setstacksize");
|
2008-10-25 03:03:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return ret_attrp;
|
|
|
|
}
|
|
|
|
|
|
|
|
int
|
|
|
|
main(int argc, char *argv[])
|
|
|
|
{
|
|
|
|
int s;
|
|
|
|
pthread_t thr;
|
|
|
|
pthread_attr_t attr;
|
|
|
|
pthread_attr_t *attrp = NULL; /* Set to &attr if we initialize
|
|
|
|
a thread attributes object */
|
|
|
|
|
|
|
|
attrp = get_thread_attributes_from_cl(argc, argv, &attr);
|
|
|
|
|
|
|
|
if (attrp != NULL) {
|
|
|
|
printf("Thread attributes object after initializations:\\n");
|
|
|
|
display_stack_related_attributes(attrp, "\\t");
|
|
|
|
printf("\\n");
|
|
|
|
}
|
|
|
|
|
|
|
|
s = pthread_create(&thr, attrp, &thread_start, NULL);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_create");
|
2008-10-25 03:03:47 +00:00
|
|
|
|
|
|
|
if (attrp != NULL) {
|
|
|
|
s = pthread_attr_destroy(attrp);
|
|
|
|
if (s != 0)
|
2008-11-11 13:35:25 +00:00
|
|
|
handle_error_en(s, "pthread_attr_destroy");
|
2008-10-25 03:03:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
pause(); /* Terminates when other thread calls exit() */
|
|
|
|
}
|
|
|
|
.fi
|
|
|
|
.SH SEE ALSO
|
|
|
|
.BR pthread_attr_getaffinity_np (3),
|
|
|
|
.BR pthread_attr_getdetachstate (3),
|
|
|
|
.BR pthread_attr_getguardsize (3),
|
|
|
|
.BR pthread_attr_getinheritsched (3),
|
|
|
|
.BR pthread_attr_getschedparam (3),
|
|
|
|
.BR pthread_attr_getschedpolicy (3),
|
|
|
|
.BR pthread_attr_getscope (3),
|
|
|
|
.BR pthread_attr_getstack (3),
|
|
|
|
.BR pthread_attr_getstackaddr (3),
|
|
|
|
.BR pthread_attr_getstacksize (3),
|
|
|
|
.BR pthread_attr_init (3),
|
|
|
|
.BR pthread_create (3),
|
|
|
|
.BR pthreads (7)
|