Provided by: gdb-avr_7.6-1_amd64 bug

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