cli.html

CLI (Shell)

I wrote a shell for use with OZONE. Basically, it contains a bunch of commands that access the system calls almost one-for-one, but is rich enough for production use.

Theoretically, one could port something like bash, but it has a lot of funky termios and fcntl and signal calls. Gaaaaahaaaaahaaaad!

These commands run as a subroutine of the main cli thread:

abort thread [-id <thread_id>] [-nowait] [-status <status>] [<thread_logical_name>]
create event <logical_name>
create logical name [-kernel] [-nooutermode] [-nosupersede] <logical_name> [-copy <logical_name>] [-link <logical_name>] [-object <handle>] [-terminal] <value> ...
create logical table [-kernel] [-nooutermode] [-nosupersede] <table_name>
create symbol [-global] [-integer] [-level <n>] [-string] <name> <value> ...
delete logical name <logical_name>
delete logical table <table_name>
exit [<status>]
goto <label>
if <integervalue> <statement ...>
reboot
resume thread [-id <thread_id>] [<thread_logical_name>]
run [-directory <default_directory>] [-error <error_file>] [-exit <exit_event_flag>] [-init <init_event_flag>] [-input <input_file>] [-job <job_logical>] [-nowait] [-output <output_file>] [-process <process_logical>] [-thread <thread_logical>] <image_name> <args> ...
script <script_name> [<args> ...]
set default <directory>
show default
suspend thread [-id <thread_id>] [<thread_logical_name>]
wait event <logical_name> ...
wait thread [-id <thread_id>] [<thread_logical_name>]

These commands run as a forked thread within the cli process:

close handle <handle> ...
create file [-lockmode <lockmode>] [-logical <logical_name>] <file_name>
create mutex <iochan_logical_name> <mutex_device_name> <mutex_name>
echo <string> ...
help
more [-columns <number>] [-number] [-rows <number>] [<file>]
open file [-lockmode <lockmode>] [-logical <logical_name>] <file_name>
open mutex <iochan_logical_name> <mutex_device_name> <mutex_name>
read file [-logical <logical_name>] [-prompt <prompt>] [-size <size>] [-terminator <terminator>] <symbol_name>
set mutex [-express] [-noqueue] <iochan_logical_name> <new_mode>
show datetime
show device [<device_logical_name> ...] [-iochans]
show iochan [<iochan_logical_name> ...]
show job [<job_logical_name> ...] [-processes] [-threads]
show logical name <logical_name>
show logical table [<table_name>]
show mutex <iochan_logical_name>
show process [<process_logical_name> ...] [-threads]
show symbol [<symbol_name> ...]
show system
show thread [-id <thread_id>] [<thread_logical_name> ...]
show user [<user_logical_name> ...] [-jobs] [-processes] [-threads]
show volume [<device_name> ...]
wait mutex <iochan_logical_name>
wait until <datetime>

Substitution of variables occurrs between braces as in {varname}. There are also functions available, a show symbol command will display a list.

Commands can be piped together using |>.

All of the above commands can be prefixed with the following:

-error <error_file>
-input <input_file>
-output <output_file>

Those ones that get forked as a thread can be prefixed with these in addition:

-exit <exit_event_flag>
-init <init_event_flag>
-nowait
-thread <thread_logical>

External commands (see the utilities page) run as spawned processes. They are defined by creating a name in the OZ_CLI_TABLES logical name table that points to the image to be executed. The command can be prefixed with any of the above and with the following:

-debug
-directory <default_directory>
-job <job_logical>
-process <process_logical>