|
The xpasswd utility is used to manage an XCICS external password file (xpasswd file).
With xpasswd, it is possible to perform the following operation on users:
| • | enable or disable the user |
Furthermore, it is also possible the configure the password handling features, for the XCICS regions that make use of the xpasswd file beeing managed, and in particular:
| • | set passwords minimum and maximum length |
| • | set password management activity log file |
| • | set password expiration period |
| • | set the maximum allowed number of login failures |
Unless overridden by the "-f" option, xpasswd manages by default the file $HOME/etc/xpasswd
Syntax:
xpasswd [options] username password
Options
General options:
-v, --verbose
|
turns verbose mode on
|
-f, --file <file>
|
uses <file> instead of default file $HOME/etc/xpasswd
|
-?, --help
|
shows the help
|
User management options (username must be provided):
-p, --password <password>
|
updates the password of the user
|
-e, --enable
|
enables the user account
|
-d, --disable
|
disables the user account
|
-r, --reset
|
resets the user's password
|
-c, --check <password>
|
checks username and password
|
Configuration options:
-s, --show-conf
|
shows the current configuration
|
-l, --conf-log <file>
|
activates password management logging on <file>
|
-n, --conf-nolog
|
deactivates password management logging
|
-P, --conf-password-validity <N>
|
sets the password expiration period to <N> days If set to 0 (zero), passwords will never expire
|
-A, --conf-alert-expiring <N>
|
sets the number of days in advance the user will begin receiving warnings that his password will expire. Iif set to 0 (zero), user will never receive warning in advance
|
-L, --conf-max-login-failures
|
sets the number of consecutive login failures after that the user's account will be disabled. If set to 0 (zero), user account will never be disabled
|
-m, --conf-min-password-len <N>
|
sets the minimum admittable password length in chars
|
-M, --conf-max-password-len <N>
|
sets the maximum admittable password length in chars
|
|
