sam-t2/docs/mmi/mmi_interrupt.html

<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1">
   <meta name="GENERATOR" content="Mozilla/4.79C-CCK-MCD  [en] (X11; U; SunOS 5.8 sun4u) [Netscape]">
   <meta name="CREATED" content="20031207;17503500">
   <meta name="CHANGED" content="20031207;18493300">
   <title>SPARC Architectural Model: Device and Utility API</title>
</head>
<body bgcolor="#FFFFFF" LANG="en-US">
&nbsp;
<h2>
mmi_interrupt_packet, mmi_interrupt_vector
</h2>

<h4>
NAME</h4>

<ul>mmi_interrupt_packet - Send a interrupt packet to a cpu
<br>mmi_interrupt_vector - Send a interrupt vector to a cpu
</ul>

<h4>
SYNOPSIS</h4>

<ul><font color="#0000FF">#include "mmi.h"</font>
<p>int mmi_interrupt_packet (cpu_t *dst_cpu, void *src, int src_iscpu, uint64_t *idata);
<br>int mmi_interrupt_vector (cpu_t *dst_cpu, void *src, int src_iscpu, uint32_t vnum, int traptype);
<br>&nbsp;</ul>

<h4>
DESCRIPTION</h4>

<ul>
<i>mmi_interrupt_packet</i> sends a sun4u type interrupt packet to the cpu pointed to by <i>dst_cpu</i>.
<i>src</i> is a pointer to the module instance generating the interrupt, <i>src_iscpu</i>
says if the source is a cpu instance, and <i>idata</i> is the interrupt packet and needs to be
a pointer to an array of 8 64-bit unsigned integers.
<p><i>mmi_interrupt_vector</i> sends a Niagara type interrupt to the cpu pointed to by <i>dst_cpu</i>.
<i>src</i> is a pointer to the module instance generating the interrupt, <i>src_iscpu</i>
says if the source is a cpu instance, <i>vnum</i> is the interrupt vector and <i>traptype</i> is a hint
on the type of trap the cpu needs to take on receiving the interrupt (typically 0x60 or 0x70).
</ul>

<h4>
RETURN VALUES</h4>

<ul>Return 0 when successful and -1 when there is an error.</ul>

<h4>
ERRORS</h4>
<ul>Will fail if</ul>
<ul>EINVALID: <i>dst_cpu</i> pointer is invalid.</ul>

<h4>
USAGE</h4>

<h4>
SEE ALSO</h4>
<ul><a href="intro.html">intro.html</a></ul>

<h4>
WARNINGS</h4>
&nbsp;
</body>
</html>