sim/common/run.1

   1 .\" Copyright (c) 1993 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .TH run 1 "13oct1993" "GNU Tools" "GNU Tools"
   4 .de BP
   5 .sp
   6 .ti -.2i
   7 \(**
   8 ..
   9
  10 .SH NAME
  11 run\(em\&Simulator front-end
  12
  13 .SH SYNOPSIS
  14 .hy 0
  15 .na
  16 .TP
  17 .B run
  18 .RB "[\|" \-v "\|]"
  19 ." .RB "[\|" \-t "\|]"
  20 .RB "[\|" \-p
  21 .IR freq "\|]"
  22 .RB "[\|" \-m
  23 .IR memory "\|]"
  24 .I program
  25 .ad b
  26 .hy 1
  27 .SH DESCRIPTION
  28
  29 Use `\|\c
  30 .BI run " program"\c
  31 \&\|' to execute a binary by interpreting machine instructions on your
  32 host computer.
  33
  34 .B run
  35 is the same emulator used by GDB's `\|\c
  36 .B target sim\c
  37 \&\|' command.  You can run it directly by executing
  38 .B run
  39 if you just want to see your program execute, and do not need any
  40 debugger functionality.  You can also use
  41 .B run
  42 to generate profiling information for analysis with
  43 .BR gprof .
  44
  45 .SH OPTIONS
  46
  47 .TP
  48 .B \-v
  49 Verbose output.  Display the name of the program to run before
  50 execution; after execution, display the number of instructions
  51 executed, the number of machine cycles emulated, the number of
  52 pipeline stalls, the real time taken, the emulated execution time
  53 taken, and a summary of how much profiling information was generated.
  54 ."
  55 ." .TP
  56 ." .B \-t
  57 ." `trace', calls a sim_trace routine that does nothing.
  58
  59 .TP
  60 .BI \-p " freq"
  61 Generate profile information (for use with
  62 .B gprof\c
  63 \&).
  64 .I freq
  65 is the profiling frequency.  Write the profiling information to a file called
  66 .BR gmon.out .
  67
  68 .TP
  69 .BI \-m " memory"
  70 Set the memory size for the emulated machine to two to the power
  71 .IR memory .
  72 The default value is 19, emulating a board with 524288 bytes of memory.
  73
  74 .PP
  75
  76 .SH "SEE ALSO"
  77 .RB "`\|" gprof "\|'"
  78 entry in
  79 .B info\c
  80 \&;
  81 .RB "`\|" gdb "\|'"
  82 entry in
  83 .B info\c
  84 \&;
  85 .I
  86 Using GDB: A Guide to the GNU Source-Level Debugger\c
  87 , Richard M. Stallman and Roland H. Pesch.
  88
  89 .SH COPYING
  90 Copyright (c) 1993 Free Software Foundation, Inc.
  91 .PP
  92 Permission is granted to make and distribute verbatim copies of
  93 this manual provided the copyright notice and this permission notice
  94 are preserved on all copies.
  95 .PP
  96 Permission is granted to copy and distribute modified versions of this
  97 manual under the conditions for verbatim copying, provided that the
  98 entire resulting derived work is distributed under the terms of a
  99 permission notice identical to this one.
 100 .PP
 101 Permission is granted to copy and distribute translations of this
 102 manual into another language, under the above conditions for modified
 103 versions, except that this permission notice may be included in
 104 translations approved by the Free Software Foundation instead of in
 105 the original English.
 106
 107