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