Cライブラリ関数 -sigwait()

C 标准库 - <signal.h>C標準ライブラリ - <signal.h>

説明

sigwaitこの関数はC標準ライブラリ内の関数で、シグナルの到着を同期的に待機するために使用されます。指定されたシグナルセット内のいずれかのシグナルをキューから取り出し、その番号を返します。この関数は、<signal.h>ヘッダーファイル内に定義されています。

構文

int sigwait(const sigset_t *set, int *sig);

引数

  • const sigset_t *set:次のものを指しますsigset_t型のシグナルセット変数。このシグナルセットは待機するシグナルを指定します。
  • int *sig:整数変数を指します。捕獲されたシグナル番号を格納するために使用されます。

戻り値

  • 成功時には0を返します。
  • 失敗時にはエラーコードを返します。

例

以下は、次を使用したsigwait関数を使用して同期的に待機するSIGINTシグナルのサンプルプログラムです。このプログラムはシグナルの待機中にメッセージを出力し、シグナルを捕獲すると、SIGINTシグナルを受信したときは、sigwait関数を使用して同期的に待機し、シグナルを処理します。

例

#include <stdio.h>
#include <signal.h>
#include <unistd.h>
#include <pthread.h>

// スレッド関数。SIGINTシグナルを待機します。
void* wait_for_signal(void* arg) {
    sigset_t *set = (sigset_t *)arg;
    int sig;

    printf("Thread waiting for signal...\n");
    if (sigwait(set, &sig) == 0) {
        printf("Caught signal %d: %s\n", sig, strsignal(sig));
    } else {
        perror("sigwait");
    }

    return NULL;
}

int main() {
    pthread_t thread;
    sigset_t set;

    // シグナルセットを初期化し、SIGINTをシグナルセットに追加します。
    sigemptyset(&set);
    sigaddset(&set, SIGINT);

    // メインスレッドでSIGINTシグナルをブロックします。
    pthread_sigmask(SIG_BLOCK, &set, NULL);

    // スレッドを作成し、SIGINTシグナルを待機します。
    pthread_create(&thread, NULL, wait_for_signal, (void*)&set);

    // メインスレッドは、Ctrl+Cが押されてSIGINTシグナルが送信されるまで実行を続けます。
    while (1) {
        printf("Main thread running... Press Ctrl+C to send SIGINT\n");
        sleep(1);
    }

    // 子スレッドの終了を待機します。
    pthread_join(thread, NULL);

    return 0;
}

プログラムをコンパイルして実行した後、Ctrl+Cを押してSIGINTシグナルを送信すると、出力は次のようになります:

Main thread running... Press Ctrl+C to send SIGINT
Main thread running... Press Ctrl+C to send SIGINT
Main thread running... Press Ctrl+C to send SIGINT
Thread waiting for signal...
Caught signal 2: Interrupt

プログラムはメインスレッドでSIGINTシグナルをブロックし、子スレッドを作成して待機および処理します。SIGINTシグナル。シグナルを捕獲すると、SIGINTシグナルを受信したとき、子スレッドはsigwait関数を使用して同期的に待機し、シグナルを処理します。

解説

  • sigemptyset(&set);:シグナルセットを空に初期化します。
  • sigaddset(&set, SIGINT);:SIGINTシグナルをシグナルセットに追加します。
  • pthread_sigmask(SIG_BLOCK, &set, NULL);:メインスレッドでSIGINTシグナルをブロックし、子スレッドがそれを処理できるようにします。
  • pthread_create(&thread, NULL, wait_for_signal, (void*)&set);:子スレッドを作成してSIGINTシグナルを待機します。
  • sigwait(set, &sig);:子スレッドはsigwait関数を使用して同期的に待機し、処理しますSIGINTシグナル。

注意事項

  • sigwaitこの関数は、シグナルセット内のいずれかのシグナルが捕獲された場合にのみ戻ります。
  • sigwaitシグナルマスクと組み合わせて使用することで、シグナルが意図したスレッドで処理されることを保証できます。
  • 使用すると、sigwaitシグナルハンドラ内の競合状態と複雑さを回避できます。

C 标准库 - <signal.h>C標準ライブラリ - <signal.h>

その他の拡張