Mirrors_Framework/nuttx
1
0
Fork 0
mirror of https://github.com/apache/nuttx.git synced 2026-05-28 11:56:10 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Add task_setcancelstate()

Browse Source
This commit is contained in:
Gregory Nutt
2016-12-10 15:16:46 -06:00
parent 698597a838
commit 5fb207eb36
9 changed files with 156 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Documentation/NuttxUserGuide.html
+103 -48
View File
@@ -203,49 +203,51 @@ paragraphs.
<li><a href="#taskactivate">2.1.3 task_activate</a></li> <li><a href="#taskactivate">2.1.3 task_activate</a></li>
<li><a href="#taskdelete">2.1.4 task_delete</a></li> <li><a href="#taskdelete">2.1.4 task_delete</a></li>
<li><a href="#taskrestart">2.1.5 task_restart</a></li> <li><a href="#taskrestart">2.1.5 task_restart</a></li>
<li><a href="#tasksetcancelstate">2.1.6 task_setcancelstate</a></li>
</ul> </ul>
<p> <p>
Standard interfaces Standard interfaces
</p> </p>
<ul> <ul>
<li><a href="#exit">2.1.6 exit</a></li> <li><a href="#exit">2.1.7 exit</a></li>
<li><a href="#getpid">2.1.7 getpid</a></li> <li><a href="#getpid">2.1.8 getpid</a></li>
</ul> </ul>
<p> <p>
Standard <code>vfork</code> and <code>exec[v|l]</code> interfaces: Standard <code>vfork</code> and <code>exec[v|l]</code> interfaces:
</p> </p>
<ul> <ul>
<li><a href="#vfork">2.1.8 vfork</a></li> <li><a href="#vfork">2.1.9 vfork</a></li>
<li><a href="#execv">2.1.9 execv</a></li> <li><a href="#execv">2.1.10 execv</a></li>
<li><a href="#execl">2.1.10 execl</a></li> <li><a href="#execl">2.1.11 execl</a></li>
</ul> </ul>
<p> <p>
Standard <code>posix_spawn</code> interfaces: Standard <code>posix_spawn</code> interfaces:
</p> </p>
<ul> <ul>
<li><a href="#posix_spawn">2.1.11 posix_spawn and posix_spawnp</a></li> <li><a href="#posix_spawn">2.1.12 posix_spawn and posix_spawnp</a></li>
<li><a href="#posix_spawn_file_actions_init">2.1.12 posix_spawn_file_actions_init</a></li> <li><a href="#posix_spawn_file_actions_init">2.1.13 posix_spawn_file_actions_init</a></li>
<li><a href="#posix_spawn_file_actions_destroy">2.1.13 posix_spawn_file_actions_destroy</a></li> <li><a href="#posix_spawn_file_actions_destroy">2.1.14 posix_spawn_file_actions_destroy</a></li>
<li><a href="#posix_spawn_file_actions_addclose">2.1.14 posix_spawn_file_actions_addclose</a></li> <li><a href="#posix_spawn_file_actions_addclose">2.1.15 posix_spawn_file_actions_addclose</a></li>
<li><a href="#posix_spawn_file_actions_adddup2">2.1.15 posix_spawn_file_actions_adddup2</a></li> <li><a href="#posix_spawn_file_actions_adddup2">2.1.16 posix_spawn_file_actions_adddup2</a></li>
<li><a href="#posix_spawn_file_actions_addopen">2.1.16 posix_spawn_file_actions_addopen</a></li> <li><a href="#posix_spawn_file_actions_addopen">2.1.17 posix_spawn_file_actions_addopen</a></li>
<li><a href="#posix_spawnattr_init">2.1.17 posix_spawnattr_init</a></li> <li><a href="#posix_spawnattr_init">2.1.18 posix_spawnattr_init</a></li>
<li><a href="#posix_spawnattr_getflags">2.1.18 posix_spawnattr_getflags</a></li> <li><a href="#posix_spawnattr_getflags">2.1.19 posix_spawnattr_getflags</a></li>
<li><a href="#posix_spawnattr_getschedparam">2.1.19 posix_spawnattr_getschedparam</a></li> <li><a href="#posix_spawnattr_getschedparam">2.1.20 posix_spawnattr_getschedparam</a></li>
<li><a href="#posix_spawnattr_getschedpolicy">2.1.20 posix_spawnattr_getschedpolicy</a></li> <li><a href="#posix_spawnattr_getschedpolicy">2.1.21 posix_spawnattr_getschedpolicy</a></li>
<li><a href="#posix_spawnattr_getsigmask">2.1.21 posix_spawnattr_getsigmask</a></li> <li><a href="#posix_spawnattr_getsigmask">2.1.22 posix_spawnattr_getsigmask</a></li>
<li><a href="#posix_spawnattr_setflags">2.1.22 posix_spawnattr_setflags</a></li> <li><a href="#posix_spawnattr_setflags">2.1.23 posix_spawnattr_setflags</a></li>
<li><a href="#posix_spawnattr_setschedparam">2.1.23 posix_spawnattr_setschedparam</a></li> <li><a href="#posix_spawnattr_setschedparam">2.1.24 posix_spawnattr_setschedparam</a></li>
<li><a href="#posix_spawnattr_setschedpolicy">2.1.24 posix_spawnattr_setschedpolicy</a></li> <li><a href="#posix_spawnattr_setschedpolicy">2.1.25 posix_spawnattr_setschedpolicy</a></li>
<li><a href="#posix_spawnattr_setsigmask">2.1.25 posix_spawnattr_setsigmask</a></li> <li><a href="#posix_spawnattr_setsigmask">2.1.26 posix_spawnattr_setsigmask</a></li>
</ul> </ul>
<p> <p>
Non-standard task control interfaces inspired by <code>posix_spawn</code>: Non-standard task control interfaces inspired by <code>posix_spawn</code>:
</p> </p>
<ul> <ul>
<li><a href="#task_spawn">2.1.26 task_spawn</a></li> <li><a href="#task_spawn">2.1.27 task_spawn</a></li>
<li><a href="#task_spawnattr_getstacksize">2.1.27 task_spawnattr_getstacksize</a></li> <li><a href="#task_spawnattr_getstacksize">2.1.28 task_spawnattr_getstacksize</a></li>
<li><a href="#task_spawnattr_setstacksize">2.1.28 task_spawnattr_setstacksize</a></li> <li><a href="#task_spawnattr_setstacksize">2.1.29 task_spawnattr_setstacksize</a></li>
<li><a href="#posix_spawn_file_actions_init">2.1.30 posix_spawn_file_actions_init</a></li>
</ul> </ul>
<H3><a name="taskcreate">2.1.1 task_create</a></H3> <H3><a name="taskcreate">2.1.1 task_create</a></H3>
@@ -597,7 +599,59 @@ VxWorks provides the following similar interface:
</li> </li>
</ul> </ul>
<H3><a name="exit">2.1.6 exit</a></H3> <H3><a name="tasksetcancelstate">2.1.6 task_setcancelstate</a></H3>
<p>
<b>Function Prototype:</b>
<p>
<pre>
#include &lt;sched.h&gt;
int task_setcancelstate(int state, int *oldstate);
</pre>
<p>
<b>Description:</b>
</p>
<p>
The <code>task_setcancelstate()</code> function atomically
sets both the calling task's cancelability state to the indicated
state and returns the previous cancelability state at the location
referenced by oldstate.
Legal values for state are TASK_CANCEL_ENABLE and TASK_CANCEL_DISABLE.
</p>
<p>
Any pending thread cancellation may occur at the time that the
cancellation state is set to TASK_CANCEL_ENABLE.
</p>
<p>
The cancelability state and type of any newly created tasks are TASK_CANCEL_ENABLE and TASK_CANCEL_DEFERRED respectively.
<p>
<b>Input Parameters:</b>
</p>
<p>
<ul>
<li><code>state</code>
New cancellation state. One of PTHREAD_CANCEL_ENABLE or PTHREAD_CANCEL_DISABLE.</li>
<li><code>oldstate</code>.
Location to return the previous cancellation state.
</ul>
</p>
<p>
<b>Returned Value:</b>
</p>
<p>
Zero (<code>OK</code>) on success; <code>ERROR</code> is returned on any failure with the <code>errno</code> value set appropriately:
</p>
<p>
<ul>
<li><code>ESRCH</code>.
No thread could be found corresponding to that specified by the given thread ID.</li>
</ul>
</p>
<b>Assumptions/Limitations:</b>
<p>
<b>POSIX Compatibility:</b> This is a non-standard interface. It extends the functionality of <code>pthread_setcancelstate()</code> to tasks and supports use of <code>task_delete</code>.
</p>
<H3><a name="exit">2.1.7 exit</a></H3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
@@ -643,7 +697,7 @@ And the UNIX interface:
<li>The <code>code</code> parameter is ignored. <li>The <code>code</code> parameter is ignored.
</ul> </ul>
<H3><a name="getpid">2.1.7 getpid</a></H3> <H3><a name="getpid">2.1.8 getpid</a></H3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
@@ -671,7 +725,7 @@ level.
Compatible with the POSIX interface of the same name. Compatible with the POSIX interface of the same name.
</p> </p>
<H3><a name="vfork">2.1.8 vfork</a></H3> <H3><a name="vfork">2.1.9 vfork</a></H3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -705,7 +759,7 @@ pid_t vfork(void);
Compatible with the Unix interface of the same name. Compatible with the Unix interface of the same name.
</p> </p>
<H3><a name="execv">2.1.9 execv</a></H3> <H3><a name="execv">2.1.10 execv</a></H3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -791,7 +845,7 @@ int execv(FAR const char *path, FAR char *const argv[]);
There are, however, several compatibility issues as detailed in the description above. There are, however, several compatibility issues as detailed in the description above.
</p> </p>
<H3><a name="execl">2.1.10 execl</a></H3> <H3><a name="execl">2.1.11 execl</a></H3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -835,7 +889,7 @@ int execl(FAR const char *path, ...);
There are, however, several compatibility issues as detailed in the description of <a href="#execv">execv()</a>. There are, however, several compatibility issues as detailed in the description of <a href="#execv">execv()</a>.
</p> </p>
<h3><a name="posix_spawn">2.1.11 posix_spawn and posix_spawnp</a></h3> <h3><a name="posix_spawn">2.1.12 posix_spawn and posix_spawnp</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -978,7 +1032,7 @@ int posix_spawnp(FAR pid_t *pid, FAR const char *file,
For the caller of <code>posix_spawn()</code>, the provided argv[0] will correspond to <code>argv[1]</code> received by the new task. For the caller of <code>posix_spawn()</code>, the provided argv[0] will correspond to <code>argv[1]</code> received by the new task.
</p> </p>
<h3><a name="posix_spawn_file_actions_init">2.1.12 posix_spawn_file_actions_init</a></h3> <h3><a name="posix_spawn_file_actions_init">2.1.13 posix_spawn_file_actions_init</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1004,7 +1058,7 @@ int posix_spawn_file_actions_init(FAR posix_spawn_file_actions_t *file_actions);
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>. On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>.
<p> <p>
<h3><a name="posix_spawn_file_actions_destroy">2.1.13 posix_spawn_file_actions_destroy</a></h3> <h3><a name="posix_spawn_file_actions_destroy">2.1.14 posix_spawn_file_actions_destroy</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1031,7 +1085,7 @@ int posix_spawn_file_actions_destroy(FAR posix_spawn_file_actions_t *file_action
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
<p> <p>
<h3><a name="posix_spawn_file_actions_addclose">2.1.14 posix_spawn_file_actions_addclose</a></h3> <h3><a name="posix_spawn_file_actions_addclose">2.1.15 posix_spawn_file_actions_addclose</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1062,7 +1116,7 @@ int posix_spawn_file_actions_addclose(FAR posix_spawn_file_actions_t *file_actio
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawn_file_actions_adddup2">2.1.15 posix_spawn_file_actions_adddup2</a></h3> <h3><a name="posix_spawn_file_actions_adddup2">2.1.16 posix_spawn_file_actions_adddup2</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1099,7 +1153,7 @@ int posix_spawn_file_actions_adddup2(FAR posix_spawn_file_actions_t *file_action
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawn_file_actions_addopen">2.1.16 posix_spawn_file_actions_addopen</a></h3> <h3><a name="posix_spawn_file_actions_addopen">2.1.17 posix_spawn_file_actions_addopen</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1144,7 +1198,7 @@ int posix_spawn_file_actions_addopen(FAR posix_spawn_file_actions_t *file_action
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_init">2.1.17 posix_spawnattr_init</a></h3> <h3><a name="posix_spawnattr_init">2.1.18 posix_spawnattr_init</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1180,7 +1234,7 @@ int posix_spawnattr_init(FAR posix_spawnattr_t *attr);
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_getflags">2.1.18 posix_spawnattr_getflags</a></h3> <h3><a name="posix_spawnattr_getflags">2.1.19 posix_spawnattr_getflags</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1210,7 +1264,7 @@ int posix_spawnattr_getflags(FAR const posix_spawnattr_t *attr, FAR short *flags
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_getschedparam">2.1.19 posix_spawnattr_getschedparam</a></h3> <h3><a name="posix_spawnattr_getschedparam">2.1.20 posix_spawnattr_getschedparam</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1240,7 +1294,7 @@ int posix_spawnattr_getschedparam(FAR const posix_spawnattr_t *attr, FAR struct
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_getschedpolicy">2.1.20 posix_spawnattr_getschedpolicy</a></h3> <h3><a name="posix_spawnattr_getschedpolicy">2.1.21 posix_spawnattr_getschedpolicy</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1270,7 +1324,7 @@ int posix_spawnattr_getschedpolicy(FAR const posix_spawnattr_t *attr, FAR int *p
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_getsigmask">2.1.21 posix_spawnattr_getsigmask</a></h3> <h3><a name="posix_spawnattr_getsigmask">2.1.22 posix_spawnattr_getsigmask</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1302,7 +1356,7 @@ int posix_spawnattr_getsigmask(FAR const posix_spawnattr_t *attr, FAR sigset_t *
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_setflags">2.1.22 posix_spawnattr_setflags</a></h3> <h3><a name="posix_spawnattr_setflags">2.1.23 posix_spawnattr_setflags</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1332,7 +1386,7 @@ int posix_spawnattr_setflags(FAR posix_spawnattr_t *attr, short flags);
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_setschedparam">2.1.23 posix_spawnattr_setschedparam</a></h3> <h3><a name="posix_spawnattr_setschedparam">2.1.24 posix_spawnattr_setschedparam</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1362,7 +1416,7 @@ int posix_spawnattr_setschedparam(FAR posix_spawnattr_t *attr, FAR const struct
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_setschedpolicy">2.1.24 posix_spawnattr_setschedpolicy</a></h3> <h3><a name="posix_spawnattr_setschedpolicy">2.1.25 posix_spawnattr_setschedpolicy</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1392,7 +1446,7 @@ int posix_spawnattr_setschedpolicy(FAR posix_spawnattr_t *attr, int policy);
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawnattr_setsigmask">2.1.25 posix_spawnattr_setsigmask</a></h3> <h3><a name="posix_spawnattr_setsigmask">2.1.26 posix_spawnattr_setsigmask</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1424,7 +1478,7 @@ int posix_spawnattr_setsigmask(FAR posix_spawnattr_t *attr, FAR const sigset_t *
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="task_spawn">2.1.26 task_spawn</a></h3> <h3><a name="task_spawn">2.1.27 task_spawn</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1538,7 +1592,7 @@ int task_spawn(FAR pid_t *pid, FAR const char *name, main_t entry,
This is a non-standard interface inspired by <code>posix_spawn()</code>. This is a non-standard interface inspired by <code>posix_spawn()</code>.
</p> </p>
<h3><a name="task_spawnattr_getstacksize">2.1.26 task_spawnattr_getstacksize</a></h3> <h3><a name="task_spawnattr_getstacksize">2.1.28 task_spawnattr_getstacksize</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1568,7 +1622,7 @@ int task_spawnattr_getstacksize(FAR const posix_spawnattr_t *attr, FAR size_t *s
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="task_spawnattr_setstacksize">2.1.26 task_spawnattr_setstacksize</a></h3> <h3><a name="task_spawnattr_setstacksize">2.1.29 task_spawnattr_setstacksize</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -1598,7 +1652,7 @@ int task_spawnattr_setstacksize(FAR posix_spawnattr_t *attr, size_t stacksize);
On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code> On success, this function returns 0; on failure it will return an error number from <code>&lt;errno.h&gt;</code>
</p> </p>
<h3><a name="posix_spawn_file_actions_init">2.1.12 posix_spawn_file_actions_init</a></h3> <h3><a name="posix_spawn_file_actions_init">2.1.30 posix_spawn_file_actions_init</a></h3>
<p> <p>
<b>Function Prototype:</b> <b>Function Prototype:</b>
</p> </p>
@@ -10194,10 +10248,10 @@ notify a task when a message is available on a queue.
<li><a href="#pthreadonce">pthread_once</a></li> <li><a href="#pthreadonce">pthread_once</a></li>
<li><a href="#pthreadself">pthread_self</a></li> <li><a href="#pthreadself">pthread_self</a></li>
<li><a href="#pthreadsetcancelstate">pthread_setcancelstate</a></li> <li><a href="#pthreadsetcancelstate">pthread_setcancelstate</a></li>
<li><a href="#pthreadsetcanceltype">pthread_setcanceltype</a></li>
<li><a href="#pthreadsetschedparam">pthread_setschedparam</a></li> <li><a href="#pthreadsetschedparam">pthread_setschedparam</a></li>
<li><a href="#pthreadsetspecific">pthread_setspecific</a></li> <li><a href="#pthreadsetspecific">pthread_setspecific</a></li>
<li><a href="#pthreadsigmask">pthread_sigmask</a></li> <li><a href="#pthreadsigmask">pthread_sigmask</a></li>
<li><a href="#pthreadsetcanceltype">pthread_setcanceltype</a></li>
<li><a href="#pthreadtestcancel">pthread_testcancel</a></li> <li><a href="#pthreadtestcancel">pthread_testcancel</a></li>
<li><a href="#pthreadyield">pthread_yield</a></li> <li><a href="#pthreadyield">pthread_yield</a></li>
<li><a href="#standardio">puts</a></li> <li><a href="#standardio">puts</a></li>
@@ -10268,6 +10322,7 @@ notify a task when a message is available on a queue.
<li><a href="#taskinit">task_init</a></li> <li><a href="#taskinit">task_init</a></li>
<li><a href="#taskrestart">task_restart</a></li> <li><a href="#taskrestart">task_restart</a></li>
<li><a href="#Task_Schedule">Task Scheduling Interfaces</a> <li><a href="#Task_Schedule">Task Scheduling Interfaces</a>
<li><a href="#tasksetcancelstate">task_setcancelstate</a></li>
<li><a href="#task_spawn">task_spawn</a></li> <li><a href="#task_spawn">task_spawn</a></li>
<li><a href="#task_spawnattr_getstacksize">task_spawnattr_getstacksize</a></li> <li><a href="#task_spawnattr_getstacksize">task_spawnattr_getstacksize</a></li>
<li><a href="#task_spawnattr_setstacksize">task_spawnattr_setstacksize</a></li> <li><a href="#task_spawnattr_setstacksize">task_spawnattr_setstacksize</a></li>
include/sched.h
+2
View File
@@ -229,6 +229,8 @@ int task_create(FAR const char *name, int priority, int stack_size,
int task_delete(pid_t pid); int task_delete(pid_t pid);
int task_restart(pid_t pid); int task_restart(pid_t pid);
int task_setcancelstate(int state, FAR int *oldstate);
/* Task Scheduling Interfaces (based on POSIX APIs) */ /* Task Scheduling Interfaces (based on POSIX APIs) */
int sched_setparam(pid_t pid, const struct sched_param *param); int sched_setparam(pid_t pid, const struct sched_param *param);
include/sys/syscall.h
+11 -11
View File
@@ -128,8 +128,9 @@
# define SYS_task_delete __SYS_task_delete # define SYS_task_delete __SYS_task_delete
# define SYS_task_restart (__SYS_task_delete+1) # define SYS_task_restart (__SYS_task_delete+1)
# define SYS_up_assert (__SYS_task_delete+2) # define SYS_task_setcancelstate (__SYS_task_delete+2)
# define __SYS_vfork (__SYS_task_delete+3) # define SYS_up_assert (__SYS_task_delete+3)
# define __SYS_vfork (__SYS_task_delete+4)
/* The following can be individually enabled */ /* The following can be individually enabled */
@@ -400,18 +401,17 @@
# define SYS_pthread_mutex_trylock (__SYS_pthread+20) # define SYS_pthread_mutex_trylock (__SYS_pthread+20)
# define SYS_pthread_mutex_unlock (__SYS_pthread+21) # define SYS_pthread_mutex_unlock (__SYS_pthread+21)
# define SYS_pthread_once (__SYS_pthread+22) # define SYS_pthread_once (__SYS_pthread+22)
# define SYS_pthread_setcancelstate (__SYS_pthread+23) # define SYS_pthread_setschedparam (__SYS_pthread+23)
# define SYS_pthread_setschedparam (__SYS_pthread+24) # define SYS_pthread_setschedprio (__SYS_pthread+24)
# define SYS_pthread_setschedprio (__SYS_pthread+25) # define SYS_pthread_setspecific (__SYS_pthread+25)
# define SYS_pthread_setspecific (__SYS_pthread+26) # define SYS_pthread_yield (__SYS_pthread+26)
# define SYS_pthread_yield (__SYS_pthread+27)
# ifdef CONFIG_CANCELLATION_POINTS # ifdef CONFIG_CANCELLATION_POINTS
# define SYS_pthread_setcanceltype (__SYS_pthread+28) # define SYS_pthread_setcanceltype (__SYS_pthread+27)
# define SYS_pthread_testcancel (__SYS_pthread+29) # define SYS_pthread_testcancel (__SYS_pthread+28)
# define __SYS_pthread_smp (__SYS_pthread+30) # define __SYS_pthread_smp (__SYS_pthread+29)
# else # else
# define __SYS_pthread_smp (__SYS_pthread+28) # define __SYS_pthread_smp (__SYS_pthread+27)
# endif # endif
# ifdef CONFIG_SMP # ifdef CONFIG_SMP
sched/pthread/Make.defs
+1 -1
View File
@@ -42,7 +42,7 @@ CSRCS += pthread_mutexlock.c pthread_mutextrylock.c pthread_mutexunlock.c
CSRCS += pthread_condinit.c pthread_conddestroy.c CSRCS += pthread_condinit.c pthread_conddestroy.c
CSRCS += pthread_condwait.c pthread_condsignal.c pthread_condbroadcast.c CSRCS += pthread_condwait.c pthread_condsignal.c pthread_condbroadcast.c
CSRCS += pthread_barrierinit.c pthread_barrierdestroy.c pthread_barrierwait.c CSRCS += pthread_barrierinit.c pthread_barrierdestroy.c pthread_barrierwait.c
CSRCS += pthread_cancel.c pthread_setcancelstate.c CSRCS += pthread_cancel.c
CSRCS += pthread_keycreate.c pthread_setspecific.c pthread_getspecific.c CSRCS += pthread_keycreate.c pthread_setspecific.c pthread_getspecific.c
CSRCS += pthread_keydelete.c CSRCS += pthread_keydelete.c
CSRCS += pthread_initialize.c pthread_completejoin.c pthread_findjoininfo.c CSRCS += pthread_initialize.c pthread_completejoin.c pthread_findjoininfo.c
sched/task/Make.defs
+3 -2
View File
@@ -35,8 +35,9 @@
CSRCS += task_create.c task_init.c task_setup.c task_activate.c CSRCS += task_create.c task_init.c task_setup.c task_activate.c
CSRCS += task_start.c task_delete.c task_exit.c task_exithook.c CSRCS += task_start.c task_delete.c task_exit.c task_exithook.c
CSRCS += task_recover.c task_restart.c task_spawnparms.c task_terminate.c CSRCS += task_getgroup.c task_getpid.c task_prctl.c task_recover.c
CSRCS += task_getgroup.c task_prctl.c task_getpid.c exit.c CSRCS += task_restart.c task_spawnparms.c task_setcancelstate.c
CSRCS += task_terminate.c exit.c
ifeq ($(CONFIG_ARCH_HAVE_VFORK),y) ifeq ($(CONFIG_ARCH_HAVE_VFORK),y)
ifeq ($(CONFIG_SCHED_WAITPID),y) ifeq ($(CONFIG_SCHED_WAITPID),y)
sched/pthread/pthread_setcancelstate.c → sched/task/task_setcancelstate.c
+32 -15
View File
@@ -1,7 +1,7 @@
/**************************************************************************** /****************************************************************************
* sched/pthread/pthread_setcancelstate.c * sched/task/task_setcancelstate.c
* *
* Copyright (C) 2007, 2008 Gregory Nutt. All rights reserved. * Copyright (C) 2007, 2008, 2016 Gregory Nutt. All rights reserved.
* Author: Gregory Nutt <gnutt@nuttx.org> * Author: Gregory Nutt <gnutt@nuttx.org>
* *
* Redistribution and use in source and binary forms, with or without * Redistribution and use in source and binary forms, with or without
@@ -39,33 +39,39 @@
#include <nuttx/config.h> #include <nuttx/config.h>
#include <pthread.h>
#include <errno.h> #include <errno.h>
#include "task/task.h"
#include "sched/sched.h" #include "sched/sched.h"
#include "task/task.h"
/**************************************************************************** /****************************************************************************
* Public Functions * Public Functions
****************************************************************************/ ****************************************************************************/
/**************************************************************************** /****************************************************************************
* Name: pthread_setcancelstate * Name: task_setcancelstate
* *
* Description: * Description:
* The pthread_setcancelstate() function atomically both sets the calling * The task_setcancelstate() function atomically both sets the calling
* thread's cancelability state to the indicated state and returns the * task's cancelability state to the indicated state and returns the
* previous cancelability state at the location referenced by oldstate. * previous cancelability state at the location referenced by oldstate.
* Legal values for state are PTHREAD_CANCEL_ENABLE and * Legal values for state are TASK_CANCEL_ENABLE and TASK_CANCEL_DISABLE.
* PTHREAD_CANCEL_DISABLE.
* *
* The cancelability state and type of any newly created threads, * The cancelability state and type of any newly created tasks are
* including the thread in which main() was first invoked, are * TASK_CANCEL_ENABLE and TASK_CANCEL_DEFERRED respectively.
* PTHREAD_CANCEL_ENABLE and PTHREAD_CANCEL_DEFERRED respectively. *
* Input Parameters:
* state - the new cancellability state, either TASK_CANCEL_ENABLE or
* TASK_CANCEL_DISABLE
* oldstate - The location to return the old cancellability state.
*
* Returned Value:
* Zero (OK) on success; ERROR is returned on any failure with the
* errno value set appropriately.
* *
****************************************************************************/ ****************************************************************************/
int pthread_setcancelstate(int state, FAR int *oldstate) int task_setcancelstate(int state, FAR int *oldstate)
{ {
FAR struct tcb_s *tcb = this_task(); FAR struct tcb_s *tcb = this_task();
int ret = OK; int ret = OK;
@@ -124,7 +130,17 @@ int pthread_setcancelstate(int state, FAR int *oldstate)
*/ */
tcb->flags &= ~TCB_FLAG_CANCEL_PENDING; tcb->flags &= ~TCB_FLAG_CANCEL_PENDING;
pthread_exit(PTHREAD_CANCELED);
#ifndef CONFIG_DISABLE_PTHREAD
if ((tcb->flags & TCB_FLAG_TTYPE_MASK) == TCB_FLAG_TTYPE_PTHREAD)
{
pthread_exit(PTHREAD_CANCELED);
}
else
#endif
{
exit(EXIT_FAILURE);
}
} }
} }
} }
@@ -136,7 +152,8 @@ int pthread_setcancelstate(int state, FAR int *oldstate)
} }
else else
{ {
ret = EINVAL; set_errno(EINVAL);
ret = ERROR;
} }
sched_unlock(); sched_unlock();
syscall/syscall.csv
+1 -1
View File
@@ -89,7 +89,6 @@
"pthread_mutex_unlock","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","FAR pthread_mutex_t*" "pthread_mutex_unlock","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","FAR pthread_mutex_t*"
"pthread_once","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","FAR pthread_once_t*","CODE void (*)(void)" "pthread_once","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","FAR pthread_once_t*","CODE void (*)(void)"
"pthread_setaffinity_np","pthread.h","!defined(CONFIG_DISABLE_PTHREAD) && defined(CONFIG_SMP)","int","pthread_t","size_t","FAR const cpu_set_t*" "pthread_setaffinity_np","pthread.h","!defined(CONFIG_DISABLE_PTHREAD) && defined(CONFIG_SMP)","int","pthread_t","size_t","FAR const cpu_set_t*"
"pthread_setcancelstate","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","int","FAR int*"
"pthread_setcanceltype","pthread.h","!defined(CONFIG_DISABLE_PTHREAD) && defined(CONFIG_CANCELLATION_POINTS)","int","int","FAR int*" "pthread_setcanceltype","pthread.h","!defined(CONFIG_DISABLE_PTHREAD) && defined(CONFIG_CANCELLATION_POINTS)","int","int","FAR int*"
"pthread_setschedparam","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","pthread_t","int","FAR const struct sched_param*" "pthread_setschedparam","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","pthread_t","int","FAR const struct sched_param*"
"pthread_setschedprio","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","pthread_t","int" "pthread_setschedprio","pthread.h","!defined(CONFIG_DISABLE_PTHREAD)","int","pthread_t","int"
@@ -152,6 +151,7 @@
#"task_create","sched.h","","int","const char*","int","main_t","FAR char * const []|FAR char * const *" #"task_create","sched.h","","int","const char*","int","main_t","FAR char * const []|FAR char * const *"
"task_delete","sched.h","","int","pid_t" "task_delete","sched.h","","int","pid_t"
"task_restart","sched.h","","int","pid_t" "task_restart","sched.h","","int","pid_t"
"task_setcancelstate","sched.h","","int","int","FAR int*"
"telldir","dirent.h","CONFIG_NFILE_DESCRIPTORS > 0","off_t","FAR DIR*" "telldir","dirent.h","CONFIG_NFILE_DESCRIPTORS > 0","off_t","FAR DIR*"
"timer_create","time.h","!defined(CONFIG_DISABLE_POSIX_TIMERS)","int","clockid_t","FAR struct sigevent*","FAR timer_t*" "timer_create","time.h","!defined(CONFIG_DISABLE_POSIX_TIMERS)","int","clockid_t","FAR struct sigevent*","FAR timer_t*"
"timer_delete","time.h","!defined(CONFIG_DISABLE_POSIX_TIMERS)","int","timer_t" "timer_delete","time.h","!defined(CONFIG_DISABLE_POSIX_TIMERS)","int","timer_t"
Can't render this file because it contains an unexpected character in line 151 and column 2.
syscall/syscall_lookup.h
+1 -1
View File
@@ -86,6 +86,7 @@ SYSCALL_LOOKUP(pgalloc, 2, STUB_pgalloc)
#endif #endif
SYSCALL_LOOKUP(task_delete, 1, STUB_task_delete) SYSCALL_LOOKUP(task_delete, 1, STUB_task_delete)
SYSCALL_LOOKUP(task_restart, 1, STUB_task_restart) SYSCALL_LOOKUP(task_restart, 1, STUB_task_restart)
SYSCALL_LOOKUP(task_setcancelstate, 2, STUB_task_setcancelstate)
SYSCALL_LOOKUP(up_assert, 2, STUB_up_assert) SYSCALL_LOOKUP(up_assert, 2, STUB_up_assert)
/* The following can be individually enabled */ /* The following can be individually enabled */
@@ -290,7 +291,6 @@ SYSCALL_LOOKUP(up_assert, 2, STUB_up_assert)
SYSCALL_LOOKUP(pthread_mutex_trylock, 1, STUB_pthread_mutex_trylock) SYSCALL_LOOKUP(pthread_mutex_trylock, 1, STUB_pthread_mutex_trylock)
SYSCALL_LOOKUP(pthread_mutex_unlock, 1, STUB_pthread_mutex_unlock) SYSCALL_LOOKUP(pthread_mutex_unlock, 1, STUB_pthread_mutex_unlock)
SYSCALL_LOOKUP(pthread_once, 2, STUB_pthread_once) SYSCALL_LOOKUP(pthread_once, 2, STUB_pthread_once)
SYSCALL_LOOKUP(pthread_setcancelstate, 2, STUB_pthread_setcancelstate)
SYSCALL_LOOKUP(pthread_setschedparam, 3, STUB_pthread_setschedparam) SYSCALL_LOOKUP(pthread_setschedparam, 3, STUB_pthread_setschedparam)
SYSCALL_LOOKUP(pthread_setschedprio, 2, STUB_pthread_setschedprio) SYSCALL_LOOKUP(pthread_setschedprio, 2, STUB_pthread_setschedprio)
SYSCALL_LOOKUP(pthread_setspecific, 2, STUB_pthread_setspecific) SYSCALL_LOOKUP(pthread_setspecific, 2, STUB_pthread_setspecific)
syscall/syscall_stublookup.c
+2 -2
View File
@@ -96,6 +96,8 @@ uintptr_t STUB_task_create(int nbr, uintptr_t parm1, uintptr_t parm2,
uintptr_t parm3, uintptr_t parm4, uintptr_t parm5); uintptr_t parm3, uintptr_t parm4, uintptr_t parm5);
uintptr_t STUB_task_delete(int nbr, uintptr_t parm1); uintptr_t STUB_task_delete(int nbr, uintptr_t parm1);
uintptr_t STUB_task_restart(int nbr, uintptr_t parm1); uintptr_t STUB_task_restart(int nbr, uintptr_t parm1);
uintptr_t STUB_task_setcancelstate(int nbr, uintptr_t parm1,
uintptr_t parm2);
uintptr_t STUB_up_assert(int nbr, uintptr_t parm1, uintptr_t parm2); uintptr_t STUB_up_assert(int nbr, uintptr_t parm1, uintptr_t parm2);
/* The following can be individually enabled */ /* The following can be individually enabled */
@@ -290,8 +292,6 @@ uintptr_t STUB_pthread_mutex_lock(int nbr, uintptr_t parm1);
uintptr_t STUB_pthread_mutex_trylock(int nbr, uintptr_t parm1); uintptr_t STUB_pthread_mutex_trylock(int nbr, uintptr_t parm1);
uintptr_t STUB_pthread_mutex_unlock(int nbr, uintptr_t parm1); uintptr_t STUB_pthread_mutex_unlock(int nbr, uintptr_t parm1);
uintptr_t STUB_pthread_once(int nbr, uintptr_t parm1, uintptr_t parm2); uintptr_t STUB_pthread_once(int nbr, uintptr_t parm1, uintptr_t parm2);
uintptr_t STUB_pthread_setcancelstate(int nbr, uintptr_t parm1,
uintptr_t parm2);
uintptr_t STUB_pthread_setschedparam(int nbr, uintptr_t parm1, uintptr_t STUB_pthread_setschedparam(int nbr, uintptr_t parm1,
uintptr_t parm2, uintptr_t parm3); uintptr_t parm2, uintptr_t parm3);
uintptr_t STUB_pthread_setschedprio(int nbr, uintptr_t parm1, uintptr_t STUB_pthread_setschedprio(int nbr, uintptr_t parm1,