*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> getrpcbyname (3)              



NAME    [Toc]    [Back]

     getrpcent, getrpcbyname, getrpcbynumber, endrpcent, setrpcent - get RPC

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <rpc/rpc.h>

     struct rpcent *

     struct rpcent *
     getrpcbyname(char *name);

     struct rpcent *
     getrpcbynumber(int number);

     setrpcent(int stayopen);


DESCRIPTION    [Toc]    [Back]

     getrpcent(), getrpcbyname(), and getrpcbynumber(), each return a pointer
     to an object with the following structure containing the broken-out
     fields of a line in the rpc program number data base, /etc/rpc:

           struct rpcent {
                   char    *r_name;        /* name of server for this rpc program */
                   char    **r_aliases;    /* alias list */
                   long    r_number;       /* rpc program number */

     The members of this structure are:

           r_name     The name of the server for this rpc program.

           r_aliases  A zero terminated list of alternative names for the rpc

           r_number   The rpc program number for this service.

     getrpcent() reads the next line of the file, opening the file if necessary.

     setrpcent() opens and rewinds the file.  If the stayopen flag is nonzero,
 the net data base will not be closed after each call to getrpcent()
     (either directly, or indirectly through one of the other ``getrpc''

     endrpcent() closes the file.

     getrpcbyname() and getrpcbynumber() sequentially search from the beginning
 of the file until a matching rpc program name or program number is
     found, or until end-of-file is encountered.

FILES    [Toc]    [Back]


DIAGNOSTICS    [Toc]    [Back]

     A NULL pointer is returned on EOF or error.

SEE ALSO    [Toc]    [Back]

     rpc(5), rpcinfo(8), ypserv(8)

BUGS    [Toc]    [Back]

     All information is contained in a static area so it must be copied if it
     is to be saved.

BSD                            December 14, 1987                           BSD
[ Back ]
 Similar pages
Name OS Title
rpccp_add_element HP-UX Adds an element to a profile in a name service entry; if the specified entry does not exist, creates the entry
rpccp_add_member HP-UX Adds a member to a group in a name service entry; if the specified entry does not exist, creates the entry
DXmSvnFlushEntry Tru64 Displays the specified entry on the screen if it is the next logically displayed entry.
DXmSvnGetEntryNumber Tru64 Retrieves (returns) an entry number for a specified entry tag value.
acl_get_tag_type Tru64 Retrieves the entry tag type identifier for an ACL entry
csa_list_entry_attributes HP-UX list the names of the entry attributes associated with the specified entry
acl_first_entry Tru64 Resets the current ACL entry to be the first ACL entry
csa_read_entry_attributes HP-UX read and return the calendar entry attribute values for a specified calendar entry
DXmSvnSetEntryTag Tru64 Assigns an entry tag to a specified entry.
acl_copy_entry FreeBSD copy an ACL entry to another ACL entry
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service