URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [posix-thread-management.html] - Blame information for rev 825

Go to most recent revision | Details | Compare with Previous | View Log


<!-- 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 &#0091;POSIX Section 16&#0093;</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&#0095;attr&#0095;init(pthread&#0095;attr&#0095;t &#0042;attr);
int pthread&#0095;attr&#0095;destroy(pthread&#0095;attr&#0095;t &#0042;attr);
int pthread&#0095;attr&#0095;setdetachstate(pthread&#0095;attr&#0095;t &#0042;attr,
                                int detachstate);
int pthread&#0095;attr&#0095;getdetachstate(const pthread&#0095;attr&#0095;t &#0042;attr,
                                int &#0042;detachstate);
int pthread&#0095;attr&#0095;setstackaddr(pthread&#0095;attr&#0095;t &#0042;attr,
                              void &#0042;stackaddr);
int pthread&#0095;attr&#0095;getstackaddr(const pthread&#0095;attr&#0095;t &#0042;attr,
                              void &#0042;&#0042;stackaddr);
int pthread&#0095;attr&#0095;setstacksize(pthread&#0095;attr&#0095;t &#0042;attr,
                              size&#0095;t stacksize);
int pthread&#0095;attr&#0095;getstacksize(const pthread&#0095;attr&#0095;t &#0042;attr,
                              size&#0095;t &#0042;stacksize);
int pthread&#0095;create( pthread&#0095;t &#0042;thread,
                    const pthread&#0095;attr&#0095;t &#0042;attr,
                    void &#0042;(&#0042;start&#0095;routine)(void &#0042;),
                    void &#0042;arg);
