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

getnetbyname_r(3) OSS Library Calls Reference Manual
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 setnetent( ), getnetent( ),
getnetent_r( ), getnetbyaddr( ), getnetbyaddr_r( ), getnetbyname( ), getnetbyname_r( ), or
endnetent( ) functions.
RETURN VALUES
Upon successful completion, the getnetbyname_r( ) function returns a pointer to a netent struc-
ture if the network name was found, and a null pointer if it was not found. If the call to
getnetbyname_r( ) fails, a null pointer is returned. If an entry is found, the pointer returned by
this function points to the same netent structure as pointed to by the result parameter.
3−90 Hewlett-Packard Company 527187-017