LDAP-UX Client Services B.05.01 Administrator Guide for HP directory servers and Windows ADS

command line. For example, if the -c argument is used to specify a new description for a host,
all occurances of the description attribute are replaced by the value specified for the -c
argument. This mode of operation applies to the -I command argument as well.
When the attr=value parameter is used to modify an existing attribute, the ldaphostmgr
command also uses the LDAP replace operation. The replace operation will remove all occurrences
of the specified attribute for an entry and replace it with the value specified. If there are multiple
values for a single attribute in an entry, the use of a single attr=value parameter will replace
all values with the single value specified on the command line. Note that it is possible to specify
more than one occurrence of the same attribute on the command line, if that attribute is multi-valued,
in which case, both values will be created in the entry.
Use of -A or -R changes this behavior (for both the previously-listed command arguments and the
attr=value parameters). Any attribute specified as an argument to the -A or -R option will
cause ldaphostmgr to perform an LDAP add operation instead of an LDAP replace operation.
Example: Suppose an entry in an LDAP directory appears as follows:
dn: cn=chef,ou=Hosts,dc=cup,dc=hp,dc=com
cn: chef
ipHostNumber: 0.0.0.0
objectClass: top
objectClass: device
objectClass: iphost
objectClass: domainEntity
owner: uid=domadmin,ou=People,dc=cup,dc=hp,dc=com
entityRole: WebServer
entityRole: DBServer
Performing the following ldaphostmgr command:
ldaphostmgr chef “entityRole=NFSServer”
Replaces all instances of cn:
dn: cn=chef,ou=Hosts,dc=cup,dc=hp,dc=com
cn: chef
ipHostNumber: 1.2.3.4
objectClass: top
objectClass: device
objectClass: iphost
objectClass: domainEntity
owner: uid=domadmin,ou=People,dc=cup,dc=hp,dc=com
entityRole: NFSServer
As a general rule, be cautious before using ldaphostmgr to change multi-valued attributes.
Also note that ldaphostmgr does not allow use of the same attribute and value pair more than
once, either specified as part of attr=value, -R or -A, or from other command-line options (for
example -i for ipAddress where ipAddress is mapped to some other attribute). ldaphostmgr
will exit with error status before sending any conflicting modification request to the directory server.
9.3.8.7 Errors and Warnings
Upon exit, ldaphostmgr returns a 0 (zero) exit status if no errors or warnings were encountered.
If ldaphostmgr encounters an error or warning; a nonzero exit status is returned, and one or
more messages are logged to stderr. Messages have the following format:
ERROR: code:
message
or
WARNING: code:
message
Leading extra white space might be inserted to improve readability and follow 80-column screen
formatting. code is a programmatically parsable error key-string, while message is
human-readable. For a list of possible error codes generated by the LDAP user and group
9.3 LDAP user and group management tools 339