localemanager(8) [mojave man page]

localemanager(8)					    BSD System Manager's Manual 					  localemanager(8)

NAME

     localemanager -- Configure OpenDirectory Server Locales

SYNOPSIS

     localemanager operation [-l localename] [-subnet 1.2.3.4/5] [-server servername] [-i IP address]

DESCRIPTION

     localemanager creates, destroys, and edits OpenDirectory Server Locale information.  Locales are collections of OpenDirectory servers to
     assist clients in locating the nearest OpenDirectory Server.

     To use OpenDirectory Server Locales, simply create a locale on an OD server with the createLocale operation.  Then add servers and subnets to
     the locale.  All localemanager operations are performed on the local OpenDirectory node.

     The first time a locale is created, a DefaultLocale will automatically be created as well.  The DefaultLocale will be used for any clients
     that don't match a subnet in any other locale.

     Before a locale can be configured, the server must already be an OpenDirectory server.

     Locales can be defined on each of the OD servers or on a single OD server in the group of OD master/replicas.  For the latter, the locale
     information will get replicated to all of the other servers but locales will need to be "enabled" on the other servers by running the command
     localemanager enableLocales.

     Commands:

     help	   Displays the commands and options.

     createLocale  Creates a new locale on the local OD server.  This command requires the -l option.

     deleteLocale  Deletes a locale from the local OD server.  This command requires the -l option.

     showLocale    Displays the current locale(s).  The -l option can be used to display a specific locale.  If -l is not specified, all locales
		   are displayed.

     enableLocales
		   Enables the use of locales on an OD server.	This command is automatically run the first time any localemanager command is run
		   on an OD server.  Therefore this command only needs to be run if no other localemanager commands have been (or will be) run on
		   this server.

     addSubnet	   Adds a new subnet to the specified locale.  This command requires the -l -subnet options.

     removeSubnet  Removes a subnet from the specified locale.	This command requires -l -subnet options.

     addServer	   Adds a server to the specified locale. This command requires the -l -server options.  If the -i option is specified, that IP
		   address will be used by locale clients.  This may be useful for multi-homed servers to restrict locale clients to a specific
		   network interface.  If the -i option is not specified the IP address(es) will be looked up.

     removeServer  Removes a server from the specified locale.	This command requires -l -server options.  If the -i option is specified, only
		   that IP address will be removed from the locale.  If the -i option is no specified, all of the server's IP addresses will be
		   removed from the locale.

     Options:

     -l locale	 Locale name.

     -subnet 192.168.0.0/16
		 Subnet specified in CIDR notation.

     -server server.example.com
		 Server fully-qualified domain name.

     -i 192.168.1.1
		 Use this IP address for the server.  Typically used to limit locale clients to a specific interface on a multi-homed server.

FILES

     /var/log/localemanager.log 		   localemanager log file.

SEE ALSO

     slapconfig(8)

HISTORY

     First introduced in Mac OS X 10.7

Darwin								   June 1, 2019 							    Darwin

opendirectoryd(8)					    BSD System Manager's Manual 					 opendirectoryd(8)

NAME

     opendirectoryd -- is a launchd(8) job for client access to local or remote directory systems

SYNOPSIS

     opendirectoryd [--version]

DESCRIPTION

     opendirectoryd is a launchd(8) job which replaces "DirectoryService" as a core part of the Open Directory technology. Several modules are
     provided that allow access to existing directory systems:

	   o   Active Directory
	   o   LDAP
	   o   Local Database
	   o   NIS

   Modules
     opendirectoryd modules have specific capabilities:

	   Authentication  password verification, password changes, etc.
	   Connection	   general connections used for queries, record modifications, etc.
	   Discovery	   location and prioritization of servers to contact (a.k.a., service discovery)
	   Unspecified	   a generic module used for unspecified purpose (usually to extend capabilities)

     Third party plugins developed for "DirectoryService" are supported via dspluginhelperd(8).

   Open Directory
     Open Directory is a technology which includes a client API abstraction layer, a directory server, and the opendirectoryd daemon.  This allows
     clients to utilize a single API to access a variety of directory servers simultaneously or configure their own directory server.

     Open Directory forms the foundation of how Mac OS X accesses all authoritative configuration information (users, groups, mounts, managed
     desktop data, etc.).  This allows use of virtually any directory system via Apple and third party modules.

     Configuration of opendirectoryd is done via "System Preferences" under the "Users & Groups" preference pane. Advanced settings are available
     by using "Open Directory Utility..." within "Users & Groups" preference pane.

     More information is available from the Open Directory website:

	 http://developer.apple.com/darwin/projects/opendirectory/

   Open Directory Server
     Open Directory Server utilizes OpenLDAP which is included as part of Mac OS X Client, Mac OS X Server, and Darwin. OpenLDAP provides a robust
     and scalable platform for serving directory-based information for both standalone and networked systems.

   NFSv4 Domain name
     The following will set the default domain name used to map user and group identities in NFSv4 client/server operations.

     dscl . -create Config/NFSv4Domain RealName <Example.com>

     This command requires root privileges.

FILES

     Files are stored in various locations for opendirectoryd depending on use.  A list of folders and files are shown below.

   System files provided by Apple and should only change with operating system updates:
     /System/Library/OpenDirectory/Configurations/
						  node configuration files
     /System/Library/OpenDirectory/DynamicNodeTemplates/
						  dynamic node definitions
     /System/Library/OpenDirectory/Mappings/	  record/attribute mapping tables
     /System/Library/OpenDirectory/Modules/	  modules to be loaded on demand
     /System/Library/OpenDirectory/Templates/	  templates used for node styles (module layout and mappings)
     /System/Library/OpenDirectory/record-schema.plist
						  OpenDirectory record/attribute schema
     /System/Library/OpenDirectory/permissions.plist
						  OpenDirectory global record/attribute permissions

   User defined files:
     /Library/OpenDirectory/Templates/		  templates used for node styles (module layout and mappings)
     /Library/OpenDirectory/Mappings/		  record/attribute mapping tables

   Files that change periodically are located in:
     /Library/Preferences/OpenDirectory/Configurations/
						  node configuration files
     /Library/Preferences/OpenDirectory/DynamicData/
						  dynamic data stored by nodes
     /Library/Preferences/OpenDirectory/.LogDebugAtStartOnce
						  enables debug logging until process exits or system is rebooted (reboot required)
     /var/log/opendirectoryd.log*		  log file(s) for opendirectoryd

   Legacy locations:
     /Library/DirectoryServices/PlugIns/	  third party DirectoryService plugins loaded by dspluginhelperd

SEE ALSO

     odutil(1), dspluginhelperd(8), slapd(8)

BSD
								   March 3, 2011							       BSD