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

NAME

6       pam_usertype - check if the authenticated user is a system or regular
7       account
8

SYNOPSIS

10       pam_usertype.so [flag...] {condition}
11

DESCRIPTION

13       pam_usertype.so is designed to succeed or fail authentication based on
14       type of the account of the authenticated user. The type of the account
15       is decided with help of SYS_UID_MAX settings in /etc/login.defs. One
16       use is to select whether to load other modules based on this test.
17
18       The module should be given only one condition as module argument.
19       Authentication will succeed only if the condition is met.
20

OPTIONS

22       The following flags are supported:
23
24       use_uid
25           Evaluate conditions using the account of the user whose UID the
26           application is running under instead of the user being
27           authenticated.
28
29       audit
30           Log unknown users to the system log.
31
32       Available conditions are:
33
34       issystem
35           Succeed if the user is a system user.
36
37       isregular
38           Succeed if the user is a regular user.
39

MODULE TYPES PROVIDED

41       All module types (account, auth, password and session) are provided.
42

RETURN VALUES

44       PAM_SUCCESS
45           The condition was true.
46
47       PAM_BUF_ERR
48           Memory buffer error.
49
50       PAM_CONV_ERR
51           The conversation method supplied by the application failed to
52           obtain the username.
53
54       PAM_INCOMPLETE
55           The conversation method supplied by the application returned
56           PAM_CONV_AGAIN.
57
58       PAM_AUTH_ERR
59           The condition was false.
60
61       PAM_SERVICE_ERR
62           A service error occurred or the arguments can't be parsed
63           correctly.
64
65       PAM_USER_UNKNOWN
66           User was not found.
67

EXAMPLES

69       Skip remaining modules if the user is a system user:
70
71           account sufficient pam_usertype.so issystem
72
73

SEE ALSO

75       login.defs(5), pam(8)
76

AUTHOR

78       Pavel Březina <pbrezina@redhat.com>
79
80
81
82Linux-PAM                         05/07/2023                   PAM_USERTYPE(8)
Impressum