getprotoent(3N)

get protocol entry

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

NAME

getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent - get protocol entry

SYNOPSIS

#include <netdb.h>
struct protoent *getprotoent()
struct protoent *getprotobyname(name)
char *name;
struct protoent *getprotobynumber(proto)
int proto;
setprotoent(stayopen)
int stayopen;
endprotoent()

DESCRIPTION

getprotoent(), getprotobyname(), and getprotobynumber() each
return  a  pointer to an object with the following structure
containing the broken-out fields of a line  in  the  network
protocol data base, /etc/protocols.
     struct    protoent {
          char *p_name;        /* official name of protocol */
          char **p_aliases;    /* alias list */
          int  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.
getprotoent() reads the next line of the file,  opening  the
file  if  necessary.   setprotoent()  opens  and rewinds the
file.  If the stayopen flag is non-zero, the net  data  base
will  not be closed after each call to getprotoent() (either
directly, or indirectly through one of the other  "getproto"
calls).   endprotoent()  closes  the file.  getprotobyname()
and getprotobynumber() sequentially search from  the  begin-
ning  of the file until a matching protocol name or protocol
number is found, or until an EOF is encountered.

FILES

/etc/protocols

DIAGNOSTICS