nuttx

History

Jiuzhu Dong de1c184e6c boards/sim: support rc.sysinit Follow: http://glennastory.net/boot/sysinit.html This is first script that init runs is rc.sysinit. This script does serval initialization tasks about basic service. The boot sequence currently provided to the board level is: board_earlyinitialize-> board_lateinitialize(Peripherals driver, core driver, ...)-> run rcS script(mount fs, run service) -> board_appinitialize-> After this patch: The boot sequence currently provided to the board level is: board_earlyinitialize-> board_lateinitialize(core driver,...)-> run rc.sysinit script(mount fs, run core service) -> board_appinitialize(Peripherals driver)-> run rcS script(run other service)-> So, Peripheral drivers can do more with the file system and core services. Signed-off-by: Jiuzhu Dong <dongjiuzhu1@xiaomi.com>		2022-04-21 12:54:53 +03:00
..
board.h	Update to avoid divide by zero issue for RX65N	2020-09-29 21:40:04 +01:00
README.TXT	boards/sim: support rc.sysinit	2022-04-21 12:54:53 +03:00
rx65n_gpio.h	Add RX65N SPI (RSPI) driver support	2020-09-29 09:09:55 -03:00

README.TXT

README
======

Overview
--------
This directory contains logic to support a custom ROMFS system-init script
and start-up script. These scripts are used by by the NSH when it starts
provided that CONFIG_NSH_ARCHROMFS=y. These scripts provide a ROMFS volume
that will be mounted at /etc and will look like this at run-time:

NuttShell (NSH) NuttX-8.2
nsh> ls -l /etc
/etc:
dr-xr-xr-x 0 .
-r--r--r-- 20 group
dr-xr-xr-x 0 init.d/
-r--r--r-- 35 passwd
/etc/init.d:
dr-xr-xr-x 0 ..
-r--r--r-- 110 rcS
-r--r--r-- 110 rc.sysinit
nsh>

/etc/init.d/rc.sysinit is system init script; /etc/init.d/rcS is the start-up
script; /etc/passwd is a the password file. It supports a single user:

USERNAME: admin
PASSWORD: Adminstrator

nsh> cat /etc/passwd
admin:8Tv+Hbmr3pLddSjtzL0kwC:0:0:/

The encrypted passwords in the provided passwd file are only valid if the
TEA key is set to: 012345678 9abcdef0 012345678 9abcdef0. Changes to either
the key or the password word will require regeneration of the nsh_romfimg.h
header file.

The format of the password file is:

user:x:uid:gid:home

Where:
user: User name
x: Encrypted password
uid: User ID (0 for now)
gid: Group ID (0 for now)
home: Login directory (/ for now)

/etc/group is a group file. It is not currently used.

nsh> cat /etc/group
root:*:0:root,admin

The format of the group file is:

group:x:gid:users

Where:
group: The group name
x: Group password
gid: Group ID
users: A comma separated list of members of the group

Updating the ROMFS File System
------------------------------
The content on the nsh_romfsimg.h header file is generated from a sample
directory structure. That directory structure is contained in the etc/ directory and can be modified per the following steps:

1. Change directory to etc/:

cd etc/

2. Make modifications as desired.

3. Create the new ROMFS image.

genromfs -f romfs_img -d etc -V SimEtcVol

4. Convert the ROMFS image to a C header file

xxd -i romfs_img >nsh_romfsimg.h

5. Edit nsh_romfsimg.h, mark both data definitions as 'const' so that
that will be stored in FLASH.