Open System Services System Calls Reference Manual (G06.28+)

System Functions (f - i) getnetbyaddr_r(2)
NAME
getnetbyaddr_r - Gets a network entry by address (reentrant)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
[#include <sys/socket.h>]
[#include <netdb.h>]
#include <spthread.h>
struct netent *getnetbyaddr_r (
in_addr_t num,
int type,
struct netent *ret,
char *buffer,
int buflen
);
PARAMETERS
num Specifies the number of the network in host-byte order
type Specifies the Internet domain address format; the value AF_INET or
AF_INET6 must be used
ret Points to a struct netent structure allocated by the caller
buffer Points to the buffer supplied by the caller and used as a storage space for
returned data
buflen Specifies the size of the buffer passed in bytes
DESCRIPTION
The getnetbyaddr_r() function is the reentrant version of the getnetbyaddr() function.
The getnetbyaddr_r() function searches the /etc/networks file sequentially until a match with
the num and type parameters is found.
The getnetbyaddr_r() function returns a pointer to a structure of type netent whose members
specify data from the /etc/networks network name database file. The netdb.h header file defines
the netent structure.
The getnetbyaddr_r() function updates the netent structure pointed to by the ret parameter.
Storage referenced by the netent structure is allocated from the memory provided using the
buffer parameter, which is buflen characters in size.
RETURN VALUES
Upon successful completion, the getnetbyaddr_r() function returns a pointer to a netent struc-
ture if the address was found, and a null pointer if the address was not found. If the call to
getnetbyaddr_r( ) fails, a null pointer is returned.
ERRORS
If the following condition occurs, the getnetbyaddr_r() function sets errno to the corresponding
value:
527186-005 Hewlett-Packard Company 3−63