85 lines
2.2 KiB
Plaintext
85 lines
2.2 KiB
Plaintext
|
README
|
||
|
|
======
|
||
|
|
|
||
|
|
Overview
|
||
|
|
--------
|
||
|
|
This directory contains logic to support a custom ROMFS start-up script.
|
||
|
|
This startup script is used by by the NSH when it starts provided that
|
||
|
|
CONFIG_NSH_ARCHROMFS=y. The script provides 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
|
||
|
|
nsh>
|
||
|
|
|
||
|
|
/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.
|
||
|
|
|