Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / docs / mmi / mmi_interrupt.html
CommitLineData
920dae64
AT
1<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
2<html>
3<head>
4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5 <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1">
6 <meta name="GENERATOR" content="Mozilla/4.79C-CCK-MCD [en] (X11; U; SunOS 5.8 sun4u) [Netscape]">
7 <meta name="CREATED" content="20031207;17503500">
8 <meta name="CHANGED" content="20031207;18493300">
9 <title>SPARC Architectural Model: Device and Utility API</title>
10</head>
11<body bgcolor="#FFFFFF" LANG="en-US">
12&nbsp;
13<h2>
14mmi_interrupt_packet, mmi_interrupt_vector
15</h2>
16
17<h4>
18NAME</h4>
19
20<ul>mmi_interrupt_packet - Send a interrupt packet to a cpu
21<br>mmi_interrupt_vector - Send a interrupt vector to a cpu
22</ul>
23
24<h4>
25SYNOPSIS</h4>
26
27<ul><font color="#0000FF">#include "mmi.h"</font>
28<p>int mmi_interrupt_packet (cpu_t *dst_cpu, void *src, int src_iscpu, uint64_t *idata);
29<br>int mmi_interrupt_vector (cpu_t *dst_cpu, void *src, int src_iscpu, uint32_t vnum, int traptype);
30<br>&nbsp;</ul>
31
32<h4>
33DESCRIPTION</h4>
34
35<ul>
36<i>mmi_interrupt_packet</i> sends a sun4u type interrupt packet to the cpu pointed to by <i>dst_cpu</i>.
37<i>src</i> is a pointer to the module instance generating the interrupt, <i>src_iscpu</i>
38says if the source is a cpu instance, and <i>idata</i> is the interrupt packet and needs to be
39a pointer to an array of 8 64-bit unsigned integers.
40<p><i>mmi_interrupt_vector</i> sends a Niagara type interrupt to the cpu pointed to by <i>dst_cpu</i>.
41<i>src</i> is a pointer to the module instance generating the interrupt, <i>src_iscpu</i>
42says if the source is a cpu instance, <i>vnum</i> is the interrupt vector and <i>traptype</i> is a hint
43on the type of trap the cpu needs to take on receiving the interrupt (typically 0x60 or 0x70).
44</ul>
45
46<h4>
47RETURN VALUES</h4>
48
49<ul>Return 0 when successful and -1 when there is an error.</ul>
50
51<h4>
52ERRORS</h4>
53<ul>Will fail if</ul>
54<ul>EINVALID: <i>dst_cpu</i> pointer is invalid.</ul>
55
56<h4>
57USAGE</h4>
58
59<h4>
60SEE ALSO</h4>
61<ul><a href="intro.html">intro.html</a></ul>
62
63<h4>
64WARNINGS</h4>
65&nbsp;
66</body>
67</html>