You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by gi...@apache.org on 2021/04/17 00:14:41 UTC

[incubator-nuttx-website] branch asf-site updated: Publishing web: 706feb7a8f09ba9c0ea4111239db9d4c65cf9a00 docs: 65274d5fdf81f00db428d0aac19976e23c2bc5cf

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 cbb3d39  Publishing web: 706feb7a8f09ba9c0ea4111239db9d4c65cf9a00 docs: 65274d5fdf81f00db428d0aac19976e23c2bc5cf
cbb3d39 is described below

commit cbb3d39d05d9804bf9a506d5d6dfd82e1540096e
Author: Ouss4 <ab...@gmail.com>
AuthorDate: Sat Apr 17 00:13:40 2021 +0000

    Publishing web: 706feb7a8f09ba9c0ea4111239db9d4c65cf9a00 docs: 65274d5fdf81f00db428d0aac19976e23c2bc5cf
---
 content/docs/10.0.0/index.html                     |  2 +-
 content/docs/10.0.1/index.html                     |  2 +-
 .../docs/latest/_sources/reference/os/arch.rst.txt | 29 +++++++++++----
 content/docs/latest/index.html                     |  2 +-
 content/docs/latest/reference/os/arch.html         | 43 ++++++++++++++++++----
 content/docs/latest/searchindex.js                 |  2 +-
 content/feed.xml                                   |  4 +-
 7 files changed, 64 insertions(+), 20 deletions(-)

diff --git a/content/docs/10.0.0/index.html b/content/docs/10.0.0/index.html
index 789fc49..7077dab 100644
--- a/content/docs/10.0.0/index.html
+++ b/content/docs/10.0.0/index.html
@@ -207,7 +207,7 @@ by following these <a class="reference internal" href="contributing/documentatio
 <div class="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: 16 April 21 at 00:10</p>
+<p>Last Updated: 17 April 21 at 00:11</p>
 <div class="toctree-wrapper compound">
 <p class="caption"><span class="caption-text">Table of Contents</span></p>
 <ul class="current">
diff --git a/content/docs/10.0.1/index.html b/content/docs/10.0.1/index.html
index e7a0dc9..1b136e0 100644
--- a/content/docs/10.0.1/index.html
+++ b/content/docs/10.0.1/index.html
@@ -211,7 +211,7 @@ by following these <a class="reference internal" href="contributing/documentatio
 <div class="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: 16 April 21 at 00:11</p>
+<p>Last Updated: 17 April 21 at 00:11</p>
 <div class="toctree-wrapper compound">
 <p class="caption"><span class="caption-text">Table of Contents</span></p>
 <ul class="current">
diff --git a/content/docs/latest/_sources/reference/os/arch.rst.txt b/content/docs/latest/_sources/reference/os/arch.rst.txt
index 3b94233..eccfbae 100644
--- a/content/docs/latest/_sources/reference/os/arch.rst.txt
+++ b/content/docs/latest/_sources/reference/os/arch.rst.txt
@@ -57,8 +57,8 @@ APIs Exported by Architecture-Specific Logic to NuttX
   -  ``adj_stack_size``: Stack size after adjustment for hardware,
      processor, etc. This value is retained only for debug purposes.
   -  ``stack_alloc_ptr``: Pointer to allocated stack
-  -  ``adj_stack_ptr``: Adjusted ``stack_alloc_ptr`` for HW. The
-     initial value of the stack pointer.
+  -  ``stack_base_ptr``: Adjusted stack base pointer after the TLS Data
+     and Arguments has been removed from the stack allocation.
 
   :param tcb: The TCB of new task.
   :param stack_size: The requested stack size. At least this much
@@ -93,8 +93,8 @@ APIs Exported by Architecture-Specific Logic to NuttX
   -  ``adj_stack_size``: Stack size after adjustment for hardware,
      processor, etc. This value is retained only for debug purposes.
   -  ``stack_alloc_ptr``: Pointer to allocated stack
-  -  ``adj_stack_ptr``: Adjusted ``stack_alloc_ptr`` for HW. The
-     initial value of the stack pointer.
+  -  ``stack_base_ptr``: Adjusted stack base pointer after the TLS Data
+     and Arguments has been removed from the stack allocation.
 
   :param tcb: The TCB of new task.
   :param stack_size: The allocated stack size.
@@ -120,9 +120,24 @@ APIs Exported by Architecture-Specific Logic to NuttX
 
   -  ``adj_stack_size``: Stack size after removal of the stack frame
      from the stack.
-  -  ``adj_stack_ptr``: Adjusted initial stack pointer after the
-     frame has been removed from the stack. This will still be the
-     initial value of the stack pointer when the task is started.
+  -  ``stack_base_ptr``: Adjusted stack base pointer after the TLS Data
+     and Arguments has been removed from the stack allocation.
+
+  Here is the diagram after some allocation(tls, arg):
+
+                   +-------------+ <-stack_alloc_ptr(lowest)
+                   |  TLS Data   |
+                   +-------------+
+                   |  Arguments  |
+  stack_base_ptr-> +-------------+\
+                   |  Available  | +
+                   |    Stack    | |
+                |  |             | |
+                |  |             | +->adj_stack_size
+                v  |             | |
+                   |             | |
+                   |             | +
+                   +-------------+/
 
   :param tcb: The TCB of new task.
   :param frame_size: The size of the stack frame to allocate.
