Thu Sep 28 15:40:36 1995 steve chamberlain <sac@slash.cygnus.com>

* run.c, run.1: From sh directory.
This commit is contained in:
Steve Chamberlain 1995-09-28 22:42:28 +00:00
parent c966ea3a50
commit 7bf1bbbc92
2 changed files with 144 additions and 0 deletions

37
sim/common/.Sanitize Normal file
View File

@ -0,0 +1,37 @@
# Sanitize.in for devo.
# $Id$
#
# Each directory to survive it's way into a release will need a file
# like this one called "./.Sanitize". All keyword lines must exist,
# and must exist in the order specified by this file. Each directory
# in the tree will be processed, top down, in the following order.
# Hash started lines like this one are comments and will be deleted
# before anything else is done. Blank lines will also be squashed
# out.
# The lines between the "Do-first:" line and the "Things-to-keep:"
# line are executed as a /bin/sh shell script before anything else is
# done in this
Do-first:
# All files listed between the "Things-to-keep:" line and the
# "Files-to-sed:" line will be kept. All other files will be removed.
# Directories listed in this section will have their own Sanitize
# called. Directories not listed will be removed in their entirety
# with rm -rf.
Things-to-keep:
run.c
run.1
ChangeLog
Things-to-lose:
Do-last:
# End of file.

107
sim/common/run.1 Normal file
View File

@ -0,0 +1,107 @@
.\" 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\&Hitachi SH emulator
.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 Hitachi SH binary by interpreting SH 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.