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

gethostent_r(3) OSS Library Calls Reference Manual
NAME
gethostent_r - Gets the next entry in the network host database (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 <netdb.h>
[#include <spthread.h>] /* Required if using Standard POSIX Threads Library */
struct hostent *gethostent_r (
struct hostent *host,
char *buffer,
int buflen,
int *h_errnop);
PARAMETERS
host Points to a struct hostent structure allocated by the caller.
buffer Points to the buffer supplied by the caller and used as a storage space for host
data.
buflen Specifies the size of the buffer passed in bytes. For H06.21 and later H-series
RVUs and J06.10 and later J-series RVUs, HP recommends that this buffer be at
least equal to the size of the hostent_data structure.
h_errnop Points to the integer h_errno to indicate the error code if an error occurs. For
possible values, see the ERRORS subsection of this reference page. For H06.20
and earlier H-series RVUs and J06.09 and earlier J-series RVUs, h_errno is a
global integer.
DESCRIPTION
The gethostent_r( ) function is the reentrant version of the gethostent( ) function and performs
the same function. However, the gethostent_r( ) function uses buffers that are supplied by the
caller of the function to store returned results.
The host parameter must be a pointer to a struct hostent structure allocated by the caller. On
successful completion, the function returns the host 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 hostent host point to data stored within
this buffer. See the RETURN VALUES section for more information. 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 hostent_data structure.
The hostent structure is defined in the netdb.h header file. All functions that return the hostent
structure must return the official (canonical) name of the host in the h_name field.
If multiple threads interleave calls to gethostbyname_r( ), gethostbyaddr_r( ), gethostent_r( )
and their base versions, the threads enumerate disjoint subsets of the hosts database.
3−66 Hewlett-Packard Company 527187-017