---
name: "mips64emul"
section: "1"
platform: "linux"
package: "mips64emul"
version: "0.2.4-1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/mips64emul"
---

# mips64emul(1)

## NAME

**mips64emul** -- a MIPS machine emulator

## SYNOPSIS

**mips64emul** \[ *options* \] \[ *file* \[ *...* \] \]

## DESCRIPTION

**mips64emul** is a MIPS machine emulator. The goals are to emulate MIPS-like CPUs and enough surrounding hardware to let unmodified operating systems run as if they were running on a real machine, and to assist in experiments involving MIPS-like code in general.

Run **mips64emul -h** to get a list of available command line options. You should also read the documentation provided in the **doc/** subdirectory of the **mips64emul** distribution.

For a normal invocation of the emulator, you need to supply the *file* argument. This is the name of a MIPS binary file (an ELF32, ELF64, a.out, ECOFF, SREC, or a raw binary image) which you wish to run in the  emulator. This file might be an operating system kernel, or perhaps a ROM  image file.

Apart from the name of a MIPS binary, it is also necessary to select which specific emulation mode to use. For example, a MIPS-based machine from DEC (a DECstation) is very different from a MIPS-based machine from SGI.

(There is an exception to the normal invocation usage mentioned above; if you want to use the DECstation emulation mode, and have a bootable DECstation harddisk or CDROM image, then just supplying the diskimage via  the -d option is sufficient. The filename of the kernel can then be  skipped, as the emulator runs the bootblocks from the diskimage directly and  doesn't need the kernel as a separate file.)

## EXAMPLES

The following command will start NetBSD/pmax on an emulated DECstation  5000/200, with dynamic binary translation enabled:

```
	mips64emul -D2 -b -d netbsddisk.img
```

netbsddisk.img should be a raw disk image containing a NetBSD/pmax filesystem.

Please read the documentation for more details.

## AUTHOR

Anders Gavare \<anders@gavare.se\>

See http://gavare.se/mips64emul/ for more information.