diff --git a/content/docs/latest/index.html b/content/docs/latest/index.html
index 72cdf02..4bc6f63 100644
--- a/content/docs/latest/index.html
+++ b/content/docs/latest/index.html
@@ -212,7 +212,7 @@ by following these <a class="reference internal" href="contributing/documentatio
 <div class="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: 16 April 21 at 00:11</p>
+<p>Last Updated: 17 April 21 at 00:11</p>
 <div class="toctree-wrapper compound">
 <p class="caption"><span class="caption-text">Table of Contents</span></p>
 <ul class="current">
diff --git a/content/docs/latest/reference/os/arch.html b/content/docs/latest/reference/os/arch.html
index ff9764b..e5489fa 100644
--- a/content/docs/latest/reference/os/arch.html
+++ b/content/docs/latest/reference/os/arch.html
@@ -281,8 +281,8 @@ stack-related information in the TCB.</p>
 <li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_size</span></code>: Stack size after adjustment for hardware,
 processor, etc. This value is retained only for debug purposes.</p></li>
 <li><p><code class="docutils literal notranslate"><span class="pre">stack_alloc_ptr</span></code>: Pointer to allocated stack</p></li>
-<li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_ptr</span></code>: Adjusted <code class="docutils literal notranslate"><span class="pre">stack_alloc_ptr</span></code> for HW. The
-initial value of the stack pointer.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">stack_base_ptr</span></code>: Adjusted stack base pointer after the TLS Data
+and Arguments has been removed from the stack allocation.</p></li>
 </ul>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
@@ -324,8 +324,8 @@ from <code class="docutils literal notranslate"><span class="pre">nxtask_init()<
 <li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_size</span></code>: Stack size after adjustment for hardware,
 processor, etc. This value is retained only for debug purposes.</p></li>
 <li><p><code class="docutils literal notranslate"><span class="pre">stack_alloc_ptr</span></code>: Pointer to allocated stack</p></li>
-<li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_ptr</span></code>: Adjusted <code class="docutils literal notranslate"><span class="pre">stack_alloc_ptr</span></code> for HW. The
-initial value of the stack pointer.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">stack_base_ptr</span></code>: Adjusted stack base pointer after the TLS Data
+and Arguments has been removed from the stack allocation.</p></li>
 </ul>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
@@ -356,10 +356,39 @@ protection domain as the thread.</p>
 <ul class="simple">
 <li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_size</span></code>: Stack size after removal of the stack frame
 from the stack.</p></li>
-<li><p><code class="docutils literal notranslate"><span class="pre">adj_stack_ptr</span></code>: Adjusted initial stack pointer after the
-frame has been removed from the stack. This will still be the
-initial value of the stack pointer when the task is started.</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">stack_base_ptr</span></code>: Adjusted stack base pointer after the TLS Data
+and Arguments has been removed from the stack allocation.</p></li>
 </ul>
+<p>Here is the diagram after some allocation(tls, arg):</p>
+<blockquote>
+<div><p>+————-+ &lt;-stack_alloc_ptr(lowest)
+|  TLS Data   |
++————-+
+|  Arguments  |</p>
+</div></blockquote>
+<dl>
+<dt>stack_base_ptr-&gt; +————-+</dt><dd><blockquote>
+<div><div class="line-block">
+<div class="line">Available  | +</div>
+<div class="line-block">
+<div class="line">Stack    | |</div>
+</div>
+</div>
+</div></blockquote>
+<div class="line-block">
+<div class="line">|             | |</div>
+<div class="line">|             | +-&gt;adj_stack_size</div>
+</div>
+<dl>
+<dt>v  |             | |</dt><dd><div class="line-block">
+<div class="line">| |</div>
+<div class="line">| +</div>
+</div>
+<p>+————-+/</p>
+</dd>
+</dl>
+</dd>
+</dl>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters</dt>
 <dd class="field-odd"><ul class="simple">
diff --git a/content/docs/latest/searchindex.js b/content/docs/latest/searchindex.js
index 9381667..1d33a55 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 857c754..39f9b93 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>Fri, 16 Apr 2021 00:13:14 +0000</pubDate>
-    <lastBuildDate>Fri, 16 Apr 2021 00:13:14 +0000</lastBuildDate>
+    <pubDate>Sat, 17 Apr 2021 00:13:39 +0000</pubDate>
+    <lastBuildDate>Sat, 17 Apr 2021 00:13:39 +0000</lastBuildDate>
     <generator>Jekyll v3.8.5</generator>
     
       <item>