gethostbyname(), gethostbyaddr()

Beej's Guide to Network Programming 正體中文版
Search…
取得 hostname 的 IP address for a hostname，反之亦然
函式原型
1
#include <sys/socket.h>
2
#include <netdb.h>
3
​
4
struct hostent *gethostbyname(const char *name); // 不建議使用！
5
struct hostent *gethostbyaddr(const char *addr, int len, int type);
Copied!
說明
請注意：這兩個函式已經由 getaddrinfo() 與 getnameinfo() 取而代之！實際上，gethostbyname() 無法在 IPv6 中正常運作。
這些函式可以轉換 host names 與 IP addresses。例如：你可以用 gethostbyname() 取得 " 其 IP addresses，並儲存在 struct in_addr。
反之，如果你有一個 struct in_addr 或 struct in6_addr，你可以用 gethostbyaddr() 取回 hostname。gethostbyaddr() 與 IPv6 相容，但是你應該使用新的 getnameinfo() 取代之。
（如果你有一個字串是句點與數字組成的格式，你想要查詢它的 hostname，你在使用 getaddrinfo() 時最好要搭配 AI_CANONNAME flag）。
gethostbyname() 接收一個類似 "www.yahoo.com" 的字串，然後傳回一個 struct hostent，裡面包含幾萬噸的資料，包括了 IP address（其它的資訊是官方的 host name、一連串的別名、位址型別、位址長度、以及位址清單。這是個通用的資料結構，在特定的用途上也很易於使用）。
在 gethostbyaddr() 代入一個 struct in_addr 或 struct in6_addr，然後就會提供你一個相對應的 host name（如果有），因此，它是 gethostbyname() 的相反式。至於參數，addr 是一個 char*，你實際上想要用一個指向 struct in_addr 的指標傳遞；len 應是 sizeof(struct in_addr)，而 type 應為 AF_INET。所以這個 struct hostent 會帶回什麼呢？它有許多欄位，包含 host 的相關資訊。
char h_name 真正的 real canonical host name。 char h_aliases 一連串的別名，可以用陣列存取—最後一個元素（element）是 NULL。 int h_addrtype address type 的答案，這個在我們的用途應該是 AF_INET。 int length address 的長度（以 byte 為單位），這個在 IP (version 4) address 是 4。 char h_addr_list 這個主機的 IP addresses 清單。雖然這是個 char**，不過實際上是 struct in_addrs 所偽裝的陣列，最後一個元素是 NULL。 h_addr 為 h_addr_list[0] 所定義的通用別名，如果你只是想要任意一個舊有的 IP addres，就用這個欄位吧。（耶，它們可以大於一個）。
傳回值
成功時傳回指向 struct hostent 結果的指標，錯誤時傳回 NULL。
跟你平常使用的錯誤報告工具不同，也不是一般的 perror()，這些函式在 h_errno 變數中有同樣的結果，可以使用 herror() 或 hstrerror() 函式印出來，這些函式運作的方式類似你常用的典型 errnor、perror() 及 strerror() 函式。
範例
1
// 不建議使用這個方式取得 host name
2
// 建議使用 getaddrinfo()！
3
​
4
#include <stdio.h>
5
#include <errno.h>
6
#include <netdb.h>
7
#include <sys/types.h>
8
#include <sys/socket.h>
9
#include <netinet/in.h>
10
#include <arpa/inet.h>
11
​
12
int main(int argc, char *argv[])
13
{
14
  int i;
15
  struct hostent *he;
16
  struct in_addr **addr_list;
17
​
18
  if (argc != 2) {
19
    fprintf(stderr,"usage: ghbn hostname\n");
20
    return 1;
21
  }
22
​
23
  if ((he = gethostbyname(argv[1])) == NULL) { // 取得 host 資訊
24
    herror("gethostbyname");
25
    return 2;
26
  }
27
​
28
  // 印出關於這個 host 的資訊：
29
  printf("Official name is: %s\n", he->h_name);
30
  printf(" IP addresses: ");
31
  addr_list = (struct in_addr **)he->h_addr_list;
32
  for(i = 0; addr_list[i] != NULL; i++) {
33
    printf("%s ", inet_ntoa(*addr_list[i]));
34
  }
35
  printf("\n");
36
​
37
  return 0;
38
}
39
// 這個方法已經被 getnameinfo() 取代了
40
​
41
struct hostent *he;
42
struct in_addr ipv4addr;
43
struct in6_addr ipv6addr;
44
​
45
inet_pton(AF_INET, "192.0.2.34", &ipv4addr);
46
he = gethostbyaddr(&ipv4addr, sizeof ipv4addr, AF_INET);
47
printf("Host name: %s\n", he->h_name);
48
​
49
inet_pton(AF_INET6, "2001:db8:63b3:1::beef", &ipv6addr);
50
he = gethostbyaddr(&ipv6addr, sizeof ipv6addr, AF_INET6);
51
printf("Host name: %s\n", he->h_name);
Copied!
參考
getaddrinfo(), getnameinfo(), gethostname(), errno, perror(), strerror(), struct in_addr
gethostname()
getnameinfo()
Last modified 1yr ago
Copy link
Contents