Netscape ENTERPRISE SERVER 6.1, Manual

Page: 154 / 373

NSAPI Functions (in Alphabetical Order)
154 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
N
net_ip2host
The
net_ip2host
function transforms a textual IP address into a fully-qualified
domain name and returns it.
Syntax
char *net_ip2host(char *ip, int verify);
Returns
A new string containing the fully-qualified domain name, if the transformation
was accomplished or NULL if the transformation was not accomplished.
Parameters
char *ip
is the IP (Internet Protocol) address as a character string in
dotted-decimal notation:
nnn
.
nnn
.
nnn
.
nnn
int verify
, if non-zero, specifies that the function should verify the
fully-qualified domain name. Though this requires an extra query, you should use
it when checking access control.
net_read
The
net_read
function reads bytes from a specified socket into a specified buffer.
The function waits to receive data from the socket until either at least one byte is
available in the socket or the specified time has elapsed.
Syntax
int net_read (SYS_NETFD sd, char *buf, int sz, int timeout);
Returns
The number of bytes read, which will not exceed the maximum size,
sz
. A negative
value is returned if an error has occurred, in which case
errno
is set to the constant
ETIMEDOUT
if the operation did not complete before
timeout
seconds elapsed.
NOTE This function works only if the
DNS
directive is enabled in the
magnus.conf
file. For more information, see Chapter 7, “Syntax
and Use of magnus.conf.”