pam_securetty(8)

1PAM_SECURETTY(8)               Linux-PAM Manual               PAM_SECURETTY(8)
2
3
4

NAME

6       pam_securetty - Limit root login to special devices
7

SYNOPSIS

9       pam_securetty.so [debug]
10

DESCRIPTION

12       pam_securetty is a PAM module that allows root logins only if the user
13       is logging in on a "secure" tty, as defined by the listing in
14       /etc/securetty. pam_securetty also checks to make sure that
15       /etc/securetty is a plain file and not world writable. It will also
16       allow root logins on the tty specified with console= switch on the
17       kernel command line and on ttys from the /sys/class/tty/console/active.
18
19       This module has no effect on non-root users and requires that the
20       application fills in the PAM_TTY item correctly.
21
22       For canonical usage, should be listed as a required authentication
23       method before any sufficient authentication methods.
24

OPTIONS

26       debug
27           Print debug information.
28
29       noconsole
30           Do not automatically allow root logins on the kernel console
31           device, as specified on the kernel command line or by the sys file,
32           if it is not also specified in the /etc/securetty file.
33

MODULE TYPES PROVIDED

35       Only the auth module type is provided.
36

RETURN VALUES

38       PAM_SUCCESS
39           The user is allowed to continue authentication. Either the user is
40           not root, or the root user is trying to log in on an acceptable
41           device.
42
43       PAM_AUTH_ERR
44           Authentication is rejected. Either root is attempting to log in via
45           an unacceptable device, or the /etc/securetty file is world
46           writable or not a normal file.
47
48       PAM_INCOMPLETE
49           An application error occurred. pam_securetty was not able to get
50           information it required from the application that called it.
51
52       PAM_SERVICE_ERR
53           An error occurred while the module was determining the user's name
54           or tty, or the module could not open /etc/securetty.
55
56       PAM_USER_UNKNOWN
57           The module could not find the user name in the /etc/passwd file to
58           verify whether the user had a UID of 0. Therefore, the results of
59           running this module are ignored.
60

EXAMPLES

62           auth  required  pam_securetty.so
63           auth  required  pam_unix.so
64
65
66

AUTHOR

71       pam_securetty was written by Elliot Lee <sopwith@cuc.edu>.
72
73
74
75Linux-PAM Manual                  05/18/2017                  PAM_SECURETTY(8)