.TH pam_selinux 8 2003/08/26 "Red Hat Linux" "System Administrator's Manual"
.SH NAME
pam_selinux \- set the default security context after login via PAM.
.SH SYNOPSIS
.B session optional /lib/security/pam_selinux.so
.br

.SH DESCRIPTION
In a nutshell, pam_selinux sets up the default security context for the next execed 
shell.  

When an application opens a session using pam_selinux, the shell that gets
executed will be run in the default security context, or if the user chooses
and the pam file allows the selected security context. Also the controlling
tty will have it's security context modified to match the users.

.SH ARGUMENTS
.IP debug
turns on debugging via \fBsyslog(3)\fR.
.IP multiple
tells pam_selinux.so to allow the user to select the security context they will
login with, if the user has more than one role.
.IP preserveuser
tells pam_selinux.so to get the users current context, and maintain the user componant when generating the security context they will login with.  This should be used for su type apps.
.IP nottys
Do not try to setup the ttys security context.
.IP verbose
attempt to inform the user when security context is set.

.SH EXAMPLE
\fB/etc/pam.d/some-login-program\fP:
.br
auth required   /lib/security/pam_unix.so
.br
session required /lib/security/pam_permit.so
session optional /lib/security/pam_selinux.so
.br

.SH CAVEATS
Setting the following line will cause the login to fail
auth sufficient /lib/security/pam_selinux.so verbose


.SH SEE ALSO
pam_selinux_check(8)

.SH BUGS
Let's hope not, but if you find any, please email the author.  

.SH AUTHOR
Dan Walsh <dwalsh@redhat.com>