osf1 man page for getsvc

Query: getsvc

OS: osf1

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

getsvc(3)						     Library Functions Manual							 getsvc(3)

NAME
getsvc - Gets a pointer to the svcinfo structure.
SYNOPSIS
#include <sys/svcinfo.h> struct svcinfo *getsvc()
DESCRIPTION
The getsvc call retrieves information from the system about the svcinfo structure by returning a pointer to the structure. This structure is initialized the first time a getsvc call is made. The contents of the /etc/svc.conf file are parsed and stored in the svcinfo struc- ture. If the /etc/svc.conf file is modified, the contents of this structure will be updated upon the next getsvc call. The /etc/svc.conf file contains the names of the databases that can be served by BIND or local files and the name service selection for each database. It also has settings for four security parameters. The database service selection and security parameters are stored in the svcinfo structure. The following structure exists in the <svcinfo.h> file: #define SVC_DATABASES 20 #define SVC_PATHSIZE 8 struct svcinfo { int svcdate; /* Last mod date of /etc/svc.conf */ int svcpath[SVC_DATABASES][SVC_PATHSIZE]; /* indexed by databases and choice 0=first choice 1=second choice, etc value stored is source */ struct { int passlenmin; int passlenmax; int softexp; int seclevel; } svcauth; }; The svcdate field contains the date that the /etc/svc.conf file was last modified. The svcpath array contains the name service choices for each database. The svcauth structure contains the values for the four security parameters: password length minimum (passlenmin), pass- word length maximum (passlenmax), soft expiration date of a password (softexp), and security mode of a system (seclevel).
EXAMPLES
The following programming example shows how to use the getsvc call to use the information in the svcinfo structure to process specific host information. #include <sys/svcinfo.h> struct svcinfo *svcinfo; if ((svcinfo = getsvc()) != NULL) for (i=0; (j = svcinfo->svcpath[SVC_HOSTS][i]) != SVC_LAST; i++) switch(j) { case SVC_BIND: /* process BIND hosts */ case SVC_YP: /* process YP hosts */ case SVC_LOCAL: /* process LOCAL hosts */ }
FILES
RELATED INFORMATION
svc.conf(4), svcsetup(8) delim off getsvc(3)
Related Man Pages
gethostbyname_r(3) - osf1
gethostbyname(3n) - ultrix
getsvc(3) - ultrix
gethostbyname(3) - osf1
getservent_r(3) - osf1
Similar Topics in the Unix Linux Community
Help
Comapilation error with Switch statement