osGetCurrFaultedThread.htm
2.53 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
<HTML>
<HEAD>
<TITLE>HTML 文書</TITLE>
<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0j">
</HEAD>
<BODY>
<P>
<B><FONT FACE="Arial">__osGetCurrFaultedThread(3P) <BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
__osGetCurrFaultedThread, __osGetNextFaultedThread
<P>
→ フォルトしたスレッドにアクセスするための内部ルーチン
<BR>
<P>
<B>構文<BR>
</B>
<P>
#include <ultra64.h>
<P>
#include <os_internal.h> <BR>
<P>
<B>OSThread * __osGetCurrFaultedThread(void);</B>
<P>
OSThread * __osGetNextFaultedThread(OSThread *last);
<BR>
<P>
<B>説明<BR>
</B>
<P>
N64 OSはTLBミスなどの様々な例外によってフォルトしているスレッドにアクセスするためのいくつかの内部ルーチンを持っています｡これらのルーチンは元々内部での使用を前提にデザインされているので､それらの関数名は最初に”__”が付いています｡内部的にそれらはシステム内で作成されたアクティブな全てのスレッドに含まれるスレッドキューに存在します｡このキューはデバッグを目的として主にrmonによって使用されます｡
<BR>
<P>
現在､インストラクションフェッチでのTLB例外などのCPU例外にスレッドがヒットしたとき､例外ハンドラは全ての適切なレジスタをスレッドコンテキストにセーブし､例外からスレッドを停止し､デバッガのためにそれをマークし､OS_EVENT_FAULTイベントを待つように登録されたスレッドにメッセージを送り､実行キューから次に実行可能なスレッドをスタートさせます｡rmonが実行中の場合は､それはOS_EVENT_FAULTイベントを受けたことを記録し､フォルトメッセージを記録し､gload実行中のホストにフォルトスレッドコンテキストを送り､gloadにスクリーン上にスレッドコンテキスト(主にレジスタ)をプリントさせます｡必要な場合は､CPUフォルトハンドルへのOS_EVENT_FAULTの為のレジスタであるスレッドに以下のルーチンを使用することができます｡これらのルーチンの使用方法についてはサンプルアプリケーションの"fault"を参照してください｡
<BR>
<P>
<B>__osGetCurrFaultedThread</B>は最新のフォルトスレッドか､あるいはフォルトしたスレッドがない場合はNULLを返します｡
<BR>
<P>
lastスレッドを基本として､__osGetNextFaultedThreadはアクティブスレッドキューから次にフォルトしたスレッドを返します｡lastがNULLの場合は､このルーチンはキューのはじめから継続的に検索を実行します｡そうでない場合はlastスレッドから検索を開始します｡フォルトしたスレッドが見つからない場合は､NULLが返されます｡
<BR>
<P>
<B>参照<BR>
</B>
<P>
<A HREF="osInitialize.htm">osInitialize</A>(3P), <A HREF="osCreateThread.htm">osCreateThread</A>(3P),
<P>
<A HREF="osCreateThread.htm">osStartThread</A>(3P), <A HREF="osStopThread.htm">osStopThread</A>(3P),
<P>
<A HREF="osDestroyThread.htm">osDestroyThread</A>(3P)<BR>
</BODY>
</HTML>