ldaphostmgr.1m (2010 09)

l
ldaphostmgr(1M) ldaphostmgr(1M)
-A attrval Specifies an attribute and value to be added to an entry. The format of attrval is
attribute
=value, where attribute is the name of the attribute to add, and value is
the specific instance of that attribute. The
-A option is used when working with
multi-valued attributes, to add a new value for a multi-valued attribute, without
removing already existing values for that attribute.
Note that use of the
-A option interacts with the optional attr
=value parameters.
The
-A option may be specified more than once per command line. The value por-
tion of attrval may be an empty string.
If you add a new attribute type to an entry, you will also need to add the associated
object class if that object class is not already part of the host entry.
-B relbase Specifies where the host entry should be found/created. However, instead if specify-
ing a full base DN, it is relative to the default search base configured in LDAP-UX
(refer to the -b option of the ldapcfinfo(1M) command.) For example, if the default
search base is
dc=example,dc=org
and -B ou=mycomputers
is specified,
then the default parent for the host will be
ou=mycomputers,
dc=example,dc=org
.
If the
-a option is specified, then the new host entry will be created under the
resulting DN. If the -m option is specified, then only the resulting DN will be used
for the search base when discovering hosts. And if the -d option is specified, then
ldaphostmgr will search for hosts to delete only under the resulting DN.
Note, the resulting parent (container) DN is assumed to already exist in the direc-
tory server. It will not be created, even when the
-a or -F options are specified.
-c comment Specifies the comment/description to be associated with the host entry. The com-
ment text will be added as a value in the description attribute. If the description
already attribute exists, then all values will be replaced with the specified comment.
If the ! option is specified, the description attribute will be removed entirely.
-C If the directory server authentication credentials have not been specified in the
LDAP_BINDDN and LDAP_BINDCRED environment variables, then the
-C option
tells
ldaphostmgr to use the credentials specified in the
/etc/opt/ldapux/acred
file. If that file does not exist, or the user running
ldaphostmgr does not have sufficient privilege to read that file, then lda-
phostmgr will prompt for directory server authentication credentials, unless
-X
has been specified. Without the -C option, the acred file is not used. Refer to
Binding the Directory Server’ for additional information.
-d Deletes a host entry. This removes specified host entry from the directory server.
This also removes the host as a member from any group that contains this host as a
memeber.
The
-a (add), -d (delete), and -m (modify) options are mutually exclusive. The -m
option is the default if none of these three options is specified.
-E envfile Reads environment variables from a file. The file entries have the following syntax:
ENV_NAME=value
Where value may be quoted. The quote (ASCII 34) character and the escape char-
acter (backslash ASCII 92) must always be escaped if they are part of the value
itself. Example:
LDAP_HOSTCRED="Rfxw-\"92"
In this case, the password value will be: Rfxw-\"92
-f If the host_name specified is a short name (without the fully qualified DNS domain),
-f will add/modify the fully qualified host name to the host entry. Example:
cn=host.domain.org.
Both the short and full name will be added to the cn (or mapped) attribute.
-f applies to both the -a and -m operations. If host_name is already fully qualified
(contains a domain), then the -f option has no effect. Only host_name will be
added to the entry. ldaphostmgr uses the /etc/resolv.conf file to
2 Hewlett-Packard Company − 2 − HP-UX 11i v3: June 2010 Web Release