ldapugadd.1m (2010 09)

l
ldapugadd(1M) ldapugadd(1M)
-F Force creation of new user or group entries even if particular error conditions occur. These are:
• The user name or group name already exists in the directory server.
• The user id or group id number already exists in the directory server
• The shell specified with the
-s option does not exist on the local system or is not an execut-
able.
• Adding a member to a group when that member is not defined in the LDAP directory.
Note that some directory servers perform their own attribute uniqueness checks. In this case,
even if the
-F option is specified;
ldapugadd will be unable to add the new entry.
-S Display the DN of the newly created entry.
Arguments
-h hostname Specifies the host name and optional port number (hostname
:port) of the directory
server. This option overrides the server list configured by ldapux (5). The hostname field
also supports specification of IPv4 and IPv6 addresses.
Note that when a port is specified for an IPv6 address, the IPv6 address must be specified
in square-bracketed form. If the optional port is unspecified, the port number is assumed
to be 389 or 636 for SSL connections (
-Z). Refer to Binding to the Directory Server below
for additional details.
-p port Specifies the port number of the directory server to contact. This option is ignored if the
port number is specified in the hostname as part of the -h option. Refer to Binding to
the Directory Server below for additional details.
-b base This option overrides value of the ${basedn } substitution construct used in the respec-
tive template file. Instead of discovering the ${basedn } value from the ldapux (5)
configuration profile, the value defined in base will be used. Please refer to Template
Files below for additional information. base is expected to be an LDAP distinguished
name.
-t type Specifies on which service type ldapugadd will operate. The service type can be either
passwd or group, where
passwd implies posixAccount-type entries, and
group implies posixGroup-type entries.
The command-line arguments that are applicable will depend on the service specified. If
unspecified,
ldapugadd defaults to passwd.
Note: to be consistent with the Name Service Switch (see switch (4)), the term
passwd is
used to represent LDAP user entries which contain POSIX account-related information.
Arguments Applicable to -D
-D Used to permanently alter local host defaults which are used by ldapugadd when creat-
ing new user or group entries in the LDAP directory. Configuration changes made using
the -D options will appear in the /etc/opt/ldapux/ldapug.conf
file. Please refer
to the LDAP-UX Client Services Administrator’s Guide for an example of the
ldapug.conf file.
-d default_home
Specifies the parent directory that will be used when creating new user home directories.
-s default_shell
Specifies the default login shell that will be used when creating user entries.
-g default_gid Specifies the default group ID number used when creating new user entries. To avoid
warning messages displayed by ldapugadd, this group ID should represent a POSIX-
style group stored in the LDAP directory.
If this group ID is not defined in the LDAP directory,
ldapugadd will display a warning
message every time a new user is added using this default group, since ldapugadd will
be unable to add the user as a member of that group.
-g min_gid :max_gid
Sets new default minimum and maximum ranges that ldapugadd will use when provi-
sioning a group ID number for newly created group entries. The gid range is inclusive of
2 Hewlett-Packard Company − 2 − HP-UX 11i v3: June 2010 Web Release