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

OSS Library Calls (g - h) gethostent_r(3)
NOTES
Use the endhostent( ) function to close the /etc/hosts file.
NonStop TCP/IPv6 searches for host information can be controlled by the environment variable
TCPIP_RESOLVER_ORDER, as described in the environ(5) reference page.
On systems running H-series RVUs earlier than H06.21, J-series RVUs earlier than J06.10, or
G-series RVUs (native OSS processes only), follow the instructions for using the Standard
POSIX Threads library.
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded
applications.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use |
this function with 32-bit applications or 64-bit applications unless you are using the Standard |
POSIX Threads Library.
If you are NOT using the Standard POSIX Threads Library (this is not a threaded application or
you are using the POSIX User Thread Model Library), you must:
• Include the netdb.h header file
If you are using the Standard POSIX Threads library, you must:
• Include the spthread.h header file
• Link your application to:
/G/system/sysnn/zsptsrl (G-series)
or
/G/system/zdllnnn/zsptdll (H-series or J-series)
• Compile your application using the #define _SPT_MODEL_ macro or an equivalent
compiler command option
If you are using this function in a threaded or 64-bit application in a system running H06.21 or a |
later H-series RVU or J06.10 or a later J-series RVU, you might need to include additional files |
or use additional macros. For more information about threaded and 64-bit applications in the |
OSS environment, see the Open System Services Programmer’s Guide.
In a threaded environment, the behavior of the application is undetermined if more than one
thread in application is calling different sequences of the sethostent( ), gethostent( ),
gethostent_r( ), gethostbyaddr( ), gethostbyaddr_r( ), gethostbyname( ), gethostbyname_r( ),
or endhostent( ) functions.
RETURN VALUES
On successful completion, gethostent_r( ) returns a pointer to a hostent structure if the entry was
found, and a null pointer if the end of the database was reached. If the call to gethostent_r( )
fails, a null pointer is returned. If an entry is found, the pointer returned by this function points to
the same hostent structure as pointed to by the host parameter.
527187-017 Hewlett-Packard Company 3−67