Commit | Line | Data |
---|---|---|
7bf1bbbc SC |
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\&Hitachi SH emulator | |
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 Hitachi SH binary by interpreting SH machine | |
32 | instructions on your 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 |