xref: /dflybsd-src/lib/libpam/modules/pam_deny/pam_deny.8 (revision c98db40744766ab0803912f29557df02814bcd9d)
1242be47eSzrj.\" Copyright (c) 2001 Mark R V Murray
2242be47eSzrj.\" All rights reserved.
3242be47eSzrj.\"
4242be47eSzrj.\" Redistribution and use in source and binary forms, with or without
5242be47eSzrj.\" modification, are permitted provided that the following conditions
6242be47eSzrj.\" are met:
7242be47eSzrj.\" 1. Redistributions of source code must retain the above copyright
8242be47eSzrj.\"    notice, this list of conditions and the following disclaimer.
9242be47eSzrj.\" 2. Redistributions in binary form must reproduce the above copyright
10242be47eSzrj.\"    notice, this list of conditions and the following disclaimer in the
11242be47eSzrj.\"    documentation and/or other materials provided with the distribution.
12242be47eSzrj.\"
13242be47eSzrj.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14242be47eSzrj.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15242be47eSzrj.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16242be47eSzrj.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17242be47eSzrj.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18242be47eSzrj.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19242be47eSzrj.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20242be47eSzrj.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21242be47eSzrj.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22242be47eSzrj.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23242be47eSzrj.\" SUCH DAMAGE.
24242be47eSzrj.\"
25*c98db407SSascha Wildner.\" $FreeBSD: head/lib/libpam/modules/pam_deny/pam_deny.8 81729 2001-08-15 20:05:33Z markm $
26242be47eSzrj.\"
27242be47eSzrj.Dd July 7, 2001
28242be47eSzrj.Dt PAM_DENY 8
29242be47eSzrj.Os
30242be47eSzrj.Sh NAME
31242be47eSzrj.Nm pam_deny
32242be47eSzrj.Nd Deny PAM module
33242be47eSzrj.Sh SYNOPSIS
34242be47eSzrj.Op Ar service-name
35242be47eSzrj.Ar module-type
36242be47eSzrj.Ar control-flag
37242be47eSzrj.Pa pam_deny
38242be47eSzrj.Op Ar options
39242be47eSzrj.Sh DESCRIPTION
40242be47eSzrjThe Deny authentication service module for PAM,
41242be47eSzrj.Nm
42242be47eSzrjprovides functionality for all the PAM categories:
43242be47eSzrjauthentication,
44242be47eSzrjaccount management,
45242be47eSzrjsession management and
46242be47eSzrjpassword management.
47242be47eSzrjIn terms of the
48242be47eSzrj.Ar module-type
49242be47eSzrjparameter, these are the
50242be47eSzrj.Dq Li auth ,
51242be47eSzrj.Dq Li account ,
52242be47eSzrj.Dq Li session ,
53242be47eSzrjand
54242be47eSzrj.Dq Li password
55242be47eSzrjfeatures.
56242be47eSzrj.Pp
57242be47eSzrjThe Deny module
58242be47eSzrjwill universally deny all requests.
59242be47eSzrjIt is primarily of use during testing,
60242be47eSzrjand to
61242be47eSzrj.Dq null-out
62242be47eSzrjunwanted functionality.
63242be47eSzrj.Pp
64242be47eSzrjThe following options may be passed to the module:
65242be47eSzrj.Bl -tag -width ".Cm no_warn"
66242be47eSzrj.It Cm debug
67242be47eSzrj.Xr syslog 3
68242be47eSzrjdebugging information at
69242be47eSzrj.Dv LOG_DEBUG
70242be47eSzrjlevel.
71242be47eSzrj.It Cm no_warn
72242be47eSzrjsuppress warning messages to the user.
73242be47eSzrjThese messages include
74242be47eSzrjreasons why the user's
75242be47eSzrjauthentication attempt was declined.
76242be47eSzrj.El
77242be47eSzrj.Sh SEE ALSO
78dfc0c85aSSascha Wildner.Xr pam 3 ,
79242be47eSzrj.Xr syslog 3 ,
80dfc0c85aSSascha Wildner.Xr pam.conf 5
81