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