Subversion Repositories or1k_old

.\" 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.