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