使用这个函数,首先要包含2个头文件:
#include <netdb.h>
#include <sys/socket.h>
struct hostent *gethostbyname(const char *name);
这个函数的传入值是域名或者主机名,例如”www.google.com”,”wpc”等等。
传出值,是一个hostent的结构(如下)。
如果函数调用失败,将返回NULL。
struct hostent {
char *h_name;
char **h_aliases;
int h_addrtype;
int h_length;
char **h_addr_list;
};
解释一下这个结构, 其中:
- char *h_name 表示的是主机的规范名。例如www.google.com的规范名其实是www.l.google.com。
- char **h_aliases 表示的是主机的别名。www.google.com就是google他自己的别名。有的时候,有的主机可能有好几个别名,这些,其实都是为了易于用户记忆而为自己的网站多取的名字。
- int h_addrtype 表示的是主机ip地址的类型,到底是ipv4(AF_INET),还是ipv6(AF_INET6)
- int h_length 表示的是主机ip地址的长度
- int **h_addr_lisst 表示的是主机的ip地址,注意,这个是以网络字节序存储的。
千万不要直接用printf带%s参数来打这个东西,不能打印出正确结果。所以到真正需要打印出这个IP的话,需要调用inet_ntop()。
const char *inet_ntop(int af, const void *src, char *dst, socklen_t cnt)
这个函数,是将类型为af的网络地址结构src,转换成主机序的字符串形式,存放在长度为cnt的字符串中。
其实就是返回指向dst的一个指针。如果函数调用错误,返回值是NULL。
下面是例程,有详细的注释。
#include <netdb.h>
#include <sys/socket.h>
int main(int argc, char **argv)
{
char *ptr,**pptr;
struct hostent *hptr;
char str[32];
/* 取得命令后第一个参数,即要解析的域名或主机名 */
ptr = argv[1];
/* 调用gethostbyname()。调用结果都存在hptr中 */
if( (hptr = gethostbyname(ptr) ) == NULL )
{
printf("gethostbyname error for host:%s\n", ptr);
return 0;
/* 如果调用gethostbyname发生错误,返回1 */
}
/* 将主机的规范名打出来 */
printf("official hostname:%s\n",hptr->h_name);
/* 主机可能有多个别名,将所有别名分别打出来 */
for(pptr = hptr->h_aliases; *pptr != NULL; pptr++)
printf(" alias:%s\n",*pptr);
/* 根据地址类型,将地址打出来 */
switch(hptr->h_addrtype)
{
case AF_INET:
case AF_INET6:
pptr=hptr->h_addr_list;
// 将刚才得到的所有地址都打出来。其中调用了inet_ntop()函数
for(;*pptr!=NULL;pptr++)
printf(" address:%s\n", \
inet_ntop(hptr->h_addrtype, *pptr, str, \
sizeof(str)));
break;
default:
printf("unknown address type\n");
break;
}
return 0;
}
不可重入
它的使用注意点是:
- 这个指针指向一个静态数据,它会被后继的调用所覆盖。简单的说,它是多线程或者多进程不安全的。
- 我们最好使用h_addr代理直接使用h_addr_list,这样能够提高日后的兼容性。
- h_addr是指向一个长度为h_length的主机地址,它不是网络格式,所以在赋值给struct
- in_addr时,应该通过htonl来转化。我们可以通过下面一个学习程序来说明这种情况。
- 如果我们使用GNU环境,我们可以使用gethostbyname_r或者gethostbyname2_r来替换掉gethostbyname函数。它们能够良好的解决多线程或多进程安全性问题,并且提供选择地址族参数。
使用gethostbyname_r得到dns信息
在使用前需要看看所使用系统是否有这个函数
在网络开发中 经常出现需要从主机名得到ip地址的情况 这时就使用gethostbyname
但是因为gethostbyname返回的是一个指向静态变量的指针 不可重入 ,很可能刚要读时值就被其它线程修改
所以 新的posix中增加了另一个可重入的从主机名(域名)得到IP