Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
YPLDAP.CONF(5)		    BSD	File Formats Manual		YPLDAP.CONF(5)

NAME
     ypldap.conf -- LDAP YP map	daemon configuration file

DESCRIPTION
     The ypldap(8) daemon provides YP maps using LDAP as a backend.

SECTIONS
     The ypldap.conf config file is divided into three main sections.

     Macros
	   User-defined	variables may be defined and used later, simplifying
	   the configuration file.

     Global Configuration
	   Global settings for ypldap(8).

     Directories
	   LDAP	Directory specific parameters.

MACROS
     Much like cpp(1) or m4(1),	macros can be defined that will	later be ex-
     panded in context.	 Macro names must start	with a letter, digit, or un-
     derscore, and may contain any of those characters.	 Macro names may not
     be	reserved words (for example, domain).  Macros are not expanded inside
     quotes.

     For example:

	   fixed_gecos="Pulled from LDAP"

	   fixed attribute gecos $fixed_gecos

GLOBAL CONFIGURATION
     Global settings concern the main behaviour	of the daemon.

     domain string
	     Specify the name of the NIS domain	ypldap.conf will provide.
     interval seconds
	     Specify the interval in seconds at	which the whole	directory will
	     be	pulled from LDAP.
     provide map string
	     Specify a map that	should be provided by ypldap.conf The cur-
	     rently implemented	maps are: passwd.byname, passwd.byuid,
	     group.byname, group.bygid.

DIRECTORIES
     Directories are used to describe the LDAP schema and help ypldap.conf
     convert LDAP entries to passwd(5),	master.passwd(5), and group(5) lines.
     A directory declaration is	of the following form:

	   directory "some.host" {
		   # directives
	   }

     Valid directives for directories are:

     attribute name maps to string
	     Map the passwd(5),	master.passwd(5), or group(5) attribute	to the
	     LDAP attribute name supplied.

     basedn string
	     Use the supplied search base as starting point for	the directory
	     search.

     groupdn string
	     Use the supplied search base as starting point for	the directory
	     search for	groups.	 If not	supplied, the basedn value will	be
	     used.

     bindcred string
	     Use the supplied credentials for simple authentication against
	     the directory.

     binddn string
	     Use the supplied Distinguished Name to bind to the	directory.

     fixed attribute attribute string
	     Do	not retrieve the specified attribute from LDAP but instead set
	     it	unconditionally	to the supplied	value for every	entry.

     group filter string
	     Use the supplied LDAP filter to retrieve group entries.

     list name maps to string
	     Map the passwd(5),	master.passwd(5), or group(5) attribute	to the
	     LDAP attribute name supplied.  A list creates a comma separated
	     list of all the LDAP attributes found.

	     Valid attributes are:

		   name
		   passwd
		   uid
		   gid
		   gecos
		   home
		   shell
		   change
		   expire
		   class
		   groupname
		   grouppasswd
		   groupgid
		   groupmembers

     passwd filter string
	     Use the supplied LDAP filter to retrieve password entries.

FILES
     /etc/ypldap.conf  ypldap(8) configuration file.
     /usr/share/example/ypldap/ypldap.conf
		       ypldap(8) configuration file example.

SEE ALSO
     ypbind(8),	ypldap(8), ypserv(8)

HISTORY
     The ypldap.conf file format first appeared	in OpenBSD 4.4.

BSD			       January 13, 2016				   BSD

NAME | DESCRIPTION | SECTIONS | MACROS | GLOBAL CONFIGURATION | DIRECTORIES | FILES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ypldap.conf&sektion=5&manpath=FreeBSD+11.0-RELEASE>

home | help