108 lines
2.5 KiB
Groff
108 lines
2.5 KiB
Groff
|
.\" Copyright (c) 1993 Free Software Foundation
|
||
|
|
.\" See section COPYING for conditions for redistribution
|
||
|
|
.TH run 1 "13oct1993" "GNU Tools" "GNU Tools"
|
||
|
|
.de BP
|
||
|
|
.sp
|
||
|
|
.ti -.2i
|
||
|
|
\(**
|
||
|
|
..
|
||
|
|
|
||
|
|
.SH NAME
|
||
|
|
run\(em\&Simulator front-end
|
||
|
|
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.hy 0
|
||
|
|
.na
|
||
|
|
.TP
|
||
|
|
.B run
|
||
|
|
.RB "[\|" \-v "\|]"
|
||
|
|
." .RB "[\|" \-t "\|]"
|
||
|
|
.RB "[\|" \-p
|
||
|
|
.IR freq "\|]"
|
||
|
|
.RB "[\|" \-m
|
||
|
|
.IR memory "\|]"
|
||
|
|
.I program
|
||
|
|
.ad b
|
||
|
|
.hy 1
|
||
|
|
.SH DESCRIPTION
|
||
|
|
|
||
|
|
Use `\|\c
|
||
|
|
.BI run " program"\c
|
||
|
|
\&\|' to execute a binary by interpreting machine instructions on your
|
||
|
|
host computer.
|
||
|
|
|
||
|
|
.B run
|
||
|
|
is the same emulator used by GDB's `\|\c
|
||
|
|
.B target sim\c
|
||
|
|
\&\|' command. You can run it directly by executing
|
||
|
|
.B run
|
||
|
|
if you just want to see your program execute, and do not need any
|
||
|
|
debugger functionality. You can also use
|
||
|
|
.B run
|
||
|
|
to generate profiling information for analysis with
|
||
|
|
.BR gprof .
|
||
|
|
|
||
|
|
.SH OPTIONS
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.B \-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.
|
||
|
|
."
|
||
|
|
." .TP
|
||
|
|
." .B \-t
|
||
|
|
." `trace', calls a sim_trace routine that does nothing.
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.BI \-p " freq"
|
||
|
|
Generate profile information (for use with
|
||
|
|
.B gprof\c
|
||
|
|
\&).
|
||
|
|
.I freq
|
||
|
|
is the profiling frequency. Write the profiling information to a file called
|
||
|
|
.BR gmon.out .
|
||
|
|
|
||
|
|
.TP
|
||
|
|
.BI \-m " memory"
|
||
|
|
Set the memory size for the emulated machine to two to the power
|
||
|
|
.IR memory .
|
||
|
|
The default value is 19, emulating a board with 524288 bytes of memory.
|
||
|
|
|
||
|
|
.PP
|
||
|
|
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.RB "`\|" gprof "\|'"
|
||
|
|
entry in
|
||
|
|
.B info\c
|
||
|
|
\&;
|
||
|
|
.RB "`\|" gdb "\|'"
|
||
|
|
entry in
|
||
|
|
.B info\c
|
||
|
|
\&;
|
||
|
|
.I
|
||
|
|
Using GDB: A Guide to the GNU Source-Level Debugger\c
|
||
|
|
, Richard M. Stallman and Roland H. Pesch.
|
||
|
|
|
||
|
|
.SH COPYING
|
||
|
|
Copyright (c) 1993 Free Software Foundation, Inc.
|
||
|
|
.PP
|
||
|
|
Permission is granted to make and distribute verbatim copies of
|
||
|
|
this manual provided the copyright notice and this permission notice
|
||
|
|
are preserved on all copies.
|
||
|
|
.PP
|
||
|
|
Permission is granted to copy and distribute modified versions of this
|
||
|
|
manual under the conditions for verbatim copying, provided that the
|
||
|
|
entire resulting derived work is distributed under the terms of a
|
||
|
|
permission notice identical to this one.
|
||
|
|
.PP
|
||
|
|
Permission is granted to copy and distribute translations of this
|
||
|
|
manual into another language, under the above conditions for modified
|
||
|
|
versions, except that this permission notice may be included in
|
||
|
|
translations approved by the Free Software Foundation instead of in
|
||
|
|
the original English.
|
||
|
|
|
||
|
|
|