ssdi(4)

NAME
     ssdi.conf - Standardized Systems Database Interface (SSDI) configuration
     file

SYNOPSIS
     /etc/ssdi.conf

DESCRIPTION
     This file controls the behavior of accesses to standard system databases,
     such as the passwd and group databases. Normally, each database has its
     own set of standard access routines. For example, the passwd database
     routines are defined by getpwent(3C).  When such a routine is called, the
     requested information is iteratively searched through various sources.
     Usually, all database routines support a standard source which are
     compiled-in along with them.  For example, the standard source for passwd
     is the files source, which implements the database as files.  In
     addition, the database routines can be made to access sources which are
     dynamic.

     The file /etc/ssdi.conf contains entries for each database that needs to
     access dynamic sources.  Entries are separated by newlines, and entries
     with a sharp-sign (#) in column 1 are treated as comments.  Utmost one
     entry is allowed for a database. Each line begins with the name of the
     database, followed by a colon, and then a blank separated list of the
     names of dynamic sources.  Each dynamic source needs to be available as a
     Dynamic Shared Object (DSO), and physically present in _SSDI_STD_SRC_DIR
     (as defined in /usr/include/ssdi.h ). The name of the DSO for a source
     named as foo needs to be foo.so.  The maximum number of  dynamic source
     for a database is limited to _SSDI_MAXSRCS and the maximum number of
     characters in the name of a source is limited to _SSDI_MAXSRCNAME (as
     defined in /usr/include/ssdi.h ).

     Currently only the following databases are supported:  passwd, group, and
     aux.

     Following is an example of /etc/ssdi.conf which lists btree as a source
     for both passwd and group databases.

          # Sample ssdi conf file
          passwd: btree
          group: btree

     The file btree.so should be present in the _SSDI_STD_SRC_DIR directory.


FILES
     /etc/ssdi.conf /usr/include/ssdi.h

SEE ALSO
     getpwent(3C), getgrent(3C), dso(5).