This commit is contained in:
Kartik K. Agaram 2021-03-09 00:43:59 -08:00
parent 9586db164c
commit 7e87c36c3a
3 changed files with 18 additions and 19 deletions

View File

@ -205,8 +205,6 @@ If you're still reading, here are some more things to check out:
to SubX. Most Mu statements map to a single x86 instruction.
([colorized version](http://akkartik.github.io/mu/html/mu_instructions.html))
- [Commandline reference for the bootstrap C++ program.](bootstrap.md)
- [Some details on the unconventional organization of this project.](http://akkartik.name/post/four-repos)
- Previous prototypes: [mu0](https://github.com/akkartik/mu0), [mu1](https://github.com/akkartik/mu1).

View File

@ -7,3 +7,21 @@ b) A second translator for SubX programs that emits identical binaries to the
self-hosting versions in the parent directory. Having two diverse compilers
(one in a familiar language, one with minimal syscall surface area) that emit
identical binaries should help gain confidence in Mu.
## Running
`bootstrap` currently has the following sub-commands:
- `bootstrap help`: some helpful documentation to have at your fingertips.
- `bootstrap test`: runs all automated tests.
- `bootstrap translate <input files> -o <output ELF binary>`: translates `.subx`
files into an executable ELF binary.
- `bootstrap run <ELF binary> <args>`: simulates running the ELF binaries emitted
by `bootstrap translate`. Useful for testing and debugging.
Remember, not all 32-bit Linux binaries are guaranteed to run. I'm not
building general infrastructure here for all of the x86 instruction set.
SubX is about programming with a small, regular subset of 32-bit x86.

View File

@ -1,17 +0,0 @@
## Running
`bootstrap` currently has the following sub-commands:
- `bootstrap help`: some helpful documentation to have at your fingertips.
- `bootstrap test`: runs all automated tests.
- `bootstrap translate <input files> -o <output ELF binary>`: translates `.subx`
files into an executable ELF binary.
- `bootstrap run <ELF binary> <args>`: simulates running the ELF binaries emitted
by `bootstrap translate`. Useful for testing and debugging.
Remember, not all 32-bit Linux binaries are guaranteed to run. I'm not
building general infrastructure here for all of the x86 instruction set.
SubX is about programming with a small, regular subset of 32-bit x86.