Skip to content

rocketsh

Brain edited this page May 3, 2023 · 10 revisions

rocketsh

The interactive shell used to execute commands and run programs. Launched by init.

image

Rocket Shell Commands

The rocketsh shell supports two forms of input; firstly any command you type is searched for as a program under the /programs directory. If it can be found it is executed. The path under which rocketsh searches for programs to run can be changed, as shown below.

If no matching program can be found, the line is passed to EVAL instead and any changes to the program state will be inherited by rocketsh, including documented variables below.

Shell Variables

The rocketsh shell has several documented variables, which can be set via the command prompt. These are:

PROMPT$

Change PROMPT$ to change the shell prompt from the default of ROCKETSH to the specified value. ANSI escape sequences are supported. You can use CHR$(27) to insert the escape chracter:

PROMPT$ = CHR$(27) + "[31mRED PROMPT" + CHR$(27) + "[37m"

and this will set the shell prompt to dark red:

image

PATH$

The directory to search in for programs ran at the command prompt. It defaults to /programs.

PATH$ = "/harddisk/progs"
GLOBAL LIB$

The GLOBAL variable LIB$ is the path that programs will use to load libraries from within BASIC. It defaults to /programs/libraries and is set from within /programs/init and passed down to rocketsh.

You must remember the GLOBAL prefix if you wish for this value to be inherited by BASIC programs.

GLOBAL LIB$ = "/harddisk/progs/lib"
Clone this wiki locally