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

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