run(1) GNU Tools run(1)NAME
run—Simulator front-end
SYNOPSIS
run [-v] [-p freq] [-m memory] [--sysroot filepath] program
DESCRIPTION
Use `run program' to execute a binary by interpreting machine instruc‐
tions on your host computer.
run is the same emulator used by GDB's `target sim' command. You can
run it directly by executing run if you just want to see your program
execute, and do not need any debugger functionality. You can also use
run to generate profiling information for analysis with gprof.
OPTIONS-v Verbose output. Display the name of the program to run before
execution; after execution, display 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.
-p freq
Generate profile information (for use with gprof). freq is the
profiling frequency. Write the profiling information to a file
called gmon.out.
-m memory
Set the memory size for the emulated machine to two to the power
memory. The default value is 19, emulating a board with 524288
bytes of memory.
--sysroot filepath
Prepend filepath to all simulator system calls that pass abso‐
lute file paths. Change working directory to filepath at pro‐
gram start. Not all simulators support this option; those that
don't, will ignore it.
SEE ALSO
`gprof' entry in info; `gdb' entry in info; Using GDB: A Guide to the
GNU Source-Level Debugger, Richard M. Stallman and Roland H. Pesch.
COPYING
Copyright (c) 1993, 2000 Free Software Foundation, Inc.
This document is distributed under the terms of the GNU Free Documenta‐
tion 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/.
GNU Tools 13oct1993 run(1)