https://github.com/fox-archives/dockerized-mars

Configuration for spinning up MIPS Assembly and Runtime Simulator (MARS) in a Docker container
https://github.com/fox-archives/dockerized-mars

docker mips mips-assembly mips-simulator

Last synced: 3 months ago
JSON representation

Configuration for spinning up MIPS Assembly and Runtime Simulator (MARS) in a Docker container

• Host: GitHub
• URL: https://github.com/fox-archives/dockerized-mars
• Owner: fox-archives
• License: other
• Archived: true
• Created: 2019-09-11T06:37:46.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-01-20T08:11:18.000Z (almost 2 years ago)
• Last Synced: 2024-10-12T02:07:15.877Z (3 months ago)
• Topics: docker, mips, mips-assembly, mips-simulator
• Language: Dockerfile
• Homepage:
• Size: 3.71 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: license

Awesome Lists containing this project

README

        
# Dockerized MARS

## Introduction

The MIPS Assembler and Runtime Simulator (MARS) is a good program for running (simulated) MIPS assemby code. If you want to get it up and running quickly (without installing Java on your host system), this is the tool for you. It contains configuration used to spin up MARS in a Docker container, whether you are running on GNU/Linux, macOS, or Windows.

## Notes

If you are on GNU/Linux, this will only work if you are running an Xorg display server on your host machine. (Wayland and Mir are not directly supported).

**Important**, the MARS program will only be able to see assembly programs that are contained in the `./dockerized-mars` directory. You will *not* be able to browse for files that are just anywhere on your computer. This is because we are [bind mounting](https://docs.docker.com/storage/bind-mounts) the [`./dockerized-mars` directory](https://github.com/eankeen/dockerized-mars/blob/8c19a71b7317b2c915d27be84f22470d2acfbff9/start.sh#L15) into the Docker container.

## Setup

Docker [must be installed](https://docs.docker.com/install).

```sh

git clone https://github.com/eankeen/dockerized-mars

cd dockerized-mars

chmod +x ./start.sh

sudo ./start.sh

```

Running `start.sh` as sudo is required because connecting to the Docker daemon socket requires superuser privileges.