getaddrinfo_a を使用して glibc で非同期解決を行う方法

Question

見落とされがちな関数で、外部ライブラリを必要としませんが、基本的にドキュメントがまったくありません。

Answer 1

更新 (2010-10-11):Linux のマニュアル ページには getaddrinfo_a のドキュメントが含まれています。ここで見つけることができます。 http://www.kernel.org/doc/man-pages/online/pages/man3/getaddrinfo_a.3.html

免責事項として、私は C の初心者ではありますが、まったくの初心者ではないことを付け加えておきます。そのため、バグや間違ったコーディング方法があるかもしれません。修正してください (私の文法もひどいです)。

私自身、この作品に出会うまで知りませんでした この郵便受け Adam Langley 著。その使用方法を説明するために、いくつかのコード スニペットを示し、最初に使用するときにはそれほど明確ではないかもしれないいくつかの点を明確にします。これを使用する利点は、すぐに使用できるデータが返されることです。 ソケット（）, 聞く（） などの機能があり、正しく行えば ipv4/v6 についても心配する必要はありません。
したがって、上記のリンクから抜粋したように、基本的なことから始めます (libanl (-lanl) に対してリンクする必要があります)。
関数のプロトタイプは次のとおりです。

int getaddrinfo_a(int mode, struct gaicb *list[], int ent, 
                  struct sigevent *);

1. の モード 非同期ルックアップの場合は GAI_WAIT (これはおそらく希望するものではありません) または GAI_NOWAIT のいずれかです
2. の ガイクブ 引数は、検索するホストの配列を受け入れます。 エント 配列に含まれる要素の数を指定する引数
3. の シグベント 通知を受ける方法を関数に伝える責任があります。これについては後ほど詳しく説明します

gaicb 構造体は次のようになります。

struct gaicb {
    const char *ar_name;
    const char *ar_service;
    const struct addrinfo *ar_request;
    struct addrinfo *ar_result;
};

getaddrinfo に精通している場合、これらのフィールドは次のように対応します。

int getaddrinfo(const char *node, const char *service,
                const struct addrinfo *hints,
                struct addrinfo **res);

ノードは ar_name フィールド、サービスはポート、ヒント引数は ar_request メンバーに対応し、結果は残りに格納されます。
ここで、sigevent 構造体を通じて通知を受ける方法を指定します。

struct sigevent {
    sigval_t sigev_value;
    int sigev_signo;
    int sigev_notify;
    void (*sigev_notify_function) (sigval_t);
    pthread_addr_t *sigev_notify_attributes;
};

1. _sigev_notify_ を SIGEV_NONE に設定することで通知を無視できます。
2. sigev_notify を SIGEV_SIGNAL に設定し、sigev_signo を目的の信号に設定することで、信号をトリガーできます。リアルタイム信号を使用する場合は注意してください (シグトミン-SIGRTMAX, 、常にマクロと追加を介して使用します。 シグトミン+2 など) sigev_value.sival_ptr または sigev_value.sival_int メンバーのポインターまたは値をそれぞれ渡すことができます。
3. sigev_notify を SIGEV_NONE に設定することで、新しいスレッドでコールバックをリクエストできます。

したがって、基本的にホスト名を検索したい場合は、ar_name をホストに設定し、他のすべてを次のように設定します。 ヌル, 、ホストに接続する場合は ar_name と ar_service を設定し、サーバーを作成する場合は ar_service と ar_result フィールドを指定します。もちろん、ar_request メンバーを自由にカスタマイズできます。 男はアドレス情報を取得します 詳細については。

select/poll/epoll/kqueue を使用したイベント ループがある場合は、使用するとよいでしょう 信号FD 便宜上。Signalfd は、次のように通常のイベント ポーリング メカニズムを使用できるファイル記述子を作成します。

#define _GNU_SOURCE //yes this will not be so standardish
#include <netdb.h>
#include <signal.h>
#include <sys/signalfd.h>

void signalfd_setup(void) {
    int sfd;
    sigset_t mask;

    sigemptyset(&mask);
    sigaddset(&mask, SIGRTMIN);
    sigprocmask(SIG_BLOCK, &mask, NULL); //we block the signal
    sfd = signalfd(-1, &mask, 0);
    //add it to the event queue
}
void signalfd_read(int fd) {
    ssize_t s;
    struct signalfd_siginfo fdsi;
    struct gaicb *host;

    while((s = read(fd, &fdsi, sizeof(struct signalfd_siginfo))) > 0){
    if (s != sizeof(struct signalfd_siginfo)) return; //thats bad
    host = fdsi.ssi_ptr; //the pointer passed to the sigevent structure
            //the result is in the host->ar_result member
            create_server(host);
    }
}
void create_server(struct gaicb *host) {
    struct addrinfo *rp, *result;
    int fd;

    result = host->ar_result;
    for(rp = result; rp != NULL; rp = rp->ai_next) {
        fd = socket(rp->ai_family, rp->ai_socktype, rp->ai_protocol);
        bind(fd, rp->ai_addr, rp->ai_addrlen);
        listen(fd, SOMAXCONN);
        //error checks are missing!

        freeaddrinfo(host->ar_request);
        freeaddrinfo(result);
        //you should free everything you put into the gaicb
    }
}
int main(int argc, char *argv[]) {
    struct gaicb *host;
    struct addrinfo *hints;
    struct sigevent sig;

    host = calloc(1, sizeof(struct gaicb));
    hints = calloc(1, sizeof(struct addrinfo));

    hints->ai_family = AF_UNSPEC; //we dont care if its v4 or v6
    hints->ai_socktype = SOCK_STREAM;
    hints->ai_flags = AI_PASSIVE;
    //every other field is NULL-d by calloc

    host->ar_service = "8888"; //the port we will listen on
    host->ar_request = hints;

    sig.sigev_notify = SIGEV_SIGNAL;
    sig.sigev_value.sival_ptr = host;
    sig.sigev_signo = SIGRTMIN;

    getaddrinfo_a(GAI_NOWAIT, &host, 1, &sig);

    signalfd_setup();

    //start your event loop
    return 0;
}

もちろん、このジョブに単純なシグナル ハンドラーを使用することもできます。 男シアクション 詳細については。