Mercurial > ecos-v2_0-branch
diff packages/net/tcpip/current/doc/getserv.man @ 97:ced4577552cd ecos-sw-2000-06-06
Merge from eCos master repository on 2000-06-06-08:44:00-BST
| author | jlarmour |
|---|---|
| date | Tue, 06 Jun 2000 08:39:36 +0000 |
| parents | |
| children |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/packages/net/tcpip/current/doc/getserv.man @@ -0,0 +1,48 @@ +NAME + getservent, getservbyname, getservbyport - get service entry + +SYNOPSIS + #include <network.h> + + struct servent *getservbyname(const char *name, const char *proto); + + struct servent *getservbyport(int port, const char *proto); + +DESCRIPTION + The getservbyname() function returns a servent structure + for the line from /etc/services that matches the service + name using protocol proto. + + The getservbyport() function returns a servent structure + for the line that matches the port port given in network + byte order using protocol proto. + + The servent structure is defined in <netdb.h> as follows: + + struct servent { + char *s_name; /* official service name */ + char **s_aliases; /* alias list */ + int s_port; /* port number */ + char *s_proto; /* protocol to use */ + } + + The members of the servent structure are: + + s_name The official name of the service. + + s_aliases + A zero terminated list of alternative names for the + service. + + s_port The port number for the service given in network + byte order. + + s_proto + The name of the protocol to use with this service. + +RETURN VALUE + The getservbyname() and getservbyport() + functions return the servent structure, or a NULL pointer + if an error occurs. + +