pthread&#0095;t pthread&#0095;self( void );
int pthread&#0095;equal(pthread&#0095;t thread1, pthread&#0095;t thread2);
void pthread&#0095;exit(void &#0042;retval);
int pthread&#0095;join(pthread&#0095;t thread, void &#0042;&#0042;thread&#0095;return);
int pthread&#0095;detach(pthread&#0095;t thread);
int pthread&#0095;once(pthread&#0095;once&#0095;t &#0042;once&#0095;control,
                 void (&#0042;init&#0095;routine)(void));</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN13266">Functions Omitted</H2
><P
>&lt;none&gt;</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&#0095;CREATE&#0095;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&#0095;MEMALLOC&#0095;MALLOC&#0095;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&#0095;STACK&#0095;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&#0095;THREADS&#0095;MAX is supplied by
      the CYGNUM&#0095;POSIX&#0095;PTHREAD&#0095;THREADS&#0095;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&#0095;POSIX&#0095;MAIN&#0095;DEFAULT&#0095;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 &#0091;POSIX Section 15&#0093;</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 &#0091;POSIX Section 17&#0093;</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- Copyright (C) 2003 Red Hat, Inc. -->`
2			`<!-- This material may be distributed only subject to the terms -->`
3			`<!-- and conditions set forth in the Open Publication License, v1.0 -->`
4			`<!-- or later (the latest version is presently available at -->`
5			`<!-- http://www.opencontent.org/openpub/). -->`
6			`<!-- Distribution of the work or derivative of the work in any -->`
7			`<!-- standard (paper) book form is prohibited unless prior -->`
8			`<!-- permission is obtained from the copyright holder. -->`
9			`<HTML`
10			`><HEAD`
11			`><TITLE`
12			`>Thread Management [POSIX Section 16]</TITLE`
13			`><meta name="MSSmartTagsPreventParsing" content="TRUE">`
14			`<META`
15			`NAME="GENERATOR"`
16			`CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+`
17			`"><LINK`
18			`REL="HOME"`
19			`TITLE="eCos Reference Manual"`
20			`HREF="ecos-ref.html"><LINK`
21			`REL="UP"`
22			`TITLE="POSIX Standard Support"`
23			`HREF="posix-standard-support.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="Message Passing [POSIX Section 15]"`
26			`HREF="posix-message-passing.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Thread-Specific Data [POSIX Section 17]"`
29			`HREF="posix-thread-specific-data.html"></HEAD`
30			`><BODY`
31			`CLASS="SECT1"`
32			`BGCOLOR="#FFFFFF"`
33			`TEXT="#000000"`
34			`LINK="#0000FF"`
35			`VLINK="#840084"`
36			`ALINK="#0000FF"`
37			`><DIV`
38			`CLASS="NAVHEADER"`
39			`><TABLE`
40			`SUMMARY="Header navigation table"`
41			`WIDTH="100%"`
42			`BORDER="0"`
43			`CELLPADDING="0"`
44			`CELLSPACING="0"`
45			`><TR`
46			`><TH`
47			`COLSPAN="3"`
48			`ALIGN="center"`
49			`>eCos Reference Manual</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="posix-message-passing.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`>Chapter 31. POSIX Standard Support</TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="posix-thread-specific-data.html"`
72			`ACCESSKEY="N"`
73			`>Next</A`
74			`></TD`
75			`></TR`
76			`></TABLE`
77			`><HR`
78			`ALIGN="LEFT"`
79			`WIDTH="100%"></DIV`
80			`><DIV`
81			`CLASS="SECT1"`
82			`><H1`
83			`CLASS="SECT1"`
84			`><A`
85			`NAME="POSIX-THREAD-MANAGEMENT">Thread Management [POSIX Section 16]</H1`
86			`><DIV`
87			`CLASS="SECT2"`
88			`><H2`
89			`CLASS="SECT2"`
90			`><A`
91			`NAME="AEN13263">Functions Implemented</H2`
92			`><TABLE`
93			`BORDER="5"`
94			`BGCOLOR="#E0E0F0"`
95			`WIDTH="70%"`
96			`><TR`
97			`><TD`
98			`><PRE`
99			`CLASS="SCREEN"`
100			`>int pthread_attr_init(pthread_attr_t *attr);`
101			`int pthread_attr_destroy(pthread_attr_t *attr);`
102			`int pthread_attr_setdetachstate(pthread_attr_t *attr,`
103			`int detachstate);`
104			`int pthread_attr_getdetachstate(const pthread_attr_t *attr,`
105			`int *detachstate);`
106			`int pthread_attr_setstackaddr(pthread_attr_t *attr,`
107			`void *stackaddr);`
108			`int pthread_attr_getstackaddr(const pthread_attr_t *attr,`
109			`void **stackaddr);`
110			`int pthread_attr_setstacksize(pthread_attr_t *attr,`
111			`size_t stacksize);`
112			`int pthread_attr_getstacksize(const pthread_attr_t *attr,`
113			`size_t *stacksize);`
114			`int pthread_create( pthread_t *thread,`
115			`const pthread_attr_t *attr,`
116			`void (start_routine)(void *),`
117			`void *arg);`
118			`pthread_t pthread_self( void );`
119			`int pthread_equal(pthread_t thread1, pthread_t thread2);`
120			`void pthread_exit(void *retval);`
121			`int pthread_join(pthread_t thread, void **thread_return);`
122			`int pthread_detach(pthread_t thread);`
123			`int pthread_once(pthread_once_t *once_control,`
124			`void (*init_routine)(void));</PRE`
125			`></TD`
126			`></TR`
127			`></TABLE`
128			`></DIV`
129			`><DIV`
130			`CLASS="SECT2"`
131			`><H2`
132			`CLASS="SECT2"`
133			`><A`
134			`NAME="AEN13266">Functions Omitted</H2`
135			`><P`
136			`><none></P`
137			`></DIV`
138			`><DIV`
139			`CLASS="SECT2"`
140			`><H2`
141			`CLASS="SECT2"`
142			`><A`
143			`NAME="AEN13269">Notes</H2`
144			`><P`
145			`></P`
146			`><UL`
147			`><LI`
148			`><P`
149			`> The presence of thread support as a whole is controlled by the the`
150			`CYGPKG_POSIX_PTHREAD configuration option. Note that disabling`
151			`this will also disable many other features of the POSIX package,`
152			`since these are intimately bound up with the thread mechanism.`
153			`</P`
154			`></LI`
155			`><LI`
156			`><P`
157			`> The default (non-scheduling) thread attributes are:`
158			`</P`
159			`><TABLE`
160			`BORDER="5"`
161			`BGCOLOR="#E0E0F0"`
162			`WIDTH="70%"`
163			`><TR`
164			`><TD`
165			`><PRE`
166			`CLASS="SCREEN"`
167			`> detachstate PTHREAD_CREATE_JOINABLE`
168			`stackaddr unset`
169			`stacksize unset`
170			`</PRE`
171			`></TD`
172			`></TR`
173			`></TABLE`
174			`></LI`
175			`><LI`
176			`><P`
177			`> Dynamic thread stack allocation is only provided if there is an`
178			`implementation of`
179			`<SPAN`
180			`CLASS="emphasis"`
181			`><I`
182			`CLASS="EMPHASIS"`
183			`>malloc()</I`
184			`></SPAN`
185			`> configured (i.e. a package`
186			`implements the`
187			`CYGINT_MEMALLOC_MALLOC_ALLOCATORS`
188			`interface). If there is no malloc() available, then the thread`
189			`creator must supply a stack. If only a stack address is supplied`
190			`then the stack is assumed to be PTHREAD_STACK_MIN`
191			`bytes long. This size is seldom useful for any but the most`
192			`trivial of threads. If a different sized stack is used, both`
193			`the stack address and stack size must be supplied.`
194			`</P`
195			`></LI`
196			`><LI`
197			`><P`
198			`> The value of PTHREAD_THREADS_MAX is supplied by`
199			`the CYGNUM_POSIX_PTHREAD_THREADS_MAX`
200			`option. This defines the maximum number of threads allowed. The`
201			`POSIX standard requires this value to be at least 64, and this`
202			`is the default value set.`
203			`</P`
204			`></LI`
205			`><LI`
206			`><P`
207			`> When the POSIX package is installed, the thread that calls`
208			`<SPAN`
209			`CLASS="emphasis"`
210			`><I`
211			`CLASS="EMPHASIS"`
212			`>main()</I`
213			`></SPAN`
214			`> is initialized as a POSIX thread. The`
215			`priority of that thread is controlled by the`
216			`CYGNUM_POSIX_MAIN_DEFAULT_PRIORITY option.`
217			`</P`
218			`></LI`
219			`></UL`
220			`></DIV`
221			`></DIV`
222			`><DIV`
223			`CLASS="NAVFOOTER"`
224			`><HR`
225			`ALIGN="LEFT"`
226			`WIDTH="100%"><TABLE`
227			`SUMMARY="Footer navigation table"`
228			`WIDTH="100%"`
229			`BORDER="0"`
230			`CELLPADDING="0"`
231			`CELLSPACING="0"`
232			`><TR`
233			`><TD`
234			`WIDTH="33%"`
235			`ALIGN="left"`
236			`VALIGN="top"`
237			`><A`
238			`HREF="posix-message-passing.html"`
239			`ACCESSKEY="P"`
240			`>Prev</A`
241			`></TD`
242			`><TD`
243			`WIDTH="34%"`
244			`ALIGN="center"`
245			`VALIGN="top"`
246			`><A`
247			`HREF="ecos-ref.html"`
248			`ACCESSKEY="H"`
249			`>Home</A`
250			`></TD`
251			`><TD`
252			`WIDTH="33%"`
253			`ALIGN="right"`
254			`VALIGN="top"`
255			`><A`
256			`HREF="posix-thread-specific-data.html"`
257			`ACCESSKEY="N"`
258			`>Next</A`
259			`></TD`
260			`></TR`
261			`><TR`
262			`><TD`
263			`WIDTH="33%"`
264			`ALIGN="left"`
265			`VALIGN="top"`
266			`>Message Passing [POSIX Section 15]</TD`
267			`><TD`
268			`WIDTH="34%"`
269			`ALIGN="center"`
270			`VALIGN="top"`
271			`><A`
272			`HREF="posix-standard-support.html"`
273			`ACCESSKEY="U"`
274			`>Up</A`
275			`></TD`
276			`><TD`
277			`WIDTH="33%"`
278			`ALIGN="right"`
279			`VALIGN="top"`
280			`>Thread-Specific Data [POSIX Section 17]</TD`
281			`></TR`
282			`></TABLE`
283			`></DIV`
284			`></BODY`
285			`></HTML`
286			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [posix-thread-management.html] - Blame information for rev 825