1pam_acct_mgmt(3PAM)          PAM Library Functions         pam_acct_mgmt(3PAM)
2
3
4

NAME

6       pam_acct_mgmt - perform PAM account validation procedures
7

SYNOPSIS

9       cc [ flag ... ] file ... -lpam [ library ... ]
10       #include <security/pam_appl.h>
11
12
13
14       int pam_acct_mgmt(pam_handle_t *pamh, int flags);
15
16

DESCRIPTION

18       The  pam_acct_mgmt()  function  is  called  to determine if the current
19       user's account is valid.  It checks for password  and  account  expira‐
20       tion, and verifies access hour restrictions. This function is typically
21       called  after  the  user  has  been  authenticated  with  pam_authenti‐
22       cate(3PAM).
23
24
25       The  pamh argument is an authentication handle obtained by a prior call
26       to pam_start(). The following flags may be set in the flags field:
27
28       PAM_SILENT                   The account management service should  not
29                                    generate any messages.
30
31
32       PAM_DISALLOW_NULL_AUTHTOK    The   account  management  service  should
33                                    return PAM_NEW_AUTHTOK_REQD  if  the  user
34                                    has a null authentication token.
35
36

RETURN VALUES

38       Upon  successful  completion,   PAM_SUCCESS is returned. In addition to
39       the error return values described in pam(3PAM),  the  following  values
40       may be returned:
41
42       PAM_USER_UNKNOWN        User not known to underlying account management
43                               module.
44
45
46       PAM_AUTH_ERR            Authentication failure.
47
48
49       PAM_NEW_AUTHTOK_REQD    New authentication token required. This is nor‐
50                               mally returned if the machine security policies
51                               require that the  password  should  be  changed
52                               because the password is  NULL or has aged.
53
54
55       PAM_ACCT_EXPIRED        User account has expired.
56
57

ATTRIBUTES

59       See attributes(5) for description of the following attributes:
60
61
62
63
64       ┌─────────────────────────────┬─────────────────────────────┐
65       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
66       ├─────────────────────────────┼─────────────────────────────┤
67       │Interface Stability          │ Stable                      │
68       ├─────────────────────────────┼─────────────────────────────┤
69       │MT-Level                     │MT-Safe with exceptions      │
70       └─────────────────────────────┴─────────────────────────────┘
71

SEE ALSO

73       pam(3PAM),   pam_authenticate(3PAM),   pam_start(3PAM),   libpam(3LIB),
74       attributes(5)
75

NOTES

77       The interfaces in  libpam are MT-Safe only if each  thread  within  the
78       multithreaded application uses its own PAM handle.
79
80
81
82SunOS 5.11                        13 Oct 1998              pam_acct_mgmt(3PAM)
Impressum