deepblue/ipmitool
1
0
Fork 0
mirror of https://github.com/ipmitool/ipmitool.git synced 2025-05-10 18:47:22 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: Update man page regarding user set password

Browse Source 
Document password length argument to "set password", as per usage info.

Since we don't check whether we're using IPMI1.5/2.0 when setting the
password, ipmitool can't reject 20-char passwords being sent to
16-char interfaces, so the behaviour is somewhat undefined.
For 20-chars, it's now clearer and long passwords will be rejected.

Man page changed to reflect the above.
This commit is contained in:
G Dutton 2019-09-02 14:22:55 +01:00 committed by Alexander Amelkin
parent 6940a6717a
commit 4dc962b614
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/ipmitool.1.in
View File

@ -259,11 +259,15 @@ system. It is thus recommended that IPMI password management only be done
over IPMIv2.0 \fIlanplus\fP interface or the system interface on the over IPMIv2.0 \fIlanplus\fP interface or the system interface on the
local station. local station.
For IPMI v1.5, the maximum password length is 16 characters. For IPMI v1.5, the maximum password length is 16 characters; longer
Passwords longer than 16 characters will be truncated. passwords might be truncated or rejected by the server, or rejected
by
.BR ipmitool .
For IPMI v2.0, the maximum password length is 20 characters; longer
passwords will be rejected by
.BR ipmitool .
For IPMI v2.0, the maximum password length is 20 characters;
longer passwords are truncated.
.SH "COMMANDS" .SH "COMMANDS"
.TP .TP
\fIhelp\fP \fIhelp\fP
@ -3526,12 +3530,13 @@ Displays a list of user information for all defined userids.
Sets the username associated with the given userid. Sets the username associated with the given userid.
.TP .TP
\fIpassword\fP <\fBuserid\fR> [<\fBpassword\fR>] \fIpassword\fP <\fBuserid\fR> [<\fBpassword\fR> [<\fB16|20\fR>]]
.br .br
Sets the password for the given userid. If no password is given, Sets the password for the given userid. If no password is given,
the password is cleared (set to the NULL password). Be careful when the password is cleared (set to the NULL password). Be careful when
removing passwords from administrator\-level accounts. removing passwords from administrator\-level accounts. If specified,
16 or 20 determines the maximum password length.
.RE .RE
.TP .TP
\fIdisable\fP <\fBuserid\fR> \fIdisable\fP <\fBuserid\fR>