TCP/IP Programming Manual

NO_RECOVERY
An error has occurred from which there is no recovery.
Example
The example makes a call to gethostbyname2 by passing the host-name and address family as
arguments. If an answer is found, a pointer to the hostent structure is returned and stored in hp.
NULL is returned if no answer is found.
int af;
char *name;
struct hostent *hp;
hp = gethostbyname2(name, af);
Usage Guidelines
• The parameter name passed to the gethostbyname2 function is case-sensitive.
• The hostent structure is statically declared. Subsequent calls to gethostbyname2 replace
the existing data in the hostent structure.
gethostid
The gethostid function gets the host ID of the local host. The host address returned corresponds
to the address returned in the SCF command INFO PROCESS (or its programmatic equivalent).
C Synopsis
#include <netdb.h>
id = gethostid ();
int id;
TAL Synopsis
?NOLIST, SOURCE SOCKDEFT
?NOLIST, SOURCE SOCKPROC
id := gethostid ();
INT(32) id;
id
return value; an integer, assigned by the system administrator, which uniquely identifies the
host to the Internet. Often it is the local address part of the Internet address assigned to the
host. This is the return value.
Errors
No errors are returned for this function.
gethostname
The gethostname function gets the official name by which the local host is known to the Internet.
The hostname returned corresponds to the hostname returned in the SCF command INFO PROCESS
(or its programmatic equivalent).
C Synopsis
#include <netdb.h>
error = gethostname (buffer, buffer_length);
int error;
gethostid 113