1.\" Generated from pam_acct_mgmt.c by gendoc.pl
2.\" $Id: pam_acct_mgmt.c 648 2013-03-05 17:54:27Z des $
3.Dd February 19, 2017
4.Dt PAM_ACCT_MGMT 3
5.Os
6.Sh NAME
7.Nm pam_acct_mgmt
8.Nd perform PAM account validation procedures
9.Sh SYNOPSIS
10.In sys/types.h
11.In security/pam_appl.h
12.Ft "int"
13.Fn pam_acct_mgmt "pam_handle_t *pamh" "int flags"
14.Sh DESCRIPTION
15The
16.Fn pam_acct_mgmt
17function verifies and enforces account restrictions
18after the user has been authenticated.
19.Pp
20The
21.Fa flags
22argument is the binary or of zero or more of the following
23values:
24.Bl -tag -width 18n
25.It Dv PAM_SILENT
26Do not emit any messages.
27.It Dv PAM_DISALLOW_NULL_AUTHTOK
28Fail if the user's authentication token is null.
29.El
30.Pp
31If any other bits are set,
32.Fn pam_acct_mgmt
33will return
34.Dv PAM_SYMBOL_ERR .
35.Sh RETURN VALUES
36The
37.Fn pam_acct_mgmt
38function returns one of the following values:
39.Bl -tag -width 18n
40.It Bq Er PAM_ABORT
41General failure.
42.It Bq Er PAM_ACCT_EXPIRED
43User account has expired.
44.It Bq Er PAM_AUTH_ERR
45Authentication error.
46.It Bq Er PAM_BUF_ERR
47Memory buffer error.
48.It Bq Er PAM_CONV_ERR
49Conversation failure.
50.It Bq Er PAM_NEW_AUTHTOK_REQD
51New authentication token required.
52.It Bq Er PAM_PERM_DENIED
53Permission denied.
54.It Bq Er PAM_SERVICE_ERR
55Error in service module.
56.It Bq Er PAM_SYSTEM_ERR
57System error.
58.It Bq Er PAM_USER_UNKNOWN
59Unknown user.
60.El
61.Sh SEE ALSO
62.Xr pam 3 ,
63.Xr pam_strerror 3
64.Sh STANDARDS
65.Rs
66.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
67.%D "June 1997"
68.Re
69.Sh AUTHORS
70The
71.Fn pam_acct_mgmt
72function and this manual page were
73developed for the
74.Fx
75Project by ThinkSec AS and Network Associates Laboratories, the
76Security Research Division of Network Associates, Inc.\& under
77DARPA/SPAWAR contract N66001-01-C-8035
78.Pq Dq CBOSS ,
79as part of the DARPA CHATS research program.
80.Pp
81The OpenPAM library is maintained by
82.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
83