SYNOPSIS<\/a>
DESCRIPTION<\/a>
RETURN VALUE<\/a>
ERRORS<\/a>
ATTRIBUTES<\/a>
CONFORMING TO<\/a>
SEE ALSO<\/a>
COLOPHON<\/a> <\/p>\n
\n
NAME <\/a> <\/h2>\ngetnetent_r, getnetbyname_r, getnetbyaddr_r \u2212 get network entry (reentrant)<\/p>\n
SYNOPSIS <\/a> <\/h2>\n#include <\/b><\/p>\nint getnetent_r(struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>,
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
int getnetbyname_r(const char *<\/b>name<\/i>,
struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>,
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
int getnetbyaddr_r(uint32_t<\/b> net<\/i>, int<\/b> type<\/i>,
struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>,
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
Feature Test Macro Requirements for glibc (see feature_test_macros<\/b>(7)):<\/p>\n
getnetent_r<\/b>(), getnetbyname_r<\/b>(), getnetbyaddr_r<\/b>():
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_BSD_SOURCE || _SVID_SOURCE<\/p>\nDESCRIPTION <\/a> <\/h2>\nThe getnetent_r<\/b>(), getnetbyname_r<\/b>(), and getnetbyaddr_r<\/b>() functions are the reentrant equivalents of, respectively, getnetent<\/b>(3), getnetbyname<\/b>(3), and getnetbynumber<\/b>(3). They differ in the way that the netent<\/i> structure is returned, and in the function calling signature and return value. This manual page describes just the differences from the nonreentrant functions.<\/p>\n
Instead of returning a pointer to a statically allocated netent<\/i> structure as the function result, these functions copy the structure into the location pointed to by result_buf<\/i>.<\/p>\n
The buf<\/i> array is used to store the string fields pointed to by the returned netent<\/i> structure. (The nonreentrant functions allocate these strings in static storage.) The size of this array is specified in buflen<\/i>. If buf<\/i> is too small, the call fails with the error ERANGE<\/b>, and the caller must try again with a larger buffer. (A buffer of length 1024 bytes should be sufficient for most applications.)<\/p>\n
If the function call successfully obtains a network record, then *result<\/i> is set pointing to result_buf<\/i>; otherwise, *result<\/i> is set to NULL.<\/p>\n
The buffer pointed to by h_errnop<\/i> is used to return the value that would be stored in the global variable h_errno<\/i> by the nonreentrant versions of these functions.<\/p>\nRETURN VALUE <\/a> <\/h2>\nOn success, these functions return 0. On error, they return one of the positive error numbers listed in ERRORS.<\/p>\n
On error, record not found (getnetbyname_r<\/b>(), getnetbyaddr_r<\/b>()), or end of input (getnetent_r<\/b>()) result<\/i> is set to NULL.<\/p>\nERRORS <\/a> <\/h2>\n
#include int getnetent_r(struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>, int getnetbyname_r(const char *<\/b>name<\/i>, int getnetbyaddr_r(uint32_t<\/b> net<\/i>, int<\/b> type<\/i>, Feature Test Macro Requirements for glibc (see feature_test_macros<\/b>(7)):<\/p>\n getnetent_r<\/b>(), getnetbyname_r<\/b>(), getnetbyaddr_r<\/b>(): The getnetent_r<\/b>(), getnetbyname_r<\/b>(), and getnetbyaddr_r<\/b>() functions are the reentrant equivalents of, respectively, getnetent<\/b>(3), getnetbyname<\/b>(3), and getnetbynumber<\/b>(3). They differ in the way that the netent<\/i> structure is returned, and in the function calling signature and return value. This manual page describes just the differences from the nonreentrant functions.<\/p>\n Instead of returning a pointer to a statically allocated netent<\/i> structure as the function result, these functions copy the structure into the location pointed to by result_buf<\/i>.<\/p>\n The buf<\/i> array is used to store the string fields pointed to by the returned netent<\/i> structure. (The nonreentrant functions allocate these strings in static storage.) The size of this array is specified in buflen<\/i>. If buf<\/i> is too small, the call fails with the error ERANGE<\/b>, and the caller must try again with a larger buffer. (A buffer of length 1024 bytes should be sufficient for most applications.)<\/p>\n If the function call successfully obtains a network record, then *result<\/i> is set pointing to result_buf<\/i>; otherwise, *result<\/i> is set to NULL.<\/p>\n The buffer pointed to by h_errnop<\/i> is used to return the value that would be stored in the global variable h_errno<\/i> by the nonreentrant versions of these functions.<\/p>\n On success, these functions return 0. On error, they return one of the positive error numbers listed in ERRORS.<\/p>\n On error, record not found (getnetbyname_r<\/b>(), getnetbyaddr_r<\/b>()), or end of input (getnetent_r<\/b>()) result<\/i> is set to NULL.<\/p>\n
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>,
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
struct netent *<\/b>result_buf<\/i>, char *<\/b>buf<\/i>,
size_t<\/b> buflen<\/i>, struct netent **<\/b>result<\/i>,
int *<\/b>h_errnop<\/i>);<\/b><\/p>\n
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_BSD_SOURCE || _SVID_SOURCE<\/p>\nDESCRIPTION <\/a> <\/h2>\n
RETURN VALUE <\/a> <\/h2>\n
ERRORS <\/a> <\/h2>\n
![\"Image](\"grohtml-1662341.png\")
<\/p>\n