Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/benesch/homebrew-os161
homebrew formulae for system/161 and os/161
https://github.com/benesch/homebrew-os161
homebrew os161
Last synced: about 1 month ago
JSON representation
homebrew formulae for system/161 and os/161
- Host: GitHub
- URL: https://github.com/benesch/homebrew-os161
- Owner: benesch
- Created: 2015-04-17T05:57:03.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-27T03:13:51.000Z (almost 7 years ago)
- Last Synced: 2024-10-14T10:16:32.164Z (2 months ago)
- Topics: homebrew, os161
- Language: Ruby
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 3
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# homebrew-os161
[Homebrew] formulae for installing [System/161] and an [OS/161]
cross-compiling toolchain on OS X.
**Supported versions:**
* System/161 2.0.8
* OS/161 2.0.2
* Binutils 2.24+os161-2.1
* GCC 4.8.3+os161-2.1
* GDB 7.8+os161-2.1
These packages are downloaded from the [official Harvard
sources][161-download].
## Quick start
With [Homebrew] installed, run
```bash
$ brew tap benesch/os161
$ brew install os161-toolchain
```
then follow the standard OS/161 spinup guide.
## Detailed installation instructions
### Homebrew tap
Install Homebrew from http://brew.sh if you don't have it already.
Then, add this repository as a [custom tap] so Homebrew can find the
OS161-specific formula:
```bash
$ brew tap benesch/os161
```
### System/161
First, install the System/161 MIPS simulator.
```bash
$ brew install sys161
```
At this point, `sys161` will be available in your PATH and runnable. A
sample `sys161.conf` is installed to:
/usr/local/share/examples/sys161/sys161.conf.sample
### GCC
Then, you need a cross-compiling GCC capable of building executables for
System/161:
```bash
$ brew install os161-gcc
```
This will install a GCC toolchain prefixed with `mips-harvard-os161-`
into your PATH. This means that directly invoking GCC is rather
annoying, as `mips-harvard-os161-gcc` is a lot to type. You'll rarely
need to invoke the compiler directly, though; the OS/161 Makefiles will
do this for you.
### GDB
You'll almost certainly want a GDB capable of debugging executables
built for System/161:
```bash
$ brew install os161-gdb
```
This installs `mips-harvard-os161-gdb`. Since you'll be invoking this
command manually quite a bit, this automatically installs a shorter
alias, `os161-gdb`.
## OS/161
To set up stock OS/161 in a nutshell:
```bash
# Obtain sources
$ wget http://os161.eecs.harvard.edu/download/os161-base-2.0.3.tar.gz
$ tar xf os161-base-2.0.3.tar.gz
# Build userland
$ cd os161-base-2.0.3
$ ./configure
$ bmake
$ bmake install
# Build kernel
$ cd kern/conf
$ ./config DUMBVM
$ cd ../compile/DUMBVM
$ bmake depend
$ bmake
$ bmake install
# Run kernel
$ cd ~/os161/root
$ cp /usr/local/share/examples/sys161/sys161.conf.sample sys161.conf
$ sys161 kernel
```
See the [OS/161 guides and resources] for next steps.
[Homebrew]: http://brew.sh
[System/161]: http://os161.eecs.harvard.edu/#sys161
[OS/161]: http://os161.eecs.harvard.edu/
[OS/161 guides and resources]: http://os161.eecs.harvard.edu/resources/
[161-download]: http://os161.eecs.harvard.edu/download/
[custom tap]: https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/brew-tap.md