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 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  exe-
	      cuted, 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 absolute file paths.  Change  working  directory  to  filepath  at  program
	      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 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)