arm-rtems-run

run(1)                             GNU Tools                            run(1)



NAME
       run—Simulator front-end


SYNOPSIS
       run    [-v] [-p freq] [-m memory] program

DESCRIPTION
       Use `run program' to execute a binary by interpreting machine
       instructions 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.


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
       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/.


















































































































































































































































































































































































GNU Tools                          13oct1993                            run(1)