Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

getprotobyname(3n) [ultrix man page]

getprotoent(3n) 														   getprotoent(3n)

Name
       getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent - get protocols entry

Syntax
       #include <netdb.h>

       struct protoent *getprotoent()

       struct protoent *getprotobyname(name)
       char *name;

       struct protoent *getprotobynumber(proto)
       int proto;

       void setprotoent(stayopen)
       int stayopen;

       void endprotoent()

Description
       The and subroutines each return a pointer to an object with the following structure containing the broken-out fields of a line in the data-
       base.
       struct	 protoent {
	    char *p_name;  /* official name of protocol */
	    char **p_aliases;	/* alias list */
	    long p_proto;  /* protocol number */
       };

       The members of this structure are:

       p_name	  The official name of the protocol.

       p_aliases  A zero terminated list of alternate names for the protocol.

       p_proto	  The protocol number.

       If the stayopen flag on a subroutine is NULL, the protocols database is opened.	Otherwise the has the effect of  rewinding  the  protocols
       database.  The may be called to close the protocols database when processing is complete.

       The  subroutine	simply	reads the next line while and search until a matching name or proto number is found (or until EOF is encountered).
       The subroutine keeps a pointer in the database, allowing successive calls to be used to search the entire file.

       A call to must be made before a loop using in order to perform initialization and an must be used after the loop.  Both and make  calls	to
       and

Restrictions
       All  information is contained in a static area so it must be copied if it is to be saved.  Only the Internet protocols are currently under-
       stood.

       If YP is running, does not return the entries in any particular order.  See the Guide to the Yellow Pages Service for setup information.

       The services database may also be distributed using the BIND/Hesiod naming service.  See the Guide to  the  BIND/Hesiod	Service  for  more
       information.

Return Values
       Null pointer(0) returned on EOF or error.

Files
See Also
       protocols(5), svc.conf(5)
       Guide to the BIND/Hesiod Service
       Guide to the Yellow Pages Service

																   getprotoent(3n)

Check Out this Related Man Page

GETPROTOENT(3)						     Linux Programmer's Manual						    GETPROTOENT(3)

NAME
getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - get protocol entry SYNOPSIS
#include <netdb.h> struct protoent *getprotoent(void); struct protoent *getprotobyname(const char *name); struct protoent *getprotobynumber(int proto); void setprotoent(int stayopen); void endprotoent(void); DESCRIPTION
The getprotoent() function reads the next line from the file /etc/protocols and returns a structure protoent containing the broken out fields from the line. The /etc/protocols file is opened if necessary. The getprotobyname() function returns a protoent structure for the line from /etc/protocols that matches the protocol name name. The getprotobynumber() function returns a protoent structure for the line that matches the protocol number number. The setprotoent() function opens and rewinds the /etc/protocols file. If stayopen is true (1), then the file will not be closed between calls to getprotobyname() or getprotobynumber(). The endprotoent() function closes /etc/protocols. The protoent structure is defined in <netdb.h> as follows: struct protoent { char *p_name; /* official protocol name */ char **p_aliases; /* alias list */ int p_proto; /* protocol number */ } The members of the protoent structure are: p_name The official name of the protocol. p_aliases A zero terminated list of alternative names for the protocol. p_proto The protocol number. RETURN VALUE
The getprotoent(), getprotobyname() and getprotobynumber() functions return the protoent structure, or a NULL pointer if an error occurs or the end of the file is reached. FILES
/etc/protocols protocol database file CONFORMING TO
BSD 4.3 SEE ALSO
getservent(3), getnetent(3), protocols(5) BSD
1993-04-24 GETPROTOENT(3)
Man Page