xref: /netbsd-src/lib/libpam/modules/pam_rootok/pam_rootok.8 (revision 2f6bdc4a7b54dd45c5faf1958c4d9fd0dbe06dfd)
1*2f6bdc4aSthorpej.\" $NetBSD: pam_rootok.8,v 1.3 2005/02/26 15:13:12 thorpej Exp $
26f11bdf1Schristos.\" Copyright (c) 2001 Mark R V Murray
36f11bdf1Schristos.\" All rights reserved.
46f11bdf1Schristos.\"
56f11bdf1Schristos.\" Redistribution and use in source and binary forms, with or without
66f11bdf1Schristos.\" modification, are permitted provided that the following conditions
76f11bdf1Schristos.\" are met:
86f11bdf1Schristos.\" 1. Redistributions of source code must retain the above copyright
96f11bdf1Schristos.\"    notice, this list of conditions and the following disclaimer.
106f11bdf1Schristos.\" 2. Redistributions in binary form must reproduce the above copyright
116f11bdf1Schristos.\"    notice, this list of conditions and the following disclaimer in the
126f11bdf1Schristos.\"    documentation and/or other materials provided with the distribution.
136f11bdf1Schristos.\"
146f11bdf1Schristos.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
156f11bdf1Schristos.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
166f11bdf1Schristos.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
176f11bdf1Schristos.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
186f11bdf1Schristos.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
196f11bdf1Schristos.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
206f11bdf1Schristos.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
216f11bdf1Schristos.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
226f11bdf1Schristos.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
236f11bdf1Schristos.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
246f11bdf1Schristos.\" SUCH DAMAGE.
256f11bdf1Schristos.\"
266f11bdf1Schristos.\" $FreeBSD: src/lib/libpam/modules/pam_rootok/pam_rootok.8,v 1.4 2001/08/15 20:05:31 markm Exp $
276f11bdf1Schristos.\"
286f11bdf1Schristos.Dd July 8, 2001
296f11bdf1Schristos.Dt PAM_ROOTOK 8
306f11bdf1Schristos.Os
316f11bdf1Schristos.Sh NAME
326f11bdf1Schristos.Nm pam_rootok
336f11bdf1Schristos.Nd RootOK PAM module
346f11bdf1Schristos.Sh SYNOPSIS
356f11bdf1Schristos.Op Ar service-name
366f11bdf1Schristos.Ar module-type
376f11bdf1Schristos.Ar control-flag
386f11bdf1Schristos.Pa pam_rootok
396f11bdf1Schristos.Op Ar options
406f11bdf1Schristos.Sh DESCRIPTION
41*2f6bdc4aSthorpejThe RootOK authentication service module for PAM
426f11bdf1Schristosprovides functionality for only one PAM category:
436f11bdf1Schristosauthentication.
446f11bdf1SchristosIn terms of the
456f11bdf1Schristos.Ar module-type
466f11bdf1Schristosparameter, this is the
476f11bdf1Schristos.Dq Li auth
486f11bdf1Schristosfeature.
496f11bdf1SchristosIt also provides a null function for session management.
506f11bdf1Schristos.Ss RootOK Authentication Module
516f11bdf1SchristosThe RootOK authentication component
526f11bdf1Schristos.Pq Fn pam_sm_authenticate ,
536f11bdf1Schristosalways returns success for the superuser;
546f11bdf1Schristosi.e.,
556f11bdf1Schristosif
566f11bdf1Schristos.Xr getuid 2
576f11bdf1Schristosreturns 0.
586f11bdf1Schristos.Pp
596f11bdf1SchristosThe following options may be passed to the authentication module:
606f11bdf1Schristos.Bl -tag -width ".Cm no_warn"
616f11bdf1Schristos.It Cm debug
626f11bdf1Schristos.Xr syslog 3
636f11bdf1Schristosdebugging information at
646f11bdf1Schristos.Dv LOG_DEBUG
656f11bdf1Schristoslevel.
666f11bdf1Schristos.It Cm no_warn
676f11bdf1Schristossuppress warning messages to the user.
686f11bdf1SchristosThese messages include
696f11bdf1Schristosreasons why the user's
706f11bdf1Schristosauthentication attempt was declined.
716f11bdf1Schristos.El
726f11bdf1Schristos.Sh SEE ALSO
736f11bdf1Schristos.Xr getuid 2 ,
746f11bdf1Schristos.Xr pam.conf 5 ,
756f11bdf1Schristos.Xr pam 8
76