--- /dev/null
+<!-- Copyright (C) 2003 Red Hat, Inc. -->
+<!-- This material may be distributed only subject to the terms -->
+<!-- and conditions set forth in the Open Publication License, v1.0 -->
+<!-- or later (the latest version is presently available at -->
+<!-- http://www.opencontent.org/openpub/). -->
+<!-- Distribution of the work or derivative of the work in any -->
+<!-- standard (paper) book form is prohibited unless prior -->
+<!-- permission is obtained from the copyright holder. -->
+<HTML
+><HEAD
+><TITLE
+>Thread Management [POSIX Section 16]</TITLE
+><meta name="MSSmartTagsPreventParsing" content="TRUE">
+<META
+NAME="GENERATOR"
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
+"><LINK
+REL="HOME"
+TITLE="eCos Reference Manual"
+HREF="ecos-ref.html"><LINK
+REL="UP"
+TITLE="POSIX Standard Support"
+HREF="posix-standard-support.html"><LINK
+REL="PREVIOUS"
+TITLE="Message Passing [POSIX Section 15]"
+HREF="posix-message-passing.html"><LINK
+REL="NEXT"
+TITLE="Thread-Specific Data [POSIX Section 17]"
+HREF="posix-thread-specific-data.html"></HEAD
+><BODY
+CLASS="SECT1"
+BGCOLOR="#FFFFFF"
+TEXT="#000000"
+LINK="#0000FF"
+VLINK="#840084"
+ALINK="#0000FF"
+><DIV
+CLASS="NAVHEADER"
+><TABLE
+SUMMARY="Header navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TH
+COLSPAN="3"
+ALIGN="center"
+>eCos Reference Manual</TH
+></TR
+><TR
+><TD
+WIDTH="10%"
+ALIGN="left"
+VALIGN="bottom"
+><A
+HREF="posix-message-passing.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="80%"
+ALIGN="center"
+VALIGN="bottom"
+>Chapter 31. POSIX Standard Support</TD
+><TD
+WIDTH="10%"
+ALIGN="right"
+VALIGN="bottom"
+><A
+HREF="posix-thread-specific-data.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="POSIX-THREAD-MANAGEMENT">Thread Management [POSIX Section 16]</H1
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN13263">Functions Implemented</H2
+><TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+>int pthread_attr_init(pthread_attr_t *attr);
+int pthread_attr_destroy(pthread_attr_t *attr);
+int pthread_attr_setdetachstate(pthread_attr_t *attr,
+ int detachstate);
+int pthread_attr_getdetachstate(const pthread_attr_t *attr,
+ int *detachstate);
+int pthread_attr_setstackaddr(pthread_attr_t *attr,
+ void *stackaddr);
+int pthread_attr_getstackaddr(const pthread_attr_t *attr,
+ void **stackaddr);
+int pthread_attr_setstacksize(pthread_attr_t *attr,
+ size_t stacksize);
+int pthread_attr_getstacksize(const pthread_attr_t *attr,
+ size_t *stacksize);
+int pthread_create( pthread_t *thread,
+ const pthread_attr_t *attr,
+ void *(*start_routine)(void *),
+ void *arg);
+pthread_t pthread_self( void );
+int pthread_equal(pthread_t thread1, pthread_t thread2);
+void pthread_exit(void *retval);
+int pthread_join(pthread_t thread, void **thread_return);
+int pthread_detach(pthread_t thread);
+int pthread_once(pthread_once_t *once_control,
+ void (*init_routine)(void));</PRE
+></TD
+></TR
+></TABLE
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN13266">Functions Omitted</H2
+><P
+><none></P
+></DIV
+><DIV
+CLASS="SECT2"
+><H2
+CLASS="SECT2"
+><A
+NAME="AEN13269">Notes</H2
+><P
+></P
+><UL
+><LI
+><P
+> The presence of thread support as a whole is controlled by the the
+ CYGPKG_POSIX_PTHREAD configuration option. Note that disabling
+ this will also disable many other features of the POSIX package,
+ since these are intimately bound up with the thread mechanism.
+ </P
+></LI
+><LI
+><P
+> The default (non-scheduling) thread attributes are:
+ </P
+><TABLE
+BORDER="5"
+BGCOLOR="#E0E0F0"
+WIDTH="70%"
+><TR
+><TD
+><PRE
+CLASS="SCREEN"
+> detachstate PTHREAD_CREATE_JOINABLE
+ stackaddr unset
+ stacksize unset
+ </PRE
+></TD
+></TR
+></TABLE
+></LI
+><LI
+><P
+> Dynamic thread stack allocation is only provided if there is an
+ implementation of
+ <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>malloc()</I
+></SPAN
+> configured (i.e. a package
+ implements the
+ CYGINT_MEMALLOC_MALLOC_ALLOCATORS
+ interface). If there is no malloc() available, then the thread
+ creator must supply a stack. If only a stack address is supplied
+ then the stack is assumed to be PTHREAD_STACK_MIN
+ bytes long. This size is seldom useful for any but the most
+ trivial of threads. If a different sized stack is used, both
+ the stack address and stack size must be supplied.
+ </P
+></LI
+><LI
+><P
+> The value of PTHREAD_THREADS_MAX is supplied by
+ the CYGNUM_POSIX_PTHREAD_THREADS_MAX
+ option. This defines the maximum number of threads allowed. The
+ POSIX standard requires this value to be at least 64, and this
+ is the default value set.
+ </P
+></LI
+><LI
+><P
+> When the POSIX package is installed, the thread that calls
+ <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>main()</I
+></SPAN
+> is initialized as a POSIX thread. The
+ priority of that thread is controlled by the
+ CYGNUM_POSIX_MAIN_DEFAULT_PRIORITY option.
+ </P
+></LI
+></UL
+></DIV
+></DIV
+><DIV
+CLASS="NAVFOOTER"
+><HR
+ALIGN="LEFT"
+WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
+WIDTH="100%"
+BORDER="0"
+CELLPADDING="0"
+CELLSPACING="0"
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+><A
+HREF="posix-message-passing.html"
+ACCESSKEY="P"
+>Prev</A
+></TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="ecos-ref.html"
+ACCESSKEY="H"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+><A
+HREF="posix-thread-specific-data.html"
+ACCESSKEY="N"
+>Next</A
+></TD
+></TR
+><TR
+><TD
+WIDTH="33%"
+ALIGN="left"
+VALIGN="top"
+>Message Passing [POSIX Section 15]</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="posix-standard-support.html"
+ACCESSKEY="U"
+>Up</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>Thread-Specific Data [POSIX Section 17]</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
\ No newline at end of file