Update documentation to at least reference the ELF loader.

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@5276 42af7a65-404d-4744-a932-0658087f49c3
This commit is contained in:
patacongo 2012-10-29 21:18:51 +00:00
parent 2da5226ac3
commit 17d61bc523
3 changed files with 92 additions and 12 deletions

View File

@ -8,7 +8,7 @@
<tr align="center" bgcolor="#e4e4e4"> <tr align="center" bgcolor="#e4e4e4">
<td> <td>
<h1><big><font color="#3c34ec"><i>NuttX RTOS</i></font></big></h1> <h1><big><font color="#3c34ec"><i>NuttX RTOS</i></font></big></h1>
<p>Last Updated: September 29, 2012</p> <p>Last Updated: October 29, 2012</p>
</td> </td>
</tr> </tr>
</table> </table>
@ -448,13 +448,20 @@
<li>ROMFS filesystem support.</li> <li>ROMFS filesystem support.</li>
</p> </p>
</tr> </tr>
<tr>
<td><br></td>
<td>
<p>
<li><a href="NuttXNxFlat.html">Loadable ELF Modules</a>.
Support for separately linked, loadable ELF modules.
</p>
</tr>
<tr> <tr>
<td><br></td> <td><br></td>
<td> <td>
<p> <p>
<li><a href="NuttXNxFlat.html">NXFLAT</a>. <li><a href="NuttXNxFlat.html">NXFLAT</a>.
A new binary format call NXFLAT that can be used to NXFLAT is a binary format that can be XIP from a file system.
execute separately linked programs in place in a file system.
</p> </p>
</tr> </tr>
<tr> <tr>

View File

@ -12,7 +12,7 @@
<h1><big><font color="#3c34ec"> <h1><big><font color="#3c34ec">
<i>NuttX RTOS Porting Guide</i> <i>NuttX RTOS Porting Guide</i>
</font></big></h1> </font></big></h1>
<p>Last Updated: October 20, 2012</p> <p>Last Updated: October 29, 2012</p>
</td> </td>
</tr> </tr>
</table> </table>
@ -4070,11 +4070,6 @@ build
desciptors by task_create() when a new task is started. desciptors by task_create() when a new task is started.
If set, all sockets will appear to be closed in the new task. If set, all sockets will appear to be closed in the new task.
</li> </li>
<li>
<code>CONFIG_NXFLAT</code>: Enable support for the NXFLAT binary format.
This format will support execution of NuttX binaries located
in a ROMFS file system (see <code>apps/examples/nxflat</code>).
</li>
<li> <li>
<code>CONFIG_SCHED_WORKQUEUE</code>: Create a dedicated "worker" thread to <code>CONFIG_SCHED_WORKQUEUE</code>: Create a dedicated "worker" thread to
handle delayed processing from interrupt handlers. This feature handle delayed processing from interrupt handlers. This feature
@ -4144,6 +4139,54 @@ build
</li> </li>
</ul> </ul>
<p>
Binary Loaders:
</p>
<ul>
<li>
<code>CONFIG_BINFMT_DISABLE</code>: By default, support for loadable binary formats is built.
This logic may be suppressed be defining this setting.
</li>
<li>
<code>CONFIG_BINFMT_CONSTRUCTORS</code>: Build in support for C++ constructors in loaded modules.
</li>
<li>
<code>CONFIG_SYMTAB_ORDEREDBYNAME</code>: Symbol tables are order by name (rather than value).
</li>
<li>
<code>CONFIG_NXFLAT</code>: Enable support for the NXFLAT binary format.
This format will support execution of NuttX binaries located
in a ROMFS file system (see <code>apps/examples/nxflat</code>).
</li>
<li>
<code>CONFIG_ELF</code>: Enable support for the ELF binary format.
This format will support execution of ELF binaries copied from a file system and relocated into RAM (see <code>apps/examples/elf</code>).
</li>
<p>
If <code>CONFIG_ELF</code> is selected, then these additional options are available:
</p>
<li>
<code>CONFIG_ELF_ALIGN_LOG2</code>: Align all sections to this Log2 value: 0->1, 1->2, 2->4, etc.
</li>
<li>
<code>CONFIG_ELF_STACKSIZE</code>: This is the default stack size that will will be used when starting ELF binaries.
</li>
<li>
<code>CONFIG_ELF_BUFFERSIZE</code>: This is an I/O buffer that is used to access the ELF file. Variable length items will need to be read (such as symbol names).
This is really just this initial size of the buffer; it will be reallocated as necessary to hold large symbol names).
Default: 128
</li>
<li>
<code>CONFIG_ELF_BUFFERINCR</code>: This is an I/O buffer that is used to access the ELF file. Variable length items will need to be read (such as symbol names).
This value specifies the size increment to use each time the buffer is reallocated.
Default: 32
</li>
<li>
<code>CONFIG_ELF_DUMPBUFFER</code>: Dump various ELF buffers for debug purposes.
This option requires <code>CONFIG_DEBUG</code> and <code>CONFIG_DEBUG_VERBOSE</code>.
</li>
</ul>
<p> <p>
System Logging: System Logging:
</p> </p>

