如何使用getaddrinfo_a与glibc进行异步解析

时间:2008-09-12 01:07:06

标签: c dns glibc getaddrinfo-a

一个经常被忽视的功能,不需要外部库,但基本上没有任何文档。

1 个答案:

答案 0 :(得分:17)

更新(2010-10-11):linux手册页现在有getaddrinfo_a的文档,你可以在这里找到它:http://www.kernel.org/doc/man-pages/online/pages/man3/getaddrinfo_a.3.html

作为免责声明,我应该补充一点,我对C很新,但不是新手,所以可能存在错误或编码错误,请纠正我(我的语法也很糟糕)。

在Adam Langley发现this post之前,我个人并不知道,我将提供一些代码片段来说明它的用法并澄清一些在首次使用时可能不太清楚的事情。 。使用它的好处是,您可以在 socket() listen()和其他功能中获取可随时使用的数据,如果操作正确,您将不必担心关于ipv4 / v6也是。
所以从基础开始,从上面的链接开始(你需要链接libanl(-lanl)):
这是函数原型:

int getaddrinfo_a(int mode, struct gaicb *list[], int ent, 
                  struct sigevent *);
  1. 模式是GAI_WAIT(可能不是您想要的)和GAI_NOWAIT用于异步查找
  2. gaicb 参数接受要使用 ent 参数查找的主机数组,指定数组有多少元素
  3. sigevent 将负责告诉函数我们如何收到通知,稍后会详细介绍
  4. 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字段,service是端口,hints参数对应于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. 来忽略该通知
    3. 您可以通过将sigev_notify设置为SIGEV_SIGNAL并将sigev_signo设置为所需信号来触发信号。请注意,当使用实时信号( SIGRTMIN - SIGRTMAX 时,总是通过宏使用它并添加 SIGRTMIN +2等)你可以传递sigev_value.sival_ptr或sigev_value.sival_int成员respectivley中的指针或值
    4. 您可以通过将sigev_notify设置为SIGEV_NONE
    5. 来请求新线程中的回调

      所以基本上如果你想查找一个主机名你将ar_name设置为主机并将其他所有内容设置为 NULL ,如果你想连接到你设置ar_name和ar_service的主机,如果你想要创建一个指定ar_service的服务器和ar_result字段。您当然可以根据心灵内容自定义ar_request成员,有关详细信息,请查看man getaddrinfo

      如果你有一个带select / poll / epoll / kqueue的事件循环,你可能想要使用signalfd以方便使用。 Signalfd创建了一个文件描述符,您可以在其上使用usuall事件轮询机制,如下所示:

      #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;
      }
      

      当然,您也可以使用简单的信号处理程序来查看此作业,请查看man sigaction以获取更多信息。