_UNW_currentContext(3X)

構文

説明

_UNW_currentContext() は、 _UNW_currentContext を呼び出しているプロシージャのプロセッサ状態 (言い換えれば「自身」のプロセッサ状態) を記述するためのオブジェクト _Unwind_Context を初期化します。

_UNW_jmpbufContext() setjmp(3C) を呼び出して jmp_buf に取得したプロセッサ状態を記述するための _Unwind_Context オブジェクトを初期化します。

_UNW_clear() は、 _Unwind_Context オブジェクトを「作成直後」の状態にリセットします。 _Unwind_Context のすべてのレジスタの値は無効になります。 アンワインドライブラリは Init 状態になるため、クライアントは _UNW_set ルーチンを使用して _Unwind_Context 内の値を初期化できるようになります。 Init 状態については unwind(5) で詳細に説明しています。

_UNW_setGR() は、パラメータ p が指す _Unwind_Context 内の番号 num の汎用レジスタの値を value で初期化します。 該当レジスタの NaT ビットには _UNW_FALSE がセットされます。

_UNW_setGR_NaT() は、パラメータ p が指す _Unwind_Context 内の番号 num の汎用レジスタの値を value で初期化します。 該当レジスタの NaT ビットには NaTval がセットされます。

_UNW_setFR() は、パラメータ p が指す _Unwind_Context 内の番号 num の浮動小数点レジスタの値を、パラメータ first_container および second_container で示される値のイメージで初期化します。 これらの ２ つのコンテナーは浮動小数点レジスタ (スピル/フィル メモリー形式) の連続するダブルワードを表します。 『『Intel IA-64 アーキテクチャ・ソフトウェア・デベロッパーズ・マニュアル』, 『第 １ 巻: IA-64 アプリケーション・アーキテクチャ』』の 『第 5.3 項「浮動小数点命令」』 を参照してください。

_UNW_setBR() は、パラメータ p が指す _Unwind_Context 内の番号 num の分岐レジスタの値を value で初期化します。

_UNW_setAR() は、パラメータ p が指す _Unwind_Context 内の、列挙型項目 num で示されるアプリケーションレジスタの値を value で初期化します。 アプリケーションレジスタにアクセスするために、列挙型 _UNW_AppReg を使用します。

_UNW_setPR() は、パラメータ p が指す _Unwind_Context 内の番号 num のプレディケートレジスタの値を value (_UNW_TRUE または _UNW_FALSE) で初期化します。

_UNW_setPreds() は、パラメータ p が指す _Unwind_Context 内のすべてのプレディケートレジスタの値を value で渡される内容で初期化します。 value は、プレディケートレジスタの番号に対応するビット位置に各プレディケートレジスタの値を持っています。 たとえば、ビット 63 にはプレディケートレジスタ 63 用の値 (１ または ０) が入っています。

_UNW_setIP() は、パラメータ p が指す _Unwind_Context 内の命令ポインターの値を value で初期化します。 value は、完全な 64 ビットアドレスである必要があります。 つまり、32 ビットアドレス空間の 32 ビットポインター値は _UNW_setIP() に渡す前に 64 ビットポインターに拡張 (swizzle) しておく必要があります。 『『Itanium Processor Family Runtime Architecture Supplement:』 『32-Bit Runtime Architecture for HP-UX』』の 『Section 1: Memory Model』 を参照してください。

_UNW_setCFM() は、パラメータ p が指す _Unwind_Context 内の カレントフレームマーカー (CFM) の値を value で初期化します。 『『Intel IA-64 アーキテクチャ・ソフトウェア・デベロッパーズ・マニュアル』, 『第 １ 巻: IA-64 アプリケーション・アーキテクチャ』』の 『第 3.1.7 項「現在のフレーム・マーカ」』 を参照してください。 カレントフレームマーカーはスタックフレームの各部分のサイズを保持しています。 これはまた、３ つのレジスタリネームベース値 (レジスタローテーションに使用) を指定します。 カレントフレームマーカーは、アーキテクチャ上で目に見える値ではありません。 これは、アンワインドライブラリが、アンワインドのために _Unwind_Context を初期化する際に使用するもので、初期化後の _Unwind_Context での RSE (Register Stack Engine) の状態 (具体的には現在のフレームで GR32 〜 GR127 の範囲からいくつの汎用レジスタがスタック用に使用されるか) およびレジスタベースローテーションが有効状態かどうかを示します。 クライアントプログラムは、以下に示すようないくつかの手段によりカレントフレームマーカーの値を設定できます。

_UNW_GR_PhysicalNumber()、 _UNW_FR_PhysicalNumber()、 _UNW_PR_PhysicalNumber() は、パラメータ p が指す _Unwind_Context について、論理レジスタ番号 logical_num に対応する物理レジスタ番号を返します。 論理レジスタ番号と物理レジスタ番号の違いについては、下記の 『「初期化関数間の相互作用」』 の項で説明します。

戻り値

_UNW_set... は、 _Unwind_Context が値の初期化を許さない状態にあるとき、 _UNW_SET_NOT_ALLOWED_IN_STATE を返します。 値の初期化を許す状態とは Init と Pre_Install です。 マンページ unwind(5) の 『「エラー状態と復旧」』 の項を参照してください。

_UNW_set... は、初期化が許されていないレジスタに対する初期化要求があった場合 _UNW_INITIALIZATION_RANGE_ERROR を返します。 前述の 『「初期化関数間の相互作用」』 の項を参照してください。 それ以外の場合は、 _UNW_set... は、正常終了時に _UNW_OK を返します。

_UNW_clear は、正常終了時に _UNW_OK を返します。 それ以外の場合で、 _Unwind_Context の状態が Init、 User_Interrupted_Frame、 User_Sendsig_Frame、 Kernel_Bottom_Frame、 Frame のいずれでもないときには、 _UNW_clear は _UNW_CLEAR_NOT_ALLOWED_IN_STATE を返します。 unwind(5) を参照してください。

_UNW_GR_PhysicalNumber、 _UNW_FR_PhysicalNumber、 および _UNW_PR_PhysicalNumber は、それぞれレジスタ番号を返します。 各レジスタクラス用のマップされた論理番号の範囲にない論理番号を渡すと、これらの関数は、 _Unwind_Context のアラートコードに _UNW_QUERY_RANGE_ERROR をセットし、０ を返します。

_UNW_step は、以下の戻り値を返します。

_UNW_currentContext は、以下の戻り値を返します。

エラー

_UNW_currentContext は、初期化を実行するためのメモリーが充分にない場合、またはライブラリの対話上の問題 (たとえば、サービスマネージャや dlmodinfo の呼び出し) により unwindlib が初期化を実行できない場合は、対応するエラーを返します。

例

汎用レジスタ ５ 〜 400 を初期化します。

著者

_UNW_currentContext(), _UNW_jmpbufContext(), _UNW_clear(), _UNW_setGR(), _UNW_setGR_NaT(), _UNW_setFR(), _UNW_setBR(), _UNW_setAR(), _UNW_setPR(), _UNW_setPreds(), _UNW_setIP(), _UNW_setCFM(), _UNW_GR_PhysicalNumber(), _UNW_FR_PhysicalNumber(), _UNW_PR_PhysicalNumber(), _UNW_step() は HP で開発されました。

参照

U_STACK_TRACE(3X), _UNW_createContextForSelf(3X), _UNW_getGR(3X), unwind(5)