Skip to content

Add hash-bench-n64 to Programming/C/Example Code#64

Open
dmang-dev wants to merge 1 commit into
command-tab:mainfrom
dmang-dev:add-hash-bench-n64
Open

Add hash-bench-n64 to Programming/C/Example Code#64
dmang-dev wants to merge 1 commit into
command-tab:mainfrom
dmang-dev:add-hash-bench-n64

Conversation

@dmang-dev
Copy link
Copy Markdown

What this PR does

Adds a single entry to Programming → C → Example Code (per CONTRIBUTING.md's "add to bottom of relevant category"):

* [hash-bench-n64](https://github.com/dmang-dev/hash-bench-n64) - Hash-algorithm benchmark ROM that times 32 cryptographic and non-cryptographic hashes (CRC, MD5, SHA-1, SHA-512, BLAKE2s, etc.) on the VR4300 and displays µs/iter and KB/s on screen, using `libdragon`

Why "Example Code"

It sits naturally next to n64zlibbench (already in the section) — same shape, just more algorithms. The other entries here are similar self-contained libdragon-using demonstrations. Not a game (no fit elsewhere), not a toolchain or library, not reverse engineering.

Project at a glance

(The README has a documented compatibility note: Project64 < 4.x rejects libdragon's custom IPL3, so Ares is recommended for emulator users.)

Checklist (per CONTRIBUTING.md)

  • In English
  • In a minimal working state (prebuilt ROM committed + downloadable from the v1.0.0 release)
  • Clear purpose (hash-algorithm performance benchmark on VR4300)
  • Documentation present (README explains every algorithm, build, run, controls, the SHA-512>SHA-256 finding)
  • Entry uses the existing section's bullet style (* not -, no trailing period)
  • Added to the bottom of an existing section

Disclosure

I'm the author.

A libdragon-based ROM that times 32 hash algorithms on the VR4300 and
displays microseconds-per-iteration and KB/s on screen across two
sort modes and a buffer-size sweep.  Sits naturally next to
n64zlibbench (already in the section) — same idea, more algorithms,
notably including SHA-512 which beats SHA-256 on N64 thanks to the
VR4300 being the only 64-bit-native CPU in the family.

- Repo: https://github.com/dmang-dev/hash-bench-n64
- v1.0.0 release with prebuilt 1 MiB .z64:
  https://github.com/dmang-dev/hash-bench-n64/releases/tag/v1.0.0
- License: MIT
- Built with: libdragon

Tested in Ares 1.x and mupen64plus.  Project64 < 4.x rejects
libdragon's custom IPL3 (documented in the README).

I'm the author.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant