https://spectrum.alioth.net/doc/index.php?action=history&feed=atom&title=Gethostbyname 2026-05-07T21:25:49Z Revision history for this page on the wiki MediaWiki 1.37.1 https://spectrum.alioth.net/doc/index.php?title=Gethostbyname&diff=149&oldid=prev 2008-08-16T12:27:07Z

<p>New page: &#039;&#039;&#039;gethostbyname (IXCALL 0x3E27)&#039;&#039;&#039; - get network host entry == Synopsis == &#039;&#039;Assembly language&#039;&#039; ld hl, STR_HOSTNAME ld de, BUF_ADDRESS ld ix, GETHOSTBYNAME call IXCALL...</p> <p><b>New page</b></p><div>'''gethostbyname (IXCALL 0x3E27)''' - get network host entry<br /> <br /> == Synopsis ==<br /> <br /> ''Assembly language''<br /> <br /> ld hl, STR_HOSTNAME<br /> ld de, BUF_ADDRESS<br /> ld ix, GETHOSTBYNAME<br /> call IXCALL<br /> <br /> ''C''<br /> <br /> #include &lt;netdb.h&gt;<br /> <br /> struct hostent *gethostbyname(char *name);<br /> <br /> == Description ==<br /> <br /> The '''gethostbyname()''' call converts the string passed in ''name'' to an address. The parameter ''name'' may be a null-terminated hostname (such as 'www.worldofspectrum.org' or a null-terminated dotted decimal string representation of an IP address. If a dotted decimal address is passed, no lookup is made, and the string is converted to a 4 byte big-endian representation of the address. If a hostname is passed, the hostname is looked up using the DNS protocol, and the resolved address is returned as a 4 byte big-endian value. With the current implementation, only one address is returned on a successful lookup.<br /> <br /> For the C function call, the pointer returned is to a statically allocated buffer. If the value returned needs to be preserved when a subsequent call to gethostbyname() is made, the value must be copied before the next call is made.<br /> <br /> For the assembly language interface, the register pair HL points to a null-terminated string containing the hostname or dotted decimal IP address, and the DE register pair points to a location in memory with at least 4 bytes free to receive the 4 byte big-endian representation of the address.<br /> <br /> == Return values ==<br /> <br /> The C interface returns a null pointer if gethostbyname() fails to resolve the address.<br /> <br /> The assembly language interface returns with the carry flag set on error, with the A register containing the return code.<br /> <br /> [[Category:Spectranet]]</div>

Winston