git.sur5r.net Git - openldap/blob - doc/man/man1/ldappasswd.1

   1 .TH LDAPPASSWD 1 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-2004 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 ldappasswd \- change the password of an LDAP entry
   7 .SH SYNOPSIS
   8 .B ldappasswd
   9 [\c
  10 .BR \-A ]
  11 [\c
  12 .BI \-a \ oldPasswd\fR]
  13 [\c
  14 .BI \-t \ oldpasswdfile\fR]
  15 [\c
  16 .BI \-D \ binddn\fR]
  17 [\c
  18 .BI \-d \ debuglevel\fR]
  19 [\c
  20 .BI \-H \ ldapuri\fR]
  21 [\c
  22 .BI \-h \ ldaphost\fR]
  23 [\c
  24 .BR \-n ]
  25 [\c
  26 .BI \-p \ ldapport\fR]
  27 [\c
  28 .BR \-S ]
  29 [\c
  30 .BI \-s \ newPasswd\fR]
  31 [\c
  32 .BI \-T \ newpasswdfile\fR]
  33 [\c
  34 .BR \-v ]
  35 [\c
  36 .BR \-W ]
  37 [\c
  38 .BI \-w \ passwd\fR]
  39 [\c
  40 .BI \-y \ passwdfile\fR]
  41 [\c
  42 .BR \-O \ security-properties ]
  43 [\c
  44 .BR \-I ]
  45 [\c
  46 .BR \-Q ]
  47 [\c
  48 .BI \-U \ authcid\fR]
  49 [\c
  50 .BI \-R \ authcid\fR]
  51 [\c
  52 .BR \-x ]
  53 [\c
  54 .BI \-X \ authzid\fR]
  55 [\c
  56 .BI \-R \ realm\fR]
  57 [\c
  58 .BI \-Y \ mech\fR]
  59 [\c
  60 .BR \-Z[Z] ]
  61 [\c
  62 .IR user ]
  63 .SH DESCRIPTION
  64 .B ldappasswd
  65 is a tool to set the password of an LDAP user.
  66 .B ldappasswd
  67 uses the LDAPv3 Password Modify (RFC 3062) extended operation.
  68 .LP
  69 .B ldappasswd
  70 sets the password of associated with the user [or an optionally
  71 specified
  72 .IR user ].
  73 If the new
  74 password is not specified on the command line and the user
  75 doesn't enable prompting, the server will be asked to generate
  76 a password for the user.
  77 .LP
  78 .B ldappasswd
  79 is neither designed nor intended to be a replacement for
  80 .BR passwd (1)
  81 and should not be installed as such.
  82 .SH OPTIONS
  83 .TP
  84 .BI \-A
  85 Prompt for old password.
  86 This is used instead of specifying the password on the command line.
  87 .TP
  88 .BI \-a \ oldPasswd
  89 Set the old password to \fIoldPasswd\fP.
  90 .TP
  91 .BI \-t \ oldPasswdFile
  92 Set the old password to the contents of \fIoldPasswdFile\fP.
  93 .TP
  94 .B \-x
  95 Use simple authentication instead of SASL.
  96 .TP
  97 .BI \-D \ binddn
  98 Use the Distinguished Name \fIbinddn\fP to bind to the LDAP directory.
  99 .TP
 100 .BI \-d \ debuglevel
 101 Set the LDAP debugging level to \fIdebuglevel\fP.
 102 .B ldappasswd
 103 must be compiled with LDAP_DEBUG defined for this option to have any effect.
 104 .TP
 105 .BI \-H \ ldapuri
 106 Specify URI(s) referring to the ldap server(s).
 107 .TP
 108 .BI \-h \ ldaphost
 109 Specify an alternate host on which the ldap server is running.
 110 Deprecated in favor of -H.
 111 .TP
 112 .BI \-p \ ldapport
 113 Specify an alternate TCP port where the ldap server is listening.
 114 Deprecated in favor of -H.
 115 .TP
 116 .B \-n
 117 Do not set password. (Can be useful when used in conjunction with
 118 .BR \-v \ or
 119 .BR \-d )
 120 .TP
 121 .BI \-S
 122 Prompt for new password.
 123 This is used instead of specifying the password on the command line.
 124 .TP
 125 .BI \-s \ newPasswd
 126 Set the new password to \fInewPasswd\fP.
 127 .TP
 128 .BI \-T \ newPasswdFile
 129 Set the new password to the contents of \fInewPasswdFile\fP.
 130 .TP
 131 .B \-v
 132 Increase the verbosity of output.  Can be specified multiple times.
 133 .TP
 134 .BI \-W
 135 Prompt for bind password.
 136 This is used instead of specifying the password on the command line.
 137 .TP
 138 .BI \-w \ passwd
 139 Use \fIpasswd\fP as the password to bind with.
 140 .TP
 141 .BI \-y \ passwdfile
 142 Use complete contents of \fIpasswdfile\fP as the password for
 143 simple authentication.
 144 .TP
 145 .BI \-O \ security-properties
 146 Specify SASL security properties.
 147 .TP
 148 .B \-I
 149 Enable SASL Interactive mode.  Always prompt.  Default is to prompt
 150 only as needed.
 151 .TP
 152 .B \-Q
 153 Enable SASL Quiet mode.  Never prompt.
 154 .TP
 155 .BI \-U \ authcid
 156 Specify the authentication ID for SASL bind. The form of the ID
 157 depends on the actual SASL mechanism used.
 158 .TP
 159 .BI \-R \ realm
 160 Specify the realm of authentication ID for SASL bind. The form of the realm
 161 depends on the actual SASL mechanism used.
 162 .TP
 163 .BI \-X \ authzid
 164 Specify the requested authorization ID for SASL bind.
 165 .I authzid
 166 must be one of the following formats:
 167 .BI dn: <distinguished name>
 168 or
 169 .BI u: <username>\fP.
 170 .TP
 171 .BI \-Y \ mech
 172 Specify the SASL mechanism to be used for authentication. If it's not
 173 specified, the program will choose the best mechanism the server knows.
 174 .TP
 175 .B \-Z[Z]
 176 Issue StartTLS (Transport Layer Security) extended operation. If you use
 177 .BR \-ZZ ,
 178 the command will require the operation to be successful
 179 .SH SEE ALSO
 180 .BR ldap_sasl_bind (3),
 181 .BR ldap_extended_operation (3),
 182 .BR ldap_start_tls_s (3)
 183 .SH AUTHOR
 184 The OpenLDAP Project <http://www.openldap.org/>
 185 .SH ACKNOWLEDGEMENTS
 186 .B OpenLDAP
 187 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
 188 .B OpenLDAP
 189 is derived from University of Michigan LDAP 3.3 Release.