This is an automated email from the ASF dual-hosted git repository. github-bot pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/incubator-nuttx-website.git
The following commit(s) were added to refs/heads/asf-site by this push: new 8d6da5f3 Publishing web: 7e21510459ba6f754fb1da76a14d643b3953b931 docs: 79d02c0e29e625c0fa30e8d3fc731e844872b200 8d6da5f3 is described below commit 8d6da5f306bd4429b69e5e4db9277156600ef6bb Author: Nathan <59230071+hartmannat...@users.noreply.github.com> AuthorDate: Wed Nov 23 00:13:14 2022 +0000 Publishing web: 7e21510459ba6f754fb1da76a14d643b3953b931 docs: 79d02c0e29e625c0fa30e8d3fc731e844872b200 --- content/docs/10.0.0/index.html | 2 +- content/docs/10.0.0/searchindex.js | 2 +- content/docs/10.0.1/index.html | 2 +- content/docs/10.0.1/searchindex.js | 2 +- content/docs/10.1.0/index.html | 2 +- content/docs/10.1.0/searchindex.js | 2 +- content/docs/10.2.0/index.html | 2 +- content/docs/10.2.0/searchindex.js | 2 +- content/docs/10.3.0/index.html | 2 +- content/docs/10.3.0/searchindex.js | 2 +- content/docs/11.0.0/index.html | 2 +- content/docs/11.0.0/searchindex.js | 2 +- .../docs/latest/_sources/components/paging.rst.txt | 6 +- .../docs/latest/_sources/reference/os/arch.rst.txt | 48 ++-------------- content/docs/latest/components/paging.html | 6 +- content/docs/latest/genindex.html | 8 +-- content/docs/latest/index.html | 2 +- content/docs/latest/objects.inv | Bin 39401 -> 39360 bytes content/docs/latest/reference/os/arch.html | 64 +++------------------ content/docs/latest/searchindex.js | 2 +- content/feed.xml | 4 +- 21 files changed, 37 insertions(+), 127 deletions(-) diff --git a/content/docs/10.0.0/index.html b/content/docs/10.0.0/index.html index a46e6bb7..d4ecc5fb 100644 --- a/content/docs/10.0.0/index.html +++ b/content/docs/10.0.0/index.html @@ -133,7 +133,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 32-bit microcontroller environments, the primary governing standards in NuttX are Posix and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:11</p> +<p>Last Updated: 23 November 22 at 00:10</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/10.0.0/searchindex.js b/content/docs/10.0.0/searchindex.js index d8ea34b1..aa0a68c1 100644 --- a/content/docs/10.0.0/searchindex.js +++ b/content/docs/10.0.0/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","boards/index","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/index","components/drivers/character/keypad","components/drivers/character/pwm","components/drivers/character/quadrature","components/drivers/character/rtc","components/drivers/character/serial","components/drivers/character/timer","components/drivers/character/touchscreen [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","boards/index","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/index","components/drivers/character/keypad","components/drivers/character/pwm","components/drivers/character/quadrature","components/drivers/character/rtc","components/drivers/character/serial","components/drivers/character/timer","components/drivers/character/touchscreen [...] \ No newline at end of file diff --git a/content/docs/10.0.1/index.html b/content/docs/10.0.1/index.html index 15a5d220..d83b460d 100644 --- a/content/docs/10.0.1/index.html +++ b/content/docs/10.0.1/index.html @@ -145,7 +145,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 32-bit microcontroller environments, the primary governing standards in NuttX are Posix and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:11</p> +<p>Last Updated: 23 November 22 at 00:11</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/10.0.1/searchindex.js b/content/docs/10.0.1/searchindex.js index d8ea34b1..c43240fd 100644 --- a/content/docs/10.0.1/searchindex.js +++ b/content/docs/10.0.1/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","boards/index","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/index","components/drivers/character/keypad","components/drivers/character/pwm","components/drivers/character/quadrature","components/drivers/character/rtc","components/drivers/character/serial","components/drivers/character/timer","components/drivers/character/touchscreen [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","boards/index","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/index","components/drivers/character/keypad","components/drivers/character/pwm","components/drivers/character/quadrature","components/drivers/character/rtc","components/drivers/character/serial","components/drivers/character/timer","components/drivers/character/touchscreen [...] \ No newline at end of file diff --git a/content/docs/10.1.0/index.html b/content/docs/10.1.0/index.html index 8110c2d1..463674b1 100644 --- a/content/docs/10.1.0/index.html +++ b/content/docs/10.1.0/index.html @@ -144,7 +144,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:11</p> +<p>Last Updated: 23 November 22 at 00:11</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/10.1.0/searchindex.js b/content/docs/10.1.0/searchindex.js index df837f85..ac0e4753 100644 --- a/content/docs/10.1.0/searchindex.js +++ b/content/docs/10.1.0/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file diff --git a/content/docs/10.2.0/index.html b/content/docs/10.2.0/index.html index 2cd3a14f..2df914e6 100644 --- a/content/docs/10.2.0/index.html +++ b/content/docs/10.2.0/index.html @@ -145,7 +145,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:11</p> +<p>Last Updated: 23 November 22 at 00:11</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/10.2.0/searchindex.js b/content/docs/10.2.0/searchindex.js index 470eccc8..18765d8e 100644 --- a/content/docs/10.2.0/searchindex.js +++ b/content/docs/10.2.0/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file diff --git a/content/docs/10.3.0/index.html b/content/docs/10.3.0/index.html index ee491150..2df914e6 100644 --- a/content/docs/10.3.0/index.html +++ b/content/docs/10.3.0/index.html @@ -145,7 +145,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:12</p> +<p>Last Updated: 23 November 22 at 00:11</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/10.3.0/searchindex.js b/content/docs/10.3.0/searchindex.js index 4ce73586..20b6e73c 100644 --- a/content/docs/10.3.0/searchindex.js +++ b/content/docs/10.3.0/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file diff --git a/content/docs/11.0.0/index.html b/content/docs/11.0.0/index.html index ee491150..2df914e6 100644 --- a/content/docs/11.0.0/index.html +++ b/content/docs/11.0.0/index.html @@ -145,7 +145,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:12</p> +<p>Last Updated: 23 November 22 at 00:11</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/11.0.0/searchindex.js b/content/docs/11.0.0/searchindex.js index 7999b300..c34b2d97 100644 --- a/content/docs/11.0.0/searchindex.js +++ b/content/docs/11.0.0/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file diff --git a/content/docs/latest/_sources/components/paging.rst.txt b/content/docs/latest/_sources/components/paging.rst.txt index 5aa55fb8..455ac76d 100644 --- a/content/docs/latest/_sources/components/paging.rst.txt +++ b/content/docs/latest/_sources/components/paging.rst.txt @@ -102,7 +102,7 @@ function will perform the following operations: with the page fill worker must be "`locked <#MemoryOrg>`__" and always present in memory. #. **Block the currently executing task**. This function will call - ``up_block_task()`` to block the task at the head of the ready-to-run + ``up_switch_context()`` to block the task at the head of the ready-to-run list. This should cause an interrupt level context switch to the next highest priority task. The blocked task will be marked with state ``TSTATE_WAIT_PAGEFILL`` and will be retained in the @@ -373,8 +373,8 @@ Most standard, architecture-specific functions are declared in ``include/nuttx/arch.h``. However, for the case of this paging logic, the architecture specific functions are declared in ``include/nuttx/page.h``. Standard, architecture-specific functions that -should already be provided in the architecture port are :c:func:`up_block_task` -and :c:func:`up_unblock_task`. New, additional functions that must be +should already be provided in the architecture port are +:c:func:`up_switch_context`. New, additional functions that must be implemented just for on-demand paging support are: .. c:function:: int up_checkmapping(FAR struct tcb_s *tcb) diff --git a/content/docs/latest/_sources/reference/os/arch.rst.txt b/content/docs/latest/_sources/reference/os/arch.rst.txt index 42df537b..45dd69cb 100644 --- a/content/docs/latest/_sources/reference/os/arch.rst.txt +++ b/content/docs/latest/_sources/reference/os/arch.rst.txt @@ -174,35 +174,17 @@ APIs Exported by Architecture-Specific Logic to NuttX and threads must have come from memory that is accessible to user -.. c:function:: void up_unblock_task(FAR struct tcb_s *tcb) +.. c:function:: void up_switch_context(FAR struct tcb_s *tcb, FAR struct tcb_s *rtcb) - A task is currently in an inactive task list but - has been prepped to execute. Move the TCB to the ready-to-run - list, restore its context, and start execution. + A task is currently in the ready-to-run list but has been preppe + to execute. Restore its context, and start execution. This function is called only from the NuttX scheduling logic. Interrupts will always be disabled when this function is called. - :param tcb: Refers to the tcb to be unblocked. This tcb is in one - of the waiting tasks lists. It must be moved to the - ready-to-run list and, if it is the highest priority ready to - run tasks, executed. - -.. c:function:: void up_block_task(FAR struct tcb_s *tcb, tstate_t task_state) - - The currently executing task at the head of the - ready to run list must be stopped. Save its context and move it to - the inactive list specified by task_state. This function is called - only from the NuttX scheduling logic. Interrupts will always be - disabled when this function is called. - - :param tcb: Refers to a task in the ready-to-run list (normally - the task at the head of the list). It must be stopped, its - context saved and moved into one of the waiting task lists. If - it was the task at the head of the ready-to-run list, then a - context switch to the new ready to run task must be performed. - :param task_state: Specifies which waiting task list should be - hold the blocked task TCB. + :param tcb: Refers to the head task of the ready-to-run list + which will be executed. + :param rtcb: Refers to the running task which will be blocked. .. c:function:: void up_release_pending(void) @@ -217,24 +199,6 @@ APIs Exported by Architecture-Specific Logic to NuttX pre-emption is re-enabled. Interrupts will always be disabled when this function is called. -.. c:function:: void up_reprioritize_rtr(FAR struct tcb_s *tcb, uint8_t priority) - - Called when the priority of a running or - ready-to-run task changes and the reprioritization will cause a - context switch. Two cases: - - #. The priority of the currently running task drops and the next - task in the ready to run list has priority. - #. An idle, ready to run task's priority has been raised above the - the priority of the current, running task and it now has the - priority. - - This function is called only from the NuttX scheduling logic. - Interrupts will always be disabled when this function is called. - - :param tcb: The TCB of the task that has been reprioritized - :param priority: The new task priority - .. c:macro:: noreturn_function .. c:function:: void up_exit(int status) noreturn_function; diff --git a/content/docs/latest/components/paging.html b/content/docs/latest/components/paging.html index e2435a57..87a58a88 100644 --- a/content/docs/latest/components/paging.html +++ b/content/docs/latest/components/paging.html @@ -263,7 +263,7 @@ thread is how the page fault is resolved and all logic associated with the page fill worker must be “<a class="reference external" href="#MemoryOrg">locked</a>” and always present in memory.</p></li> <li><p><strong>Block the currently executing task</strong>. This function will call -<code class="docutils literal notranslate"><span class="pre">up_block_task()</span></code> to block the task at the head of the ready-to-run +<code class="docutils literal notranslate"><span class="pre">up_switch_context()</span></code> to block the task at the head of the ready-to-run list. This should cause an interrupt level context switch to the next highest priority task. The blocked task will be marked with state <code class="docutils literal notranslate"><span class="pre">TSTATE_WAIT_PAGEFILL</span></code> and will be retained in the @@ -568,8 +568,8 @@ should position the “special” section so that it lies in a reserved, <code class="docutils literal notranslate"><span class="pre">include/nuttx/arch.h</span></code>. However, for the case of this paging logic, the architecture specific functions are declared in <code class="docutils literal notranslate"><span class="pre">include/nuttx/page.h</span></code>. Standard, architecture-specific functions that -should already be provided in the architecture port are <a class="reference internal" href="../reference/os/arch.html#c.up_block_task" title="up_block_task"><code class="xref c c-func docutils literal notranslate"><span class="pre">up_block_task()</span></code></a> -and <a class="reference internal" href="../reference/os/arch.html#c.up_unblock_task" title="up_unblock_task"><code class="xref c c-func docutils literal notranslate"><span class="pre">up_unblock_task()</span></code></a>. New, additional functions that must be +should already be provided in the architecture port are +<a class="reference internal" href="../reference/os/arch.html#c.up_switch_context" title="up_switch_context"><code class="xref c c-func docutils literal notranslate"><span class="pre">up_switch_context()</span></code></a>. New, additional functions that must be implemented just for on-demand paging support are:</p> <dl class="c function"> <dt class="sig sig-object c" id="c.up_checkmapping"> diff --git a/content/docs/latest/genindex.html b/content/docs/latest/genindex.html index d1e57726..ec4bd605 100644 --- a/content/docs/latest/genindex.html +++ b/content/docs/latest/genindex.html @@ -1558,8 +1558,6 @@ <li><a href="components/paging.html#c.up_allocpage">up_allocpage (C function)</a> </li> <li><a href="reference/os/arch.html#c.up_assert">up_assert (C function)</a> -</li> - <li><a href="reference/os/arch.html#c.up_block_task">up_block_task (C function)</a> </li> <li><a href="components/paging.html#c.up_checkmapping">up_checkmapping (C function)</a> </li> @@ -1598,8 +1596,6 @@ <li><a href="reference/os/arch.html#c.up_release_pending">up_release_pending (C function)</a> </li> <li><a href="reference/os/arch.html#c.up_release_stack">up_release_stack (C function)</a> -</li> - <li><a href="reference/os/arch.html#c.up_reprioritize_rtr">up_reprioritize_rtr (C function)</a> </li> <li><a href="reference/os/arch.html#c.up_schedule_sigaction">up_schedule_sigaction (C function)</a> </li> @@ -1608,6 +1604,8 @@ <li><a href="reference/os/shm.html#c.up_shmdt">up_shmdt (C function)</a> </li> <li><a href="reference/os/arch.html#c.up_stack_frame">up_stack_frame (C function)</a> +</li> + <li><a href="reference/os/arch.html#c.up_switch_context">up_switch_context (C function)</a> </li> <li><a href="reference/os/smp.html#c.up_testset">up_testset (C function)</a> </li> @@ -1616,8 +1614,6 @@ <li><a href="reference/os/time_clock.html#c.up_timer_gettime">up_timer_gettime (C function)</a> </li> <li><a href="reference/os/time_clock.html#c.up_timer_start">up_timer_start (C function)</a> -</li> - <li><a href="reference/os/arch.html#c.up_unblock_task">up_unblock_task (C function)</a> </li> <li><a href="reference/os/arch.html#c.up_use_stack">up_use_stack (C function)</a> </li> diff --git a/content/docs/latest/index.html b/content/docs/latest/index.html index f28d459c..dad5de01 100644 --- a/content/docs/latest/index.html +++ b/content/docs/latest/index.html @@ -145,7 +145,7 @@ by following these <a class="reference internal" href="contributing/documentatio <section id="nuttx-documentation"> <h1>NuttX Documentation<a class="headerlink" href="#nuttx-documentation" title="Permalink to this headline"></a></h1> <p>NuttX is a real-time operating system (RTOS) with an emphasis on standards compliance and small footprint. Scalable from 8-bit to 64-bit microcontroller environments, the primary governing standards in NuttX are POSIX and ANSI standards. Additional standard APIs from Unix and other common RTOS’s (such as VxWorks) are adopted for functionality not available under these standards, or for functionality that is not appropriate for deeply-embedded environments (such as fork()).</p> -<p>Last Updated: 22 November 22 at 00:12</p> +<p>Last Updated: 23 November 22 at 00:12</p> <div class="toctree-wrapper compound"> <p class="caption" role="heading"><span class="caption-text">Table of Contents</span></p> <ul class="current"> diff --git a/content/docs/latest/objects.inv b/content/docs/latest/objects.inv index 6463ad01..b272d207 100644 Binary files a/content/docs/latest/objects.inv and b/content/docs/latest/objects.inv differ diff --git a/content/docs/latest/reference/os/arch.html b/content/docs/latest/reference/os/arch.html index 4dbbdde7..852c5de8 100644 --- a/content/docs/latest/reference/os/arch.html +++ b/content/docs/latest/reference/os/arch.html @@ -356,43 +356,18 @@ user</p> </dd></dl> <dl class="c function"> -<dt class="sig sig-object c" id="c.up_unblock_task"> -<span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">up_unblock_task</span></span></span><span class="sig-paren">(</span><span class="pre">FAR</span><span class="w"> </span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><a class="reference internal" href="../user/structures.html#c.tcb_s" title="tcb_s"><span class="n"><span class="pre">tcb_s</span></span></a><span class [...] -<dd><p>A task is currently in an inactive task list but -has been prepped to execute. Move the TCB to the ready-to-run -list, restore its context, and start execution.</p> +<dt class="sig sig-object c" id="c.up_switch_context"> +<span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">up_switch_context</span></span></span><span class="sig-paren">(</span><span class="pre">FAR</span><span class="w"> </span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><a class="reference internal" href="../user/structures.html#c.tcb_s" title="tcb_s"><span class="n"><span class="pre">tcb_s</span></span></a><span cla [...] +<dd><p>A task is currently in the ready-to-run list but has been preppe +to execute. Restore its context, and start execution.</p> <p>This function is called only from the NuttX scheduling logic. Interrupts will always be disabled when this function is called.</p> <dl class="field-list simple"> <dt class="field-odd">Parameters</dt> <dd class="field-odd"><ul class="simple"> -<li><p><strong>tcb</strong> – Refers to the tcb to be unblocked. This tcb is in one -of the waiting tasks lists. It must be moved to the -ready-to-run list and, if it is the highest priority ready to -run tasks, executed.</p></li> -</ul> -</dd> -</dl> -</dd></dl> - -<dl class="c function"> -<dt class="sig sig-object c" id="c.up_block_task"> -<span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">up_block_task</span></span></span><span class="sig-paren">(</span><span class="pre">FAR</span><span class="w"> </span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><a class="reference internal" href="../user/structures.html#c.tcb_s" title="tcb_s"><span class="n"><span class="pre">tcb_s</span></span></a><span class=" [...] -<dd><p>The currently executing task at the head of the -ready to run list must be stopped. Save its context and move it to -the inactive list specified by task_state. This function is called -only from the NuttX scheduling logic. Interrupts will always be -disabled when this function is called.</p> -<dl class="field-list simple"> -<dt class="field-odd">Parameters</dt> -<dd class="field-odd"><ul class="simple"> -<li><p><strong>tcb</strong> – Refers to a task in the ready-to-run list (normally -the task at the head of the list). It must be stopped, its -context saved and moved into one of the waiting task lists. If -it was the task at the head of the ready-to-run list, then a -context switch to the new ready to run task must be performed.</p></li> -<li><p><strong>task_state</strong> – Specifies which waiting task list should be -hold the blocked task TCB.</p></li> +<li><p><strong>tcb</strong> – Refers to the head task of the ready-to-run list +which will be executed.</p></li> +<li><p><strong>rtcb</strong> – Refers to the running task which will be blocked.</p></li> </ul> </dd> </dl> @@ -412,31 +387,6 @@ pre-emption is re-enabled. Interrupts will always be disabled when this function is called.</p> </dd></dl> -<dl class="c function"> -<dt class="sig sig-object c" id="c.up_reprioritize_rtr"> -<span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">up_reprioritize_rtr</span></span></span><span class="sig-paren">(</span><span class="pre">FAR</span><span class="w"> </span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><a class="reference internal" href="../user/structures.html#c.tcb_s" title="tcb_s"><span class="n"><span class="pre">tcb_s</span></span></a><span c [...] -<dd><p>Called when the priority of a running or -ready-to-run task changes and the reprioritization will cause a -context switch. Two cases:</p> -<ol class="arabic simple"> -<li><p>The priority of the currently running task drops and the next -task in the ready to run list has priority.</p></li> -<li><p>An idle, ready to run task’s priority has been raised above the -the priority of the current, running task and it now has the -priority.</p></li> -</ol> -<p>This function is called only from the NuttX scheduling logic. -Interrupts will always be disabled when this function is called.</p> -<dl class="field-list simple"> -<dt class="field-odd">Parameters</dt> -<dd class="field-odd"><ul class="simple"> -<li><p><strong>tcb</strong> – The TCB of the task that has been reprioritized</p></li> -<li><p><strong>priority</strong> – The new task priority</p></li> -</ul> -</dd> -</dl> -</dd></dl> - <dl class="c macro"> <dt class="sig sig-object c" id="c.noreturn_function"> <span class="sig-name descname"><span class="n"><span class="pre">noreturn_function</span></span></span><a class="headerlink" href="#c.noreturn_function" title="Permalink to this definition"></a><br /></dt> diff --git a/content/docs/latest/searchindex.js b/content/docs/latest/searchindex.js index 076e59c2..883d1cce 100644 --- a/content/docs/latest/searchindex.js +++ b/content/docs/latest/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file +Search.setIndex({docnames:["applications/index","applications/nsh/builtin","applications/nsh/commands","applications/nsh/config","applications/nsh/customizing","applications/nsh/index","applications/nsh/installation","applications/nsh/login","applications/nsh/nsh","components/binfmt","components/drivers/block/index","components/drivers/character/analog","components/drivers/character/can","components/drivers/character/foc","components/drivers/character/index","components/drivers/character [...] \ No newline at end of file diff --git a/content/feed.xml b/content/feed.xml index d2c51c35..c08ec245 100644 --- a/content/feed.xml +++ b/content/feed.xml @@ -5,8 +5,8 @@ <description></description> <link>/</link> <atom:link href="/feed.xml" rel="self" type="application/rss+xml"/> - <pubDate>Tue, 22 Nov 2022 00:13:30 +0000</pubDate> - <lastBuildDate>Tue, 22 Nov 2022 00:13:30 +0000</lastBuildDate> + <pubDate>Wed, 23 Nov 2022 00:13:11 +0000</pubDate> + <lastBuildDate>Wed, 23 Nov 2022 00:13:11 +0000</lastBuildDate> <generator>Jekyll v3.9.2</generator> <item>