Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (g - h) getnetbyaddr_r(3)
NAME
getnetbyaddr_r - Gets a network entry by address (reentrant)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that do not use the Standard POSIX Thread library: |
/G/system/zdllnnn/zinetdll |
64-bit H-series and J-series OSS processes that do not use the Standard POSIX Thread library: |
/G/system/zdllnnn/yinetdll |
H-series and J-series OSS processes that use the Standard POSIX Thread library:
/G/system/zdllnnn/zsptdll
(See NOTES)
SYNOPSIS
[#include <sys/socket.h>]
#include <netdb.h>
[#include <spthread.h>] /* Required if using Standard POSIX Threads Library */
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; you must use the value AF_INET
or AF_INET6.
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 and per-
forms the same function. However, the getnetbyaddr_r( ) function uses buffers that are supplied
by the caller of the function to store returned results.
The ret parameter must be a pointer to a struct netent structure allocated by the caller. On suc-
cessful completion, the function returns the network entry in this structure. The buffer parameter
must be a pointer to a buffer supplied by the caller. This buffer is used as storage space for the
host data. All of the pointers within the returned struct netent ret point to data stored within this
buffer. The buffer must be large enough to hold all of the data associated with the host entry. For
H06.21 and later H-series RVUs and J06.10 and later J-series RVUs, HP recommends that the
size of the buffer, indicated by the buflen parameter, be equal or greater than the size of the
netent_data structure.
If multiple threads interleave calls to getnetbyaddr_r( ), getnetbyname_r( ), getnetent_r( ) and
their base versions, the threads enumerate disjoint subsets of the networks database.
527187-017 Hewlett-Packard Company 3−85