xref: /dflybsd-src/lib/libpam/modules/pam_rootok/pam_rootok.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_rootok/pam_rootok.8 81729 2001-08-15 20:05:33Z markm $
26242be47eSzrj.\"
27242be47eSzrj.Dd July 8, 2001
28242be47eSzrj.Dt PAM_ROOTOK 8
29242be47eSzrj.Os
30242be47eSzrj.Sh NAME
31242be47eSzrj.Nm pam_rootok
32242be47eSzrj.Nd RootOK PAM module
33242be47eSzrj.Sh SYNOPSIS
34242be47eSzrj.Op Ar service-name
35242be47eSzrj.Ar module-type
36242be47eSzrj.Ar control-flag
37242be47eSzrj.Pa pam_rootok
38242be47eSzrj.Op Ar options
39242be47eSzrj.Sh DESCRIPTION
40242be47eSzrjThe RootOK authentication service module for PAM,
41242be47eSzrj.Nm
42242be47eSzrjprovides functionality for only one PAM category:
43242be47eSzrjauthentication.
44242be47eSzrjIn terms of the
45242be47eSzrj.Ar module-type
46242be47eSzrjparameter, this is the
47242be47eSzrj.Dq Li auth
48242be47eSzrjfeature.
49242be47eSzrjIt also provides a null function for session management.
50242be47eSzrj.Ss RootOK Authentication Module
51242be47eSzrjThe RootOK authentication component
52242be47eSzrj.Pq Fn pam_sm_authenticate ,
53242be47eSzrjalways returns success for the superuser;
54242be47eSzrji.e.,
55242be47eSzrjif
56242be47eSzrj.Xr getuid 2
57242be47eSzrjreturns 0.
58242be47eSzrj.Pp
59242be47eSzrjThe following options may be passed to the authentication module:
60242be47eSzrj.Bl -tag -width ".Cm no_warn"
61242be47eSzrj.It Cm debug
62242be47eSzrj.Xr syslog 3
63242be47eSzrjdebugging information at
64242be47eSzrj.Dv LOG_DEBUG
65242be47eSzrjlevel.
66242be47eSzrj.It Cm no_warn
67242be47eSzrjsuppress warning messages to the user.
68242be47eSzrjThese messages include
69242be47eSzrjreasons why the user's
70242be47eSzrjauthentication attempt was declined.
71242be47eSzrj.El
72242be47eSzrj.Sh SEE ALSO
73242be47eSzrj.Xr getuid 2 ,
74dfc0c85aSSascha Wildner.Xr pam 3 ,
75dfc0c85aSSascha Wildner.Xr pam.conf 5
76