Developer's Daily Unix by Example
  main | java | perl | unix | dev directory | web log
 
 
Main
Unix
Man Pages
   

GETSERVENT

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
FILES
CONFORMING TO
SEE ALSO

NAME

getservent, getservbyname, getservbyport, setservent, endservent ? get service entry

SYNOPSIS

#include <netdb.h>

struct servent *getservent(void);

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

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

void setservent(int stayopen);

void endservent(void);

DESCRIPTION

The getservent() function reads the next line from the file /etc/services and returns a structure servent containing the broken out fields from the line. The /etc/services file is opened if necessary.

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 setservent() function opens and rewinds the /etc/services file. If stayopen is true (1), then the file will not be closed between calls to getservbyname() and getservbyport().

The endservent() function closes /etc/services.

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 getservent(), getservbyname() and getservbyport() functions return the servent structure, or a NULL pointer if an error occurs or the end of the file is reached.

FILES

/etc/services

services database file

CONFORMING TO

BSD 4.3

SEE ALSO

getprotoent(3), getnetent(3), services(5)


copyright 1998-2007, devdaily.com, all rights reserved.
devdaily.com, an alvin j. alexander production.