pamtester(1)

1PAMTESTER(1)                General Commands Manual               PAMTESTER(1)
2
3
4

NAME

6       pamtester - test pluggable authentication module (PAM) facility
7

SYNOPSIS

9       pamtester  [-v]  [-I  item=value] [-E var=value] service user operation
10       [operation ...]
11

DESCRIPTION

13       Test pluggable authentication module (PAM) facility.
14
15       service is the PAM service name. user is the name of the  user  account
16       to  operate  with  the  PAM facility. The following operations are sup‐
17       ported.
18
19       authenticate
20              Authenticate user. A conversation may subsequently take place to
21              prompt  user input to retrieve necessary authentication informa‐
22              tion.
23
24       acct_mgmt
25              Perform account management on user.  A conversation  may  subse‐
26              quently  take place to prompt user input for necessary authenti‐
27              cation information.
28
29       open_session
30              Open a new session for user.
31
32       close_session
33              Close the current session for user.
34
35       chauthtok
36              Change the authentication  token  currently  assigned  to  user.
37              Conversation  may  subsequently  take place to prompt user input
38              for necessary authentication information.
39
40       Note that some operations may eventually need additional privileges  to
41       fulfill the request depending on the service configuration.
42
43       Any  operation  may  also be followed by the option flags that are pro‐
44       vided between the pair of parenthesis. Flags are all named and  combin‐
45       able  or  inversible  with  bitwise operators; "|" (OR), "&" (AND), "^"
46       (XOR) and "~" (NOT) are accepted.
47
48              authenticate(PAM_SILENT | PAM_DISALLOW_NULL_AUTHTOK)
49
50       The list of allowed options is shown below:
51
52       - PAM_SILENT
53
54       - PAM_DISALLOW_NULL_AUTHTOK
55
56       - PAM_ESTABLISH_CRED
57
58       - PAM_REINITIALIZE_CRED
59
60       - PAM_REFRESH_CRED
61
62       - PAM_CHANGE_EXPIRED_AUTHTOK
63
64       Additional authentication information such as the name  of  the  remote
65       user,  the  remote  host  and  the  tty can be supplied via -I (--item)
66       option.
67
68       The following types of information are supported:
69
70       - service
71
72       - user
73
74       - prompt
75
76       - tty
77
78       - ruser
79
80       - rhost
81
82

OPTIONS

84       -v, --verbose
85              Turn on verbose mode.
86
87       -I item=value, --item item=value
88              Provide additional information to authentication module.
89
90       -E var=value, --env var=value
91              Set environment variable var to value
92

AUTHOR

94       Written by Moriyoshi Koizumi <moriyoshi@users.sourceforge.net>
95

REPORTING BUGS

97       Report bugs to <pamtester-bugs@lists.sourceforge.net>.
98

COPYRIGHT

100       Copyright © 2004 - 2005 Moriyoshi Koizumi. All rights reserved.
101