makecontext() - ユーザー・コンテキストの変更

<ucontext.h> ヘッダー・ファイルは、次のメンバーをインクルードする構造体として、ucontext_t 型を定義します。

mcontext_t       uc_mcontext     A machine-specific representation
                                 of the saved context.
ucontext_t      *uc_link         Pointer to the context that will
                                 be resumed when this context returns.
sigset_t         uc_sigmask      The set of signals that are blocked
                                 when this context is active.
stack_t          uc_stack        The stack used by this context.

C および C++ のリンケージ規約は非互換の ため、makecontext() は C++ 関数ポインターを受け取ることが できません。C++ 関数ポインターを makecontext() へ渡そうとすると、コンパイラーは エラーとしてフラグを立てます。C++ makecontext() 関数を使用するには、makecontext() 用に登録されているすべての関数が、関数を extern “C” と宣言することにより、C リンケージを とるようにする必要があります。例えば、次のようになります。

C:   void func(int, int);
     :
     makecontext(&context, func, 2, arg1, arg2);

C++: extern "C" void func();
     :
     makecontext(&context, func, 2, arg1, arg2);

正常に実行されなかった場合、makecontext() は errno を次のいずれかの値に設定します。

エラー・コード

説明

EINVAL

変更中のコンテキストは代替スタックを使用している。また、ターゲット関数のエントリー・ポイントが有効な Language Environment® または C エントリー・ポイント ではない。

argc 引数が 0 未満の値を指定する。

ENOMEM

ucp 引数には、命令を完了するのに十分な スタックが残されていない。あるいは、16 以上の引数がターゲット関数に渡され、それらの引数のすべてを保持するのに十分なストレージがない。

注: ターゲット関数がまだロードされていない DLL にある 場合、makecontext() はサイズ要件を判別することができない ため、必要なサイズが MINSIGSTKSZ であると想定します。そのため、この場合、スタックのサイズを MINSIGSTKSZ が 示すサイズ以上にする必要があります。ターゲット関数が必要とするサイズが MINSIGSTKSZ を超える 場合は、makecontext() を呼び出す前に DLL をロードする必要があります。

この例では、メインで getcontext() ステートメントを使ってコンテキストを作成し、次にコンテキストに独自のスタックを持たせ、func 関数を呼び出すように変更します。ここでは、setcontext() ステートメントを使って関数を呼び出します。uc_link メンバーは 0 に設定されているので、このプロセスは関数が戻ると終了します。

/* This example shows the usage of makecontext().                    */

#define _XOPEN_SOURCE_EXTENDED 1
#include <stdlib.h>
#include <stdio.h>
#include <ucontext.h>
#include <errno.h>

 #ifdef _LP64
  #define STACK_SIZE 2097152+16384 /* large enough value for AMODE 64 */
 #else
  #define STACK_SIZE 16384         /* AMODE 31 addressing */
 #endif

void func(int);

ucontext_t context, *cp = &context;

int main(void) {

  int  value = 1;

  getcontext(cp);
  context.uc_link = 0;
  if ((context.uc_stack.ss_sp = (char *) malloc(STACK_SIZE)) != NULL) {
    context.uc_stack.ss_size = STACK_SIZE;
    context.uc_stack.ss_flags = 0;
             errno = 0;
    makecontext(cp,func,1,value);
              if(errno != 0){
                perror("Error reported by makecontext()");
                return -1;         /* Error occurred exit */ }
  }
  else {
    perror("not enough storage for stack");
    abort();
  }
  printf("context has been built¥n");
  setcontext(cp);
  perror("returned from setcontext");
  abort();

}

void func(int arg) {

  printf("function called with value %d¥n",arg);
  printf("process will exit when function returns¥n");
  return;

}

出力:

context has been built
function called with value 1
process will exit when function returns