From 8f66f424602e26f0a43a62beaa3c2aec7775c890 Mon Sep 17 00:00:00 2001 From: patacongo Date: Tue, 8 Mar 2011 00:27:35 +0000 Subject: Add support for platoform specific ROMFS startup files git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3350 42af7a65-404d-4744-a932-0658087f49c3 --- nuttx/Documentation/NuttShell.html | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) (limited to 'nuttx/Documentation') diff --git a/nuttx/Documentation/NuttShell.html b/nuttx/Documentation/NuttShell.html index 87e8592e9..e03aadc7f 100644 --- a/nuttx/Documentation/NuttShell.html +++ b/nuttx/Documentation/NuttShell.html @@ -8,7 +8,7 @@

NuttShell (NSH)

-

Last Updated: March 1, 2011

+

Last Updated: March 7, 2011

@@ -580,9 +580,8 @@ mount -t vfat /dev/ram1 /tmp

Modifying the ROMFS Image. - The contents of the /etc directory are retained in the file - examples/nsh/nsh_romfsimg.h. In order to modify the start-up - behavior, there are three things to study: + The contents of the /etc directory are retained in the file examples/nsh/nsh_romfsimg.h OR, if CONFIG_EXAMPLES_NSH_ARCHROMFS is defined, include/arch/board/rcs.template). + In order to modify the start-up behavior, there are three things to study:

  1. Configuration Options. @@ -591,30 +590,37 @@ mount -t vfat /dev/ram1 /tmp

  2. - mkromfsimg.sh Script. - The script examples/nsh/mkromfsimg.sh creates nsh_romfsimg.h. + tools/mkromfsimg.sh Script. + The script tools/mkromfsimg.sh creates nsh_romfsimg.h. It is not automatically executed. If you want to change the configuration settings associated with creating and mounting the /tmp directory, then it will be necessary to re-generate - this header file using the mkromfsimg.sh script. + this header file using the tools/mkromfsimg.sh script.

    The behavior of this script depends upon three things:

    • The configuration settings then installed configuration.
    • The genromfs tool (available from http://romfs.sourceforge.net). -
    • The file examples/nsh/rcS.template. +
    • The file examples/nsh/rcS.template + (OR, if CONFIG_EXAMPLES_NSH_ARCHROMFS is defined include/arch/board/rcs.template.

  3. rcS.template. The file examples/nsh/rcS.template contains the general form - of the rcS file; configurated values are plugged into this + of the rcS file; configured values are plugged into this template file to produce the final rcS file.

+

+ NOTE: + examples/nsh/rcS.template generates the standard, default nsh_romfsimg.h file. + If CONFIG_EXAMPLES_NSH_ARCHROMFS is defined in the NuttX configuration file, then a custom, board-specific nsh_romfsimg.h file residing in configs/<board>/include will be used. + NOTE when the OS is configured, include/arch/board will be linked to configs/<board>/include. +

All of the startup-behavior is contained in rcS.template. The role of mkromfsimg.sh is to (1) apply the specific configuration @@ -2254,6 +2260,12 @@ nsh> Configuration Description + + CONFIG_EXAMPLES_NSH_ARCHROMFS + + May be defined to specify an alternative ROMFS image that can be found at configs/<board>/include/nsh_romfsimg.h. + + CONFIG_EXAMPLES_NSH_ROMFSMOUNTPT @@ -2353,6 +2365,7 @@ nsh>

  • CONFIG_EXAMPLES_NSH_NOMAC
  • CONFIG_EXAMPLES_NSH_ROMFSDEVNO
  • CONFIG_EXAMPLES_NSH_ROMFSETC
    • +
  • CONFIG_EXAMPLES_NSH_ARCHROMFS
  • CONFIG_EXAMPLES_NSH_ROMFSMOUNTPT
  • CONFIG_EXAMPLES_NSH_ROMFSSECTSIZE
  • CONFIG_EXAMPLES_NSH_STACKSIZE
    • -- cgit v1.2.3