getaddrinfo()－準備開始！

Beej's Guide to Network Programming 正體中文版
Search…
getaddrinfo()－準備開始！
這是個有很多選項的工作馬（workhorse）函式，但是卻相當容易上手。它幫你設定之後需要的 struct。
談點歷史：它前身是你用來做 DNS 查詢的 gethostbyname()。而當時你需要手動將資訊載入 struct sockaddr_in，並在你的呼叫中使用。
感謝老天，現在已經不用了。［如果你想要設計能通用於 IPv4 與 IPv6 的程式也不用！］在現代，你有 getaddrinfo() 函式，可以幫你做許多事情，包含 DNS 與 service name 查詢，並填好你所需的 structs。
讓我們來看看！
1
#include <sys/types.h>
2
#include <sys/socket.h>
3
#include <netdb.h>
4
​
5
int getaddrinfo(const char *node, // 例如： "www.example.com" 或 IP
6
                const char *service, // 例如： "http" 或 port number
7
                const struct addrinfo *hints,
8
                struct addrinfo **res);
Copied!
你給這個函式三個輸入參數，結果它會回傳給你一個指向鏈結串列的指標 － res。
node 參數是要連線的主機名稱，或者一個 IP address（位址）。
下一個參數是 service，這可以是 port number，像是 "80"，或者特定服務的名稱［可以在你 UNIX 系統上的 IANA Port List [17] 或 /etc/services 檔案中找到］，像是 "http" 或 "ftp" 或 "telnet" 或 "smtp" 諸如此類的。
最後，hints 參數指向一個你已經填好相關資訊的 struct addrinfo。
這裡是一個呼叫範例，如果你是一部 server（伺服器），想要在你主機上的 IP address 及 port 3490 執行 listen。要注意的是，這邊實際上沒有做任何的 listening 或網路設定；它只有設定我們之後要用的 structures 而已。
1
int status;
2
struct addrinfo hints;
3
struct addrinfo *servinfo; // 將指向結果
4
​
5
memset(&hints, 0, sizeof hints); // 確保 struct 為空
6
hints.ai_family = AF_UNSPEC; // 不用管是 IPv4 或 IPv6
7
hints.ai_socktype = SOCK_STREAM; // TCP stream sockets
8
hints.ai_flags = AI_PASSIVE; // 幫我填好我的 IP 
9
​
10
if ((status = getaddrinfo(NULL, "3490", &hints, &servinfo)) != 0) {
11
  fprintf(stderr, "getaddrinfo error: %s\n", gai_strerror(status));
12
  exit(1);
13
}
14
​
15
// servinfo 目前指向一個或多個 struct addrinfos 的鏈結串列
16
​
17
// ... 做每件事情，一直到你不再需要 servinfo  ....
18
​
19
freeaddrinfo(servinfo); // 釋放這個鏈結串列
Copied!
注意一下，我將 ai_family 設定為 AF_UNSPEC，這樣代表我不用管我們用的是 IPv4 或 IPv6 address。如果你想要指定的話，你可以將它設定為 AF_INET 或 AF_INET6。
還有，你會在這裡看到 AI_PASSIVE 旗標；這個會告訴 getaddrinfo() 要將我本機的位址（address of local host）指定給 socket structure。這樣很棒，因為你就不用把位址寫死了［或者你可以將特定的位址放在 getaddrinfo() 的第一個參數中，我現在寫 NULL 的那個參數］。
然後我們執行呼叫，若有錯誤發生時［getaddrinfo 會傳回非零的值］，如你所見，我們可以使用 gai_strerror() 函式將錯誤印出來。若每件事情都正常運作，那麼 serinfo 就會指向一個 struct addrinfos 的鏈結串列，串列中的每個成員都會包含一個我們之後會用到的某種 struct sockaddr。
最後，當我們終於使用 getaddrinfo() 配置的鏈結串列完成工作後，我們可以［也應該］要呼叫 freeaddrinfo() 將鏈結串列全部釋放。
這邊有一個呼叫範例，如果你是一個想要連線到特定 server 的 client（客戶端），比如是："www.example.net" 的 port 3490。再次強調，這裡並沒有真的進行連線，它只是設定我們之後要用的 structure。
1
int status;
2
struct addrinfo hints;
3
struct addrinfo *servinfo; // 將指向結果
4
​
5
memset(&hints, 0, sizeof hints); // 確保 struct 為空
6
hints.ai_family = AF_UNSPEC; // 不用管是 IPv4 或 IPv6
7
hints.ai_socktype = SOCK_STREAM; // TCP stream sockets
8
​
9
// 準備好連線
10
status = getaddrinfo("www.example.net", "3490", &hints, &servinfo);
11
​
12
// servinfo 現在指向有一個或多個 struct addrinfos 的鏈結串列
13
​
14
我一直說 serinfo 是一個鏈結串列，它有各種的位址資訊。讓我們寫一個能快速 demo 的程式，來呈現這個資訊。這個小程式 [18] 會印出你在命令列中所指定的主機之 IP address：
15
/*
16
** showip.c -- 顯示命令列中所給的主機 IP address
17
*/
18
#include <stdio.h>
19
#include <string.h>
20
#include <sys/types.h>
21
#include <sys/socket.h>
22
#include <netdb.h>
23
#include <arpa/inet.h>
24
#include <netinet/in.h>
25
​
26
int main(int argc, char *argv[])
27
{
28
  struct addrinfo hints, *res, *p;
29
  int status;
30
  char ipstr[INET6_ADDRSTRLEN];
31
​
32
  if (argc != 2) {
33
    fprintf(stderr,"usage: showip hostname\n");
34
    return 1;
35
  }
36
​
37
  memset(&hints, 0, sizeof hints);
38
  hints.ai_family = AF_UNSPEC; // AF_INET 或 AF_INET6 可以指定版本
39
  hints.ai_socktype = SOCK_STREAM;
40
​
41
  if ((status = getaddrinfo(argv[1], NULL, &hints, &res)) != 0) {
42
    fprintf(stderr, "getaddrinfo: %s\n", gai_strerror(status));
43
    return 2;
44
  }
45
​
46
  printf("IP addresses for %s:\n\n", argv[1]);
47
​
48
  for(p = res;p != NULL; p = p->ai_next) {
49
    void *addr;
50
    char *ipver;
51
​
52
    // 取得本身位址的指標，
53
    // 在 IPv4 與 IPv6 中的欄位不同：
54
    if (p->ai_family == AF_INET) { // IPv4
55
      struct sockaddr_in *ipv4 = (struct sockaddr_in *)p->ai_addr;
56
      addr = &(ipv4->sin_addr);
57
      ipver = "IPv4";
58
    } else { // IPv6
59
      struct sockaddr_in6 *ipv6 = (struct sockaddr_in6 *)p->ai_addr;
60
      addr = &(ipv6->sin6_addr);
61
      ipver = "IPv6";
62
    }
63
​
64
    // convert the IP to a string and print it:
65
    inet_ntop(p->ai_family, addr, ipstr, sizeof ipstr);
66
    printf(" %s: %s\n", ipver, ipstr);
67
  }
68
​
69
  freeaddrinfo(res); // 釋放鏈結串列
70
​
71
  return 0;
72
}
Copied!
如你所見，程式碼使用你在命令列輸入的參數呼叫 getaddrinfo()，它填好 res 所指的鏈結串列，並接著我們就能重複那行並印出東西或做點類似的事。
［有點不好意思！我們在討論 struct sockaddrs 它的型別差異是因 IP 版本而異之處有點鄙俗。我不確定是否有較優雅的方法。］
在下面執行範例！來看看大家喜歡看的執行畫面：
1
$ showip www.example.net
2
IP addresses for www.example.net:
3
​
4
  IPv4: 192.0.2.88
5
​
6
$ showip ipv6.example.com
7
IP addresses for ipv6.example.com:
8
​
9
  IPv4: 192.0.2.101
10
  IPv6: 2001:db8:8c00:22::171
Copied!
現在已經在我們的掌控之下，我們會將 getaddrinfo() 傳回的結果送給其它的 socket 函式，而且終於可以建立我們的網路連線了！
讓我們繼續看下去！
[17] http://www.iana.org/assignments/port-numbers​
[18] http://beej.us/guide/bgnet/examples/showip.c​
[19] http://tools.ietf.org/html/rfc1413​
System call 或 Bust
socket()－取得 File Descriptor！
Last modified 1yr ago
Copy link