From 228c77b4d4682c790cc0539d0fc03eb0c6bb2ea6 Mon Sep 17 00:00:00 2001 From: patacongo Date: Mon, 29 Oct 2012 21:18:51 +0000 Subject: [PATCH] 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 --- nuttx/Documentation/NuttX.html | 13 +++-- nuttx/Documentation/NuttxPortingGuide.html | 55 +++++++++++++++++++--- 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 06b61a4de5..f3f13d38a2 100644 --- a/nuttx/Documentation/NuttX.html +++ b/nuttx/Documentation/NuttX.html @@ -8,7 +8,7 @@

NuttX RTOS

-

Last Updated: September 29, 2012

+

Last Updated: October 29, 2012

@@ -448,13 +448,20 @@
  • ROMFS filesystem support.

    • + +
    + +

    +

  • Loadable ELF Modules. + Support for separately linked, loadable ELF modules. +

    +

  • NXFLAT. - 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.

    diff --git a/nuttx/Documentation/NuttxPortingGuide.html b/nuttx/Documentation/NuttxPortingGuide.html index 96c3012952..dd9d66881f 100644 --- a/nuttx/Documentation/NuttxPortingGuide.html +++ b/nuttx/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@

    NuttX RTOS Porting Guide

    -

    Last Updated: October 20, 2012

    +

    Last Updated: October 29, 2012

    @@ -4070,11 +4070,6 @@ build 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 file system (see apps/examples/nxflat). -
  • CONFIG_SCHED_WORKQUEUE: Create a dedicated "worker" thread to handle delayed processing from interrupt handlers. This feature @@ -4144,6 +4139,54 @@ build
    • +

    + Binary Loaders: +

    + +

    System Logging:

    diff --git a/nuttx/configs/README.txt b/nuttx/configs/README.txt index 4f96dc325b..7caffa2bf1 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