mirror of
https://github.com/apache/nuttx.git
synced 2026-05-28 20:08:15 +08:00
Minor updates to READMEs and comments
This commit is contained in:
@@ -167,6 +167,9 @@ The patch can also be removed with:
|
|||||||
|
|
||||||
See the section "Selecting Configurations" below.
|
See the section "Selecting Configurations" below.
|
||||||
|
|
||||||
|
UPDATE: 2014-4-27: The nsh example still does not run correctly. This
|
||||||
|
is believe to be caused by additional, undiagnosed compiler errors.
|
||||||
|
|
||||||
Serial Console
|
Serial Console
|
||||||
==============
|
==============
|
||||||
|
|
||||||
@@ -312,7 +315,9 @@ nsh
|
|||||||
1. Note that you must apply the ZNEO patch if you are using ZDS-II 5.0.1.
|
1. Note that you must apply the ZNEO patch if you are using ZDS-II 5.0.1.
|
||||||
See the README.txt file in the parent directory for more information.
|
See the README.txt file in the parent directory for more information.
|
||||||
|
|
||||||
2. This configuration does not run correctly. There is currently a
|
2. This configuration does not run correctly. This is believed to a yet
|
||||||
problem with the SRAM accesses.
|
another ZDS-II compiler problem. The corresponding NSH configuration
|
||||||
|
of the z16f2800100zcog does work, however, so this could also be an
|
||||||
|
issue with the 16z.
|
||||||
|
|
||||||
Check out any README.txt files in these <sub-directory>s.
|
Check out any README.txt files in these <sub-directory>s.
|
||||||
|
|||||||
@@ -106,6 +106,11 @@ The patch can also be removed with:
|
|||||||
|
|
||||||
See the section "Selecting Configurations" below.
|
See the section "Selecting Configurations" below.
|
||||||
|
|
||||||
|
UPDATE: 2014-4-27: The configs/16z/nsh example still does not run
|
||||||
|
correctly. This is believe to be caused by additional, undiagnosed
|
||||||
|
compiler errors. At present, these compiler bugs do not seem to effect
|
||||||
|
the z16f2800100zcog.
|
||||||
|
|
||||||
Serial Console
|
Serial Console
|
||||||
==============
|
==============
|
||||||
|
|
||||||
|
|||||||
@@ -48,7 +48,7 @@
|
|||||||
#include "pthread_internal.h"
|
#include "pthread_internal.h"
|
||||||
|
|
||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
* Definitions
|
* Pre-processor Definitions
|
||||||
****************************************************************************/
|
****************************************************************************/
|
||||||
|
|
||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
@@ -89,9 +89,9 @@
|
|||||||
* Return Value:
|
* Return Value:
|
||||||
* 0 if successful. Otherwise, one of the following error codes:
|
* 0 if successful. Otherwise, one of the following error codes:
|
||||||
*
|
*
|
||||||
* EINVAL The value specified by thread does not refer to ajoinable
|
* EINVAL The value specified by thread does not refer to joinable
|
||||||
* thread.
|
* thread.
|
||||||
* ESRCH No thread could be found corresponding to thatspecified by the
|
* ESRCH No thread could be found corresponding to that specified by the
|
||||||
* given thread ID.
|
* given thread ID.
|
||||||
* EDEADLK A deadlock was detected or the value of thread specifies the
|
* EDEADLK A deadlock was detected or the value of thread specifies the
|
||||||
* calling thread.
|
* calling thread.
|
||||||
@@ -218,7 +218,7 @@ int pthread_join(pthread_t thread, FAR pthread_addr_t *pexit_value)
|
|||||||
sdbg("exit_value=0x%p\n", pjoin->exit_value);
|
sdbg("exit_value=0x%p\n", pjoin->exit_value);
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Post the thread's data semaphore so that the exitting thread
|
/* Post the thread's data semaphore so that the exiting thread
|
||||||
* will know that we have received the data.
|
* will know that we have received the data.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -253,4 +253,3 @@ int pthread_join(pthread_t thread, FAR pthread_addr_t *pexit_value)
|
|||||||
sdbg("Returning %d\n", ret);
|
sdbg("Returning %d\n", ret);
|
||||||
return ret;
|
return ret;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+13
-13
@@ -53,7 +53,7 @@
|
|||||||
#include "sig_internal.h"
|
#include "sig_internal.h"
|
||||||
|
|
||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
* Definitions
|
* Pre-processor Definitions
|
||||||
****************************************************************************/
|
****************************************************************************/
|
||||||
|
|
||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
@@ -80,7 +80,7 @@
|
|||||||
* Name: task_atexit
|
* Name: task_atexit
|
||||||
*
|
*
|
||||||
* Description:
|
* Description:
|
||||||
* Call any registerd atexit function(s)
|
* Call any registered atexit function(s)
|
||||||
*
|
*
|
||||||
****************************************************************************/
|
****************************************************************************/
|
||||||
|
|
||||||
@@ -90,7 +90,7 @@ static inline void task_atexit(FAR struct tcb_s *tcb)
|
|||||||
FAR struct task_group_s *group = tcb->group;
|
FAR struct task_group_s *group = tcb->group;
|
||||||
|
|
||||||
/* Make sure that we have not already left the group. Only the final
|
/* Make sure that we have not already left the group. Only the final
|
||||||
* exitting thread in the task group should trigger the atexit()
|
* exiting thread in the task group should trigger the atexit()
|
||||||
* callbacks.
|
* callbacks.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -100,7 +100,7 @@ static inline void task_atexit(FAR struct tcb_s *tcb)
|
|||||||
int index;
|
int index;
|
||||||
|
|
||||||
/* Call each atexit function in reverse order of registration atexit()
|
/* Call each atexit function in reverse order of registration atexit()
|
||||||
* functions are registered from lower to higher arry indices; they
|
* functions are registered from lower to higher array indices; they
|
||||||
* must be called in the reverse order of registration when the task
|
* must be called in the reverse order of registration when the task
|
||||||
* group exits, i.e., from higher to lower indices.
|
* group exits, i.e., from higher to lower indices.
|
||||||
*/
|
*/
|
||||||
@@ -140,7 +140,7 @@ static inline void task_atexit(FAR struct tcb_s *tcb)
|
|||||||
* Name: task_onexit
|
* Name: task_onexit
|
||||||
*
|
*
|
||||||
* Description:
|
* Description:
|
||||||
* Call any registerd on_exit function(s)
|
* Call any registered on_exit function(s)
|
||||||
*
|
*
|
||||||
****************************************************************************/
|
****************************************************************************/
|
||||||
|
|
||||||
@@ -150,7 +150,7 @@ static inline void task_onexit(FAR struct tcb_s *tcb, int status)
|
|||||||
FAR struct task_group_s *group = tcb->group;
|
FAR struct task_group_s *group = tcb->group;
|
||||||
|
|
||||||
/* Make sure that we have not already left the group. Only the final
|
/* Make sure that we have not already left the group. Only the final
|
||||||
* exitting thread in the task group should trigger the atexit()
|
* exiting thread in the task group should trigger the atexit()
|
||||||
* callbacks.
|
* callbacks.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -160,9 +160,9 @@ static inline void task_onexit(FAR struct tcb_s *tcb, int status)
|
|||||||
int index;
|
int index;
|
||||||
|
|
||||||
/* Call each on_exit function in reverse order of registration.
|
/* Call each on_exit function in reverse order of registration.
|
||||||
* on_exit() functions are registered from lower to higher arry
|
* on_exit() functions are registered from lower to higher array
|
||||||
* indices; they must be called in the reverse order of registration
|
* indices; they must be called in the reverse order of registration
|
||||||
* when the task grroup exits, i.e., from higher to lower indices.
|
* when the task group exits, i.e., from higher to lower indices.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
for (index = CONFIG_SCHED_ONEXIT_MAX-1; index >= 0; index--)
|
for (index = CONFIG_SCHED_ONEXIT_MAX-1; index >= 0; index--)
|
||||||
@@ -266,7 +266,7 @@ static inline void task_groupexit(FAR struct task_group_s *group)
|
|||||||
DEBUGASSERT(child);
|
DEBUGASSERT(child);
|
||||||
if (child)
|
if (child)
|
||||||
{
|
{
|
||||||
/* Mark that all members of the child task group has exit'ed */
|
/* Mark that all members of the child task group has exited */
|
||||||
|
|
||||||
child->ch_flags |= CHILD_FLAG_EXITED;
|
child->ch_flags |= CHILD_FLAG_EXITED;
|
||||||
}
|
}
|
||||||
@@ -336,7 +336,7 @@ static inline void task_sigchild(gid_t pgid, FAR struct tcb_s *ctcb, int status)
|
|||||||
task_groupexit(pgrp);
|
task_groupexit(pgrp);
|
||||||
|
|
||||||
/* Create the siginfo structure. We don't actually know the cause.
|
/* Create the siginfo structure. We don't actually know the cause.
|
||||||
* That is a bug. Let's just say that the child task just exit-ted
|
* That is a bug. Let's just say that the child task just exited
|
||||||
* for now.
|
* for now.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -387,7 +387,7 @@ static inline void task_sigchild(FAR struct tcb_s *ptcb,
|
|||||||
#endif /* CONFIG_SCHED_CHILD_STATUS */
|
#endif /* CONFIG_SCHED_CHILD_STATUS */
|
||||||
|
|
||||||
/* Create the siginfo structure. We don't actually know the cause.
|
/* Create the siginfo structure. We don't actually know the cause.
|
||||||
* That is a bug. Let's just say that the child task just exit-ted
|
* That is a bug. Let's just say that the child task just exited
|
||||||
* for now.
|
* for now.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -501,7 +501,7 @@ static inline void task_exitwakeup(FAR struct tcb_s *tcb, int status)
|
|||||||
#endif
|
#endif
|
||||||
{
|
{
|
||||||
/* Report the exit status. We do not nullify tg_statloc here
|
/* Report the exit status. We do not nullify tg_statloc here
|
||||||
* because we want to prent other tasks from registering for
|
* because we want to prevent other tasks from registering for
|
||||||
* the return status. There is only one task per task group,
|
* the return status. There is only one task per task group,
|
||||||
* there for, this logic should execute exactly once in the
|
* there for, this logic should execute exactly once in the
|
||||||
* lifetime of the task group.
|
* lifetime of the task group.
|
||||||
@@ -577,7 +577,7 @@ static inline void task_flushstreams(FAR struct tcb_s *tcb)
|
|||||||
*
|
*
|
||||||
* Description:
|
* Description:
|
||||||
* This function implements some of the internal logic of exit() and
|
* This function implements some of the internal logic of exit() and
|
||||||
* task_delete(). This function performs some cleanup and other actions
|
* task_delete(). This function performs some clean-up and other actions
|
||||||
* required when a task exits:
|
* required when a task exits:
|
||||||
*
|
*
|
||||||
* - All open streams are flushed and closed.
|
* - All open streams are flushed and closed.
|
||||||
|
|||||||
Reference in New Issue
Block a user