Disassembling RISC OS ARM code on other systems

by gerph 14 days ago

macOS ◆ xterm-256color ◆ fish 38 views

Disassembling ARM code on RISC OS is easy enough, but doing so on other systems is a little harder. The riscos-disassemble-python repository provides a disassembler which decodes in a similar style to RISC OS, and knows about RISC OS SWI naming. The repository was created out of the RISC OS Pyromaniac work, and is available for installation anywhere there is a Python. To install, use pip3 install riscos-disassemble. The command riscos-dumpi can be used to display the contents of binaries.

This recording shows the disassembly of two small test utilities - one which prints ‘hello world’ and one which reports the OS version. These demonstrate the decoding of some constants, strings and the SWI names.

The final disassembly is of the Hexen game binary, using the filtering to limit to only a single function. This also demonstrates the function name decoding for entry points and branches, constant values and bit decoding, and the recognition of a branch table.

More by gerph

Showing that IPv4 and IPv6 addresses and connections work in Pyromaniac 00:53

by gerph 4 years ago

Playing Snake with Pyromaniac 00:46

by gerph 4 years ago

Creating a changelog entry with changelog-management 01:14

by gerph 4 months ago

Pyromaniac using 'ansitext' VDU implementation 01:02

by gerph 4 years ago

See all

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 656346.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/656346.cast',
      document.getElementById('player'),
      { cols: 116, rows: 48 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't offer GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed run the following command to create GIF file:

agg https://asciinema.org/a/656346 656346.gif

Or, if you already downloaded the recording file:

agg 656346.cast 656346.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.