run(1)

💖 run(1) — Simulator Front-End 💖

okay so bestie, welcome to run, a manual page from GNU Tools and honestly? she's giving ✨time machine✨ energy. this is run(1), the simulator front-end, and she's about to let you run whole binaries on your own laptop like it's no big deal 💅

🌸 SYNOPSIS 🌸

run    [-v] [-p freq] [-m memory] [--sysroot filepath] program

like. that's it. that's the whole vibe. you hand her a program and some optional little flags and she goes 🦋

✨ DESCRIPTION ✨

so here's the tea: you type run program and she executes a binary by interpreting machine instructions on your host computer. no cap. your actual computer, pretending to be some other computer. iconic behavior honestly 🎀

and listen — run is literally the same emulator that GDB uses behind the scenes with its target sim command. same girl, different outfit 👑

you can just execute run directly if all you wanna do is watch your program execute and you do not need any debugger functionality. no breakpoints, no stepping, just vibes and execution 🔥

you can also use run to generate profiling information for analysis with gprof. so like, she does data too. multi-talented 💜

🌈 OPTIONS 🌈

• -v — Verbose output, bestie! She's gonna talk. Before execution she displays the name of the program to run. After execution she displays: the number of instructions executed, the number of machine cycles emulated, the number of pipeline stalls, the real time taken, the emulated execution time taken, and a summary of how much profiling information was generated. that's a whole report card fr fr 😭
• -p freq — Generate profile information (for use with gprof). Here freq is the profiling frequency. The profiling information gets written out to a file called gmon.out. so cute, so organized 📁✨
• -m memory — Set the memory size for the emulated machine to two to the power memory. The default value is 19, which emulates a board with 524288 bytes of memory. yes bestie, that's a real number, she said it with her whole chest 💀
• --sysroot filepath — Prepend filepath to all simulator system calls that pass absolute file paths. Also changes the working directory to filepath at program start. ⚠️ Not all simulators support this option — those that don't will just ignore it. so don't be shocked if she ghosts you 🙈

🫶 SEE ALSO 🫶

• the gprof entry in info
• the gdb entry in info
• Using GDB: A Guide to the GNU Source-Level Debugger, by Richard M. Stallman and Roland H. Pesch

go read those too, iykyk 📚💖

👑 COPYING 👑

Copyright (c) 1993, 2000 Free Software Foundation, Inc.

This document is distributed under the terms of the GNU Free Documentation License, version 1.1. That license is described in the sources for this manual page, but it is not displayed here in order to make this manual more consise. Copies of this license can also be obtained from:

http://www.gnu.org/copyleft/

legal stuff but make it cute. she's free, she's documented, she's licensed. periodt 💅

and that's the whole page bestie!! 🌈✨ this was GNU Tools, 13oct1993, and you just read run(1). slay, go emulate something, mwah 💖🦋🎀