*** UNIX MANUAL PAGE BROWSER ***

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 structure. 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), password length maximum (passlenmax), soft expiration date of a password (soft- exp), 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)