struct hostent
{
char *h_name; /* 主機的正式名稱*/
char **h_aliases; /* 主機的別名列表*/
int h_addrtype; /* 主機的地址型別AF_INET */
int h_length; /* 主機的地址長度*/
char **h_addr_list; /* 主機的IP地址列表*/
}
#define h_addr h_addr_list[0] /* 主機的第一個IP地址*/

struct hostent *gethostbyname(const char *name);
通過主機名 name 獲取 主機IP等資訊。成功返回給定主機名包含的主機名字和地址資訊的 hostent結構體指標。

示例如下：

#include <stdio.h>
#include <netdb.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
	if(argc != 2)
	{
		printf("Usage: %s domain_name \n",argv[0]);
		exit(EXIT_FAILURE);
	}

	struct hostent *ht = gethostbyname(argv[1]);
	if( ht )
	{
		int i = 0;
		printf("Source domain: %s \n", argv[1]);
		printf("Formal domain: %s \n", ht->h_name);
		printf("Address type: %s \n", \
				ht->h_addrtype == AF_INET ? "AF_INET" : "AF_INET6" );
		printf("Address length:%d \n", ht->h_length);

		for( ; ; ++i)
		{
			if (ht->h_aliases[i])
				printf("Aliases name %d : %s \n",i+1 ,ht->h_aliases[i]);
			else
				break;
		}

		for(i=0; ; ++i)
		{
			if (ht->h_addr_list[i])
				printf("IP Address %d : %s \n",i+1, \
						inet_ntoa((unsigned int *)ht->h_addr_list[i]));
			else
				break;
		}

	}

	return 0;
}
 

struct hostent *gethostbyaddr(const void *addr, socklen_t len, int type);
 返回對應於給定地址的包含主機名字和地址資訊的hostent結構指標。
 addr 指向網路位元組序地址的指標。
 len 地址的長度。
 type 地址型別。

示例如下：

#include <stdio.h>
#include <netdb.h>
#include <stdlib.h>

#define ADDR_LEN 	4
#define ADDR_TYPE	AF_INET

int main(int argc, char *argv[])
{
	if (argc != 2)
	{
		printf("Usage: %s IP Address\n",argv[0]);
		exit(EXIT_FAILURE);
	}
	
	struct in_addr *addr = (struct in_addr *)malloc(sizeof(struct in_addr));
	if ( ! inet_aton(argv[1], addr))
	{
		printf(" %s Invalid address",argv[1]);
		exit(EXIT_FAILURE);
	}

	struct hostent *ht = gethostbyaddr(addr, ADDR_LEN, ADDR_TYPE);

	if(ht)
	{
		int i = 0;
		printf("Source IP: %s\n",argv[1]);
		printf("Formal domain: %s \n",ht->h_name);
		printf("Address type: %s\n",ht->h_addrtype == AF_INET ? "AF_INET" : "AF_INET6");
		printf("Address length: %d \n", ht->h_length);
		
		for( ; ; ++i)
		{
			if(ht->h_aliases[i])
				printf("Aliases name %d : %s\n",i+1,ht->h_aliases[i]);
			else
				break;
		}

		for(i = 0; ; ++i)
		{
			if(ht->h_addr_list[i])
				printf("IP Address %d : %s\n",i+1, \
						inet_ntoa((unsigned int *)ht->h_addr_list[i]));
			else
				break;
		}
	}
	else
	{
		switch(h_errno)
		{
			case HOST_NOT_FOUND :
				printf("The specified host is unknown\n");
				break;

			case NO_ADDRESS:
				printf("The requested name is valid but does not have an IP address.\n");
				break;

			case NO_RECOVERY:
				printf(" A nonrecoverable name server error occurred.\n");
				break;

			case TRY_AGAIN:
				printf("A temporary error occurred in the authoritative \
						domain name server. Please try again later.\n");
				break;
		}
	}

	
	return 0;
}
 

gethostbyname（）和gethostbyaddr（）函式功能返回的HOSTENT的結構或NULL指標。
如果出現錯誤。h_errno的變數儲存的錯誤號。 
錯誤的可變h_errno的可以具有以下值： 
HOST_NOT_FOUND 
指定的主機是未知的。 
NO_ADDRESS或NO_DATA 
請求的名稱是有效的，但沒有一個IP地址。 
NO_RECOVERY 
不可恢復的名稱伺服器發生錯誤。 
TRY_AGAIN 
一個臨時錯誤發生在權威域名伺服器。請稍後再試。