NAME¶
pamtester - test pluggable authentication module (PAM) facility
SYNOPSIS¶
pamtester [-v] [-I
item=
value] [-E
var=
value]
service user operation [
operation ...]
DESCRIPTION¶
Test pluggable authentication module (PAM) facility.
service is the PAM service name.
user is the name of the user
account to operate with the PAM facility. The following operations are
supported.
- authenticate
- Authenticate user. A conversation may subsequently take place to
prompt user input to retrieve necessary authentication information.
- acct_mgmt
- Perform account management on user. A conversation may subsequently
take place to prompt user input for necessary authentication
information.
- open_session
- Open a new session for user.
- close_session
- Close the current session for user.
- chauthtok
- Change the authentication token currently assigned to user.
Conversation may subsequently take place to prompt user input for
necessary authentication information.
Note that some operations may eventually need additional privileges to fulfill
the request depending on the service configuration.
Any operation may also be followed by the option flags that are provided between
the pair of parenthesis. Flags are all named and combinable or inversible with
bitwise operators; "|" (OR), "&" (AND), "^"
(XOR) and "~" (NOT) are accepted.
- authenticate(PAM_SILENT | PAM_DISALLOW_NULL_AUTHTOK)
The list of allowed options is shown below:
- -
- PAM_SILENT
- -
- PAM_DISALLOW_NULL_AUTHTOK
- -
- PAM_ESTABLISH_CRED
- -
- PAM_REINITIALIZE_CRED
- -
- PAM_REFRESH_CRED
- -
- PAM_CHANGE_EXPIRED_AUTHTOK
Additional authentication information such as the name of the remote user, the
remote host and the tty can be supplied via
-I (
--item) option.
The following types of information are supported:
- -
- service
- -
- user
- -
- prompt
- -
- tty
- -
- ruser
- -
- rhost
OPTIONS¶
- -v, --verbose
- Turn on verbose mode.
- -I item=value, --item
item=value
- Provide additional information to authentication module.
- -E var=value, --env
var=value
- Set environment variable var to value
AUTHOR¶
Written by Moriyoshi Koizumi <moriyoshi@users.sourceforge.net>
REPORTING BUGS¶
Report bugs to <pamtester-bugs@lists.sourceforge.net>.
COPYRIGHT¶
Copyright © 2004 - 2005 Moriyoshi Koizumi. All rights reserved.
SEE ALSO¶
pam(7)