Scroll to navigation

kaem(1) User Manuals kaem(1)

NAME

kaem - Like running with scissors but shell scripts without a shell

SYNOPSIS

kaem [--file FILE --strict --verbose --nightmare-mode]

DESCRIPTION

kaem exists to be the most minimal shell needed in the bootstrap processes; that has the ability to function as an init thus allowing the bootstrap to occur with only itself and a hex0 assembler as the only binaries running on the system.

At its core is read a line (except when the line is terminated with a '\', when it is read the next line too) and then collect the arguments into an array, lookup the program in the path provided by the name or if not found in the ENVIRONMENT and then execute the program with the specified options.

If no filename is passed, it then attempts to execute a file called kaem.run; which is the standard name for kaem scripts. If you wish for kaem to stop when one of the lines throws or returns an error code, simply add --strict. If you wish to see what is being executed, simply add --verbose. If you hate dealing with an environment and want to eliminate it entirely --nightmare-mode.

EXAMPLES

Typically, kaem will be in running scripts used in bootstrapping
# kaem --verbose --strict
# kaem -f bootstrap.sh --nightmare-mode

COMPATIBILITY

kaem is compatible with all Turing complete machines; even the ones that try to be Turing complete -1

AUTHORS

Jeremiah Orians <Jeremiah@pdp10.guru>

COPYRIGHT

Copyright 2016-2019 Jeremiah Orians <Jeremiah@pdp10.guru>
License GPLv3+.

SEE ALSO

M1(1), hex2(1), blood-elf(1), get_machine(1), syscalls(2)

JULY 2019 Linux