getservbyport man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

endservent(3XNET)X/Open Networking Services Library Functionsendservent(3XNET)

NAME
       endservent, getservbyport, getservbyname, getservent, setservent - net‐
       work services database functions

SYNOPSIS
       cc [ flag ... ] file ... -lxnet [ library ... ]
       #include <netdb.h>

       void endservent(void)

       struct servent *getservbyname(const char *name, const char *proto);

       struct servent *getservbyport(int port, const char *proto);

       struct servent *getservent(void)

       void setservent(int stayopen);

DESCRIPTION
       The getservbyname(), getservbyport() and	 getservent()  functions  each
       return  a  pointer to a servent structure, the members of which contain
       the fields of an entry in the network services database.

       The getservent() function reads the next entry of the database, opening
       a connection to the database if necessary.

       The  getservbyname()  function searches the database from the beginning
       and finds the first entry for which the service name specified by  name
       matches	the  s_name  member  and  the protocol name specified by proto
       matches the s_proto member, opening a connection	 to  the  database  if
       necessary.  If proto is a null pointer, any value of the s_proto member
       will be matched.

       The getservbyport() function searches the database from	the  beginning
       and  finds the first entry for which the port specified by port matches
       the s_port member and the protocol name specified by proto matches  the
       s_proto	member, opening a connection to the database if necessary.  If
       proto is a null pointer, any  value  of	the  s_proto  member  will  be
       matched.	 The port argument must be in network byte order.

       The  setservent() function opens a connection to the database, and sets
       the next entry to the first entry.  If the stayopen  argument  is  non-
       zero,  the  net database will not be closed after each call to the get‐
       servent() function, either directly, or indirectly through one  of  the
       other getserv*() functions.

       The endservent() function closes the database.

USAGE
       The  port  argument  of getservbyport() need not be compatible with the
       port values of all address families.

       The getservent(), getservbyname()  and  getservbyport()	functions  may
       return  pointers to static data, which may be overwritten by subsequent
       calls to any of these functions.

       These functions are generally used with the Internet address family.

RETURN VALUES
       On successful completion, getservbyname(), getservbyport() and  getser‐
       vent()  return  a pointer to a servent structure if the requested entry
       was found, and a null pointer if the end of the database was reached or
       the  requested  entry  was  not	found.	 Otherwise,  a null pointer is
       returned.

ERRORS
       No errors are defined.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       endhostent(3XNET), endprotoent(3XNET), htonl(3XNET),  inet_addr(3XNET),
       attributes(5), standards(5)

SunOS 5.11			  14 Jun 2002		     endservent(3XNET)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net