View File

@ -371,9 +371,6 @@ defconfig -- This is a configuration file similar to the Linux
CONFIG_SDCLONE_DISABLE. Disable cloning of all socket CONFIG_SDCLONE_DISABLE. Disable cloning of all socket
desciptors by task_create() when a new task is started. If desciptors by task_create() when a new task is started. If
set, all sockets will appear to be closed in the new task. set, all sockets will appear to be closed in the new task.
CONFIG_NXFLAT. Enable support for the NXFLAT binary format.
This format will support execution of NuttX binaries located
in a ROMFS filesystem (see examples/nxflat).
CONFIG_SCHED_WORKQUEUE. Create a dedicated "worker" thread to CONFIG_SCHED_WORKQUEUE. Create a dedicated "worker" thread to
handle delayed processing from interrupt handlers. This feature handle delayed processing from interrupt handlers. This feature
is required for some drivers but, if there are not complaints, is required for some drivers but, if there are not complaints,
@ -417,6 +414,39 @@ defconfig -- This is a configuration file similar to the Linux
where 'app' is the application name. If not defined, CONFIG_USER_ENTRYPOINT where 'app' is the application name. If not defined, CONFIG_USER_ENTRYPOINT
defaults to user_start. defaults to user_start.
Binary Loaders:
CONFIG_BINFMT_DISABLE - By default, support for loadable binary formats
is built.
This logic may be suppressed be defining this setting.
CONFIG_BINFMT_CONSTRUCTORS - Build in support for C++ constructors in
loaded modules.
CONFIG_SYMTAB_ORDEREDBYNAME - Symbol tables are order by name (rather
than value).
CONFIG_NXFLAT. Enable support for the NXFLAT binary format. This format
will support execution of NuttX binaries located in a ROMFS filesystem
(see examples/nxflat).
CONFIG_ELF - Enable support for the ELF binary format. This format will
support execution of ELF binaries copied from a file system and
relocated into RAM.
If CONFIG_ELF is selected, then these additional options are available:
CONFIG_ELF_ALIGN_LOG2 - Align all sections to this Log2 value: 0->1,
1->2, 2->4, etc.
CONFIG_ELF_STACKSIZE - This is the default stack size that will will
be used when starting ELF binaries.
CONFIG_ELF_BUFFERSIZE - This is an I/O buffer that is used to access
the ELF file. Variable length items will need to be read (such as
symbol names). This is really just this initial size of the buffer;
it will be reallocated as necessary to hold large symbol names).
Default: 128
CONFIG_ELF_BUFFERINCR - This is an I/O buffer that is used to access
the ELF file. Variable length items will need to be read (such as
symbol names). This value specifies the size increment to use each
time the buffer is reallocated. Default: 32
CONFIG_ELF_DUMPBUFFER - Dump various ELF buffers for debug purposes.
This option requires CONFIG_DEBUG and CONFIG_DEBUG_VERBOSE.
System Logging: System Logging:
CONFIG_SYSLOG enables general system logging support. CONFIG_SYSLOG enables general system logging support.
CONFIG_SYSLOG_DEVPATH - The full path to the system logging device. Default CONFIG_SYSLOG_DEVPATH - The full path to the system logging device. Default