Movatterモバイル変換

getrpcent_r(3) — Linux manual page

getrpcent_r(3)           Library Functions Manualgetrpcent_r(3)

NAME        top

       getrpcent_r, getrpcbyname_r, getrpcbynumber_r - get RPC entry       (reentrant)

LIBRARY        top

       Standard C library (libc,-lc)

SYNOPSIS        top

#include <netdb.h>int getrpcent_r(size_t size;struct rpcent *result_buf, charbuf[size],size_tsize, struct rpcent **result);int getrpcbyname_r(size_t size;const char *name,struct rpcent *result_buf, charbuf[size],size_tsize, struct rpcent **result);int getrpcbynumber_r(size_t size;intnumber,struct rpcent *result_buf, charbuf[size],size_tsize, struct rpcent **result);   Feature Test Macro Requirements for glibc (seefeature_test_macros(7)):getrpcent_r(),getrpcbyname_r(),getrpcbynumber_r():           Since glibc 2.19:               _DEFAULT_SOURCE           glibc 2.19 and earlier:               _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION        top

       Thegetrpcent_r(),getrpcbyname_r(), andgetrpcbynumber_r()       functions are the reentrant equivalents of, respectively,getrpcent(3),getrpcbyname(3), andgetrpcbynumber(3).  They differ       in the way that therpcent structure is returned, and in the       function calling signature and return value.  This manual page       describes just the differences from the nonreentrant functions.       Instead of returning a pointer to a statically allocatedrpcent       structure as the function result, these functions copy the       structure into the location pointed to byresult_buf.       Thebuf array is used to store the string fields pointed to by the       returnedrpcent structure.  (The nonreentrant functions allocate       these strings in static storage.)  The size of this array is       specified insize.  Ifbuf is too small, the call fails with the       errorERANGE, and the caller must try again with a larger buffer.       (A buffer of size 1024 bytes should be sufficient for most       applications.)       If the function call successfully obtains an RPC record, then*result is set pointing toresult_buf; otherwise,*result is set       to NULL.

RETURN VALUE        top

       On success, these functions return 0.  On error, they return one       of the positive error numbers listed in ERRORS.       On error, record not found (getrpcbyname_r(),getrpcbynumber_r()),       or end of input (getrpcent_r())*result is set to NULL.

ERRORS        top

ENOENT(getrpcent_r()) No more records in database.ERANGEbuf is too small.  Try again with a larger buffer (and              increasedsize).

ATTRIBUTES        top

       For an explanation of the terms used in this section, seeattributes(7).       ┌───────────────────────────────┬───────────────┬────────────────┐       │Interface│Attribute│Value│       ├───────────────────────────────┼───────────────┼────────────────┤       │getrpcent_r(),                │ Thread safety │ MT-Safe locale │       │getrpcbyname_r(),             │               │                │       │getrpcbynumber_r()            │               │                │       └───────────────────────────────┴───────────────┴────────────────┘

VERSIONS        top

       Functions with similar names exist on some other systems, though       typically with different calling signatures.

STANDARDS        top

       GNU.

SEE ALSO        top

getrpcent(3),rpc(5)

COLOPHON        top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-06-28getrpcent_r(3)

Pages that refer to this page:getrpcent(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.