Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dsexport(1) [osx man page]

dsexport(1)						    BSD General Commands Manual 					       dsexport(1)

dsexport -- export records from OpenDirectory SYNOPSIS
dsexport [--N] [-r record_list] [-e exclude_attributes] [-a address -u username [-p password]] output_file node_path record_type DESCRIPTION
The dsexport utility exports records from Open Directory. The first argument is the path to the output file. If the file already exists it will be overwritten. The second argument is the path to the OpenDirectory node from which the records will be read. The third argument is the type of record to export. If the record type does not begin with 'dsRecTypeStandard:' or 'dsRecTypeNative:', the dsexport utility will determine if the node supports a standard attribute by the specified name; otherwise, dsexport will assume that the record type is native. A warning will be printed if the record type is converted. Standard record types can be listed using the following command: 'dscl -raw . -list /'. OPTIONS
The options are as follows: --N Export all attributes, including native attributes. By default, dsexport only exports standard attributes. -r record_list Comma-separated list of records to export from the specified node. The -r option may be used multiple times to specify additional records to export. If the -r option is not specified, dsexport will attempt to export all records. -e exclude Comma-separated list of attributes that should not be exported. The -e option may be used multiple times to specify additional attributes to exclude. The following attributes are always excluded: 'dsAttrTypeStandard:AppleMetaNodeLocation', 'dsAttrTypeStandard:RecordType', 'dsAttrTypeNative:objectClass'. -a address Address of the desired proxy machine. -u username Username to use for the proxy connection -p password Password to use for the proxy connection. If the -p option is not specified, dsexport will interactively prompt for the password. NOTES
When using an LDAP node, please be aware that dsexport can only export as many records as the LDAP server is willing to return. If the LDAP server has several thousand users, you may want to raise the maximum number of search results that the server returns. This can be done in Server Admin (>OpenDirectory>Settings>Protocols tab). By default this is set to 11000 results. EXAMPLES
Export all user records from the local node to 'export.out': $ dsexport export.out /Local/Default dsRecTypeStandard:Users Export the group records for 'admin' and 'staff' from the LDAPv3 node on a proxy machine '': $ dsexport export.out /LDAPv3/ dsRecTypeStandard:Groups -r admin,staff -a -u diradmin -p password Export augmented users from the LDAPv3 node, including native attributes but excluding the PasswordPlus attribute: $ dsexport augments.out /LDAPv3/ dsRecTypeStandard:Augments --N -e "dsAttrTypeStandard:PasswordPlus" EXIT STATUS
The dsexport utility exits 0 on success, and >0 if an error occurs. SEE ALSO
dscl(1), dsimport(1), DirectoryService(8) BSD
20 November 2008 BSD

Check Out this Related Man Page

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

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: 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 <> 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
Man Page