osFlushLog.htm
2.21 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
72
73
74
75
76
77
78
<HTML>
<HEAD>
<TITLE>HTML 文書</TITLE>
<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0j">
</HEAD>
<BODY>
<P>
<B><FONT FACE="Arial">osFlushLog(3P) <BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
osCreateLog, osLogEvent, osFlushLog
<P>
→ ロギングユーティリティ<BR>
<P>
<B>構文<BR>
</B>
<P>
#include <ultra64.h>
<P>
void osCreateLog(OSLog *log, u32 *base, s32 len);
<P>
void osLogEvent(OSLog *log, s16 code, s16 numArgs,
....);
<P>
<B>void osFlushLog(OSLog *log); <BR>
</B>
<P>
<B>説明<BR>
</B>
<P>
ロギングはパフォーマンスに直接影響しにくいようにキャラクタフォーマット列の出力をrmonPrintf(3P)に送るための交互メカニズムです｡ロギングはDRAM内に出力情報をバッファリングし､比較的大きな転送を遅らせたり､ホストでフォーマットを行うことによって動作します｡逆に､rmonPrintfはターゲット上の与えられたキャラクタ列をフォーマットし､ホストに直接そのキャラクタ列をフラッシュします｡ロギングは現実的な問題のデバッグやあるいはパフォーマンス解析のようなケースで使用します｡
<BR>
<P>
OSLogデータストラクチャはロギングルーチンで参照された個々のログによってハンドルの役目として使用します｡osCreateLog関数はストラクチャをイニシャライズします｡引数baseは実際にログデータをホールドする32bitワードのlenのメモリ範囲に対するポインタです｡
<BR>
<P>
osLogEventルーチンは与えられたlogへの登録を加えます｡logエントリは16bitのcodeで始まり､追加引数カウントnumArgs､そして最終的にそれ自身の追加引数が続きます｡それらはOS_LOG_MAX_ARGSあるいは16以下の追加引数です｡引数は32bit数に限定されており､キャラクタ列を含んだアドレスポインタにはなりません｡
<BR>
<P>
<B>osFlushLog</B>ルーチンはログデータを､<A HREF="../tool/gload.htm" >gload</A>(1P)が解釈しログをプリントするホストに転送します｡gloadプログラムはフォーマットファイルよりロギングコードを検索し､残りの引数にフォーマット列を適用します｡例えば､以下のようなフォーマットファイルを持っていたとしますと､
<BR>
<P>
10 "The hexadecimal equivalent of %d ix 0x%x"<BR>
<P>
そのとき､以下のコールを行うと､ <BR>
<P>
osLogEvent(log, 10, 2, 16, 16);<BR>
<P>
gloadが以下の出力を行います｡ <BR>
<P>
0xXXXXXXX (0010): The hexadecimal equivalent of 16 is 0x10<BR>
<P>
<B>参照<BR>
</B>
<P>
<A HREF="../tool/gload.htm">gload</A>(1P)<BR>
</BODY>
</HTML>