1.\"-
2.\" Copyright (c) 2011 Dag-Erling Sm��rgrav
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $Id: pamtest.1 471 2011-11-03 09:44:40Z des $
27.\"
28.Dd November 2, 2011
29.Dt PAMTEST 1
30.Os
31.Sh NAME
32.Nm pamtest
33.Nd PAM policy tester
34.Sh SYNOPSYS
35.Nm
36.Op Fl dksv
37.Op Fl H Ar rhost
38.Op Fl h Ar host
39.Op Fl t Ar tty
40.Op Fl U Ar ruser
41.Op Fl u Ar user
42.Ar service
43.Op Ar command ...
44.Sh DESCRIPTION
--- 66 unchanged lines hidden (view full) ---
111Specify the name of the fictitious remote host.
112The default is to use the name of the local host.
113.It Fl h Ar host
114Specify the name of the local host.
115The default is to use the result of calling
116.Xr gethostname 3 .
117.It Fl k
118Keep going even if one of the commands fails.
119.It Fl s
120Set the
121.Dv PAM_SILENT
122flag when calling the
123.Xr pam_authenticate 3 ,
124.Xr pam_acct_mgmt 3 ,
125.Xr pam_chauthok 3 ,
126.Xr pam_setcred 3 ,
--- 17 unchanged lines hidden (view full) ---
144.Sh EXAMPLES
145Simulate a typical PAM transaction using the
146.Dq system
147policy:
148.Bd -literal -offset indent
149pamtest -v system auth account change setcred open close unsetcred
150.Ed
151.Sh SEE ALSO
152.Xr openpam 3
153.Xr pam 3
154.Xr pam.conf 5
155.Sh AUTHORS
156The
157.Nm
158utility and this manual page were written by
159.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org .
160.Sh BUGS
161The
162.Nm
163utility does not (yet) support setting and getting individual PAM
164items or environment variables.
165.Pp
166The
167.Nm
168utility does not afford the user complete control over the flags
169passed to the
170.Xr pam_authenticate 3 ,
171.Xr pam_acct_mgmt 3 ,
172.Xr pam_chauthok 3 ,
173.Xr pam_setcred 3 ,
174.Xr pam_open_session 3
175and
176.Xr pam_close_session 3
177primitives.
2.\" Copyright (c) 2011 Dag-Erling Sm��rgrav
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.\" $Id: pamtest.1 471 2011-11-03 09:44:40Z des $
27.\"
28.Dd November 2, 2011
29.Dt PAMTEST 1
30.Os
31.Sh NAME
32.Nm pamtest
33.Nd PAM policy tester
34.Sh SYNOPSYS
35.Nm
36.Op Fl dksv
37.Op Fl H Ar rhost
38.Op Fl h Ar host
39.Op Fl t Ar tty
40.Op Fl U Ar ruser
41.Op Fl u Ar user
42.Ar service
43.Op Ar command ...
44.Sh DESCRIPTION
--- 66 unchanged lines hidden (view full) ---
111Specify the name of the fictitious remote host.
112The default is to use the name of the local host.
113.It Fl h Ar host
114Specify the name of the local host.
115The default is to use the result of calling
116.Xr gethostname 3 .
117.It Fl k
118Keep going even if one of the commands fails.
119.It Fl s
120Set the
121.Dv PAM_SILENT
122flag when calling the
123.Xr pam_authenticate 3 ,
124.Xr pam_acct_mgmt 3 ,
125.Xr pam_chauthok 3 ,
126.Xr pam_setcred 3 ,
--- 17 unchanged lines hidden (view full) ---
144.Sh EXAMPLES
145Simulate a typical PAM transaction using the
146.Dq system
147policy:
148.Bd -literal -offset indent
149pamtest -v system auth account change setcred open close unsetcred
150.Ed
151.Sh SEE ALSO
152.Xr openpam 3
153.Xr pam 3
154.Xr pam.conf 5
155.Sh AUTHORS
156The
157.Nm
158utility and this manual page were written by
159.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org .
160.Sh BUGS
161The
162.Nm
163utility does not (yet) support setting and getting individual PAM
164items or environment variables.
165.Pp
166The
167.Nm
168utility does not afford the user complete control over the flags
169passed to the
170.Xr pam_authenticate 3 ,
171.Xr pam_acct_mgmt 3 ,
172.Xr pam_chauthok 3 ,
173.Xr pam_setcred 3 ,
174.Xr pam_open_session 3
175and
176.Xr pam_close_session 3
177primitives.