From: Steve Chamberlain Date: Thu, 28 Sep 1995 22:42:28 +0000 (+0000) Subject: Thu Sep 28 15:40:36 1995 steve chamberlain X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=7bf1bbbc92772c7a45910aa1ca325769aedb2255;p=binutils-gdb.git Thu Sep 28 15:40:36 1995 steve chamberlain * run.c, run.1: From sh directory. --- diff --git a/sim/common/.Sanitize b/sim/common/.Sanitize new file mode 100644 index 00000000000..db7d99cdcb1 --- /dev/null +++ b/sim/common/.Sanitize @@ -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. diff --git a/sim/common/run.1 b/sim/common/run.1 new file mode 100644 index 00000000000..ef60a622d74 --- /dev/null +++ b/sim/common/run.1 @@ -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. + +