Warning: Attempt to read property "date" on null in /usr/local/www/websvn.planix.org/blame.php on line 247

Warning: Attempt to read property "msg" on null in /usr/local/www/websvn.planix.org/blame.php on line 247
WebSVN – planix.SVN – Blame – /os/branches/feature-vt/sys/man/1/vi – Rev 2

Subversion Repositories planix.SVN

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH VI 1
2 
.SH NAME
3 
5i, ki, vi, qi \- instruction simulators
4 
.SH SYNOPSIS
5 
.B vi
6 
[
7 
.I textfile
8 
]
9 
.br
10 
.B vi
11 
.I pid
12 
.br
13 
.B 5i
14 
[
15 
.I textfile
16 
]
17 
.br
18 
.B 5i
19 
.I pid
20 
.br
21 
.B ki
22 
[
23 
.I textfile
24 
]
25 
.br
26 
.B ki
27 
.I pid
28 
.br
29 
.B qi
30 
[
31 
.I textfile
32 
]
33 
.br
34 
.B qi
35 
.I pid
36 
.SH DESCRIPTION
37 
.I Vi
38 
simulates the execution of a MIPS binary in
39 
a Plan 9 environment.
40 
It has two main uses: as
41 
a debugger and as a statistics gatherer.
42 
Programs running under
43 
.I vi
44 
execute about two hundred times
45 
slower than normal\(embut faster than
46 
single stepping under
47 
.IR db .
48 
.IR 5i ,
49 
.IR ki ,
50 
and
51 
.IR qi
52 
are similar to
53 
.I vi
54 
but interpret ARM, SPARC, and PowerPC binaries.
55 
The following discussion refers to
56 
.I vi
57 
but applies to the others
58 
as well.
59 
.PP
60 
.I Vi
61 
will simulate the execution of a named
62 
.IR textfile .
63 
It will also make a copy of an existing process with process id
64 
.I pid
65 
and simulate its continuation.
66 
.PP
67 
As a debugger
68 
.I vi
69 
offers more complete information
70 
than
71 
.IR db (1).
72 
Tracing can be performed at the level of instructions,
73 
system calls, or function calls.
74 
.I Vi
75 
allows breakpoints to be triggered when specified addresses
76 
in memory are accessed.
77 
A report of instruction counts,
78 
load delay fills and distribution is produced for
79 
each run.
80 
.I Vi
81 
simulates the CPU's caches and MMU
82 
to assist the optimization of compilers and programs.
83 
.PP
84 
The command interface mirrors the interface to
85 
.IR db ;
86 
see
87 
.IR db (1)
88 
for a detailed description.
89 
Data formats and addressing are compatible with
90 
.I db
91 
except
92 
for disassembly:
93 
.I vi
94 
offers only MIPS
95 
.RB ( db
96 
.BR -mmipsco )
97 
mnemonics for
98 
machine instructions.
99 
.I Ki
100 
offers both Plan 9 and Sun SPARC formats.
101 
.PP
102 
Several extra commands allow
103 
extended tracing and printing of statistics:
104 
.TP
105 
.BR $t [ 0ics ]
106 
The
107 
.I t
108 
command controls tracing. Zero cancels all tracing
109 
options.
110 
.RS
111 
.TP
112 
.B i
113 
Enable instruction tracing
114 
.TP
115 
.B c
116 
Enable call tracing
117 
.TP
118 
.B s
119 
Enable system call tracing
120 
.RE
121 
.TP
122 
.BR $i [ itsp ]
123 
The
124 
.B i
125 
command prints statistics accumulated by
126 
all code run in this session.
127 
.RS
128 
.TP
129 
.B i
130 
Print instruction counts and frequency.
131 
.TP
132 
.B p
133 
Print cycle profile.
134 
.TP
135 
.B t
136 
.RI ( Vi
137 
only) Print TLB and cache statistics.
138 
.TP
139 
.B s
140 
Print memory reference, working set and size statistics.
141 
.RE
142 
.TP
143 
.BR :b [ arwe ]
144 
.I Vi
145 
allows breakpoints to be set on any memory location.
146 
These breakpoints monitor when a location is
147 
accessed, read, written, or equals a certain value.
148 
For equality the compared value is the
149 
.I count
150 
(see
151 
.IR db (1))
152 
supplied to the command.
153 
.SH SOURCE
154 
.B /sys/src/cmd/vi
155 
etc.
156 
.SH "SEE ALSO"
157 
.IR nm (1),
158 
.IR db (1)
159 
.SH BUGS
160 
The code generated by
161 
the compilers
162 
is well supported, but some unusual instructions are unimplemented.
163 
Some Plan 9 system calls such as
164 
.I rfork
165 
cause simulated traps.
166 
The floating point simulation makes assumptions about the interpreting
167 
machine's floating point support. The floating point conversions performed
168 
by
169 
.I vi
170 
may cause a loss of precision.