diff options
author | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2012-10-29 21:18:51 +0000 |
---|---|---|
committer | patacongo <patacongo@42af7a65-404d-4744-a932-0658087f49c3> | 2012-10-29 21:18:51 +0000 |
commit | 228c77b4d4682c790cc0539d0fc03eb0c6bb2ea6 (patch) | |
tree | 4b4874f13f52e18e0914ea191ffe33f7f7d8f9cd /nuttx | |
parent | 5c160fad8347bee7f0df734ca7a9c263ce3e3dfe (diff) | |
download | px4-firmware-228c77b4d4682c790cc0539d0fc03eb0c6bb2ea6.tar.gz px4-firmware-228c77b4d4682c790cc0539d0fc03eb0c6bb2ea6.tar.bz2 px4-firmware-228c77b4d4682c790cc0539d0fc03eb0c6bb2ea6.zip |
Update documentation to at least reference the ELF loader.
git-svn-id: http://svn.code.sf.net/p/nuttx/code/trunk@5276 42af7a65-404d-4744-a932-0658087f49c3
Diffstat (limited to 'nuttx')
-rw-r--r-- | nuttx/Documentation/NuttX.html | 13 | ||||
-rw-r--r-- | nuttx/Documentation/NuttxPortingGuide.html | 55 | ||||
-rw-r--r-- | nuttx/configs/README.txt | 36 |
3 files changed, 92 insertions, 12 deletions
diff --git a/nuttx/Documentation/NuttX.html b/nuttx/Documentation/NuttX.html index 06b61a4de..f3f13d38a 100644 --- a/nuttx/Documentation/NuttX.html +++ b/nuttx/Documentation/NuttX.html @@ -8,7 +8,7 @@ <tr align="center" bgcolor="#e4e4e4"> <td> <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> </tr> </table> @@ -452,9 +452,16 @@ <td><br></td> <td> <p> + <li><a href="NuttXNxFlat.html">Loadable ELF Modules</a>. + Support for separately linked, loadable ELF modules. + </p> +</tr> +<tr> + <td><br></td> + <td> + <p> <li><a href="NuttXNxFlat.html">NXFLAT</a>. - A new binary format call NXFLAT that can be used to - execute separately linked programs in place in a file system. + NXFLAT is a binary format that can be XIP from a file system. </p> </tr> <tr> diff --git a/nuttx/Documentation/NuttxPortingGuide.html b/nuttx/Documentation/NuttxPortingGuide.html index 96c301295..dd9d66881 100644 --- a/nuttx/Documentation/NuttxPortingGuide.html +++ b/nuttx/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@ <h1><big><font color="#3c34ec"> <i>NuttX RTOS Porting Guide</i> </font></big></h1> - <p>Last Updated: October 20, 2012</p> + <p>Last Updated: October 29, 2012</p> </td> </tr> </table> @@ -4071,11 +4071,6 @@ build If set, all sockets will appear to be closed in the new task. </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_SCHED_WORKQUEUE</code>: Create a dedicated "worker" thread to handle delayed processing from interrupt handlers. This feature is required for some drivers but, if there are not complaints, @@ -4145,6 +4140,54 @@ build </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> System Logging: </p> <ul> diff --git a/nuttx/configs/README.txt b/nuttx/configs/README.txt index 4f96dc325..7caffa2bf 100644 --- a/nuttx/configs/README.txt +++ b/nuttx/configs/README.txt @@ -371,9 +371,6 @@ defconfig -- This is a configuration file similar to the Linux CONFIG_SDCLONE_DISABLE. Disable cloning of all socket desciptors by task_create() when a new task is started. If 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 handle delayed processing from interrupt handlers. This feature 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 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: CONFIG_SYSLOG enables general system logging support. CONFIG_SYSLOG_DEVPATH - The full path to the system logging device. Default |