An open API service indexing awesome lists of open source software.

https://github.com/jrodal98/xv6-docker

Docker image for running xv6
https://github.com/jrodal98/xv6-docker

docker xv6

Last synced: 3 months ago
JSON representation

Docker image for running xv6

Awesome Lists containing this project

README

          

# xv6-docker

Docker image for compiling and running xv6 in a container.

## "Installation"

1) Recursively clone this repository

`git clone --recurse-submodules https://github.com/jrodal98/xv6-docker`

2) Enter the `xv6-docker` directory

`cd xv6-docker`

3) Build the docker image

`./xv6-container build`

## Usage

* Running `qemu-nox`:

`./xv6-container`
* Using bash shell inside container:

`./xv6-container bash`

* Debug mode (not actually tested yet, pretty sure it won't work)

`./xv6-container gdb`

### Troubleshooting

* If you get a permission denied error, run `chmod +x xv6-container`.
* Based on the way xv6-container is written, you must be in the xv6-docker directory for this to work (i.e., you can't do `../xv6-container` or `/foo/bar/xv6-container`)

* Based on the way debugging xv6 seems to work, my currently solution for debug mode is flawed. Until I get around to fixing it, do something like this instead:

```
./xv6-container bash
tmux
```
Then, use tmux to get two terminal windows, one of which will run xv6, one of which will run gdb. I'll probably get around to automating this eventually.