xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_acct_mgmt.3 (revision 0d9d0fd8a30be9a1924e715bbcf67a4a83efd262)
1*0d9d0fd8Schristos.\"	$NetBSD: pam_acct_mgmt.3,v 1.9 2023/06/30 21:46:20 christos Exp $
244269bb5Schristos.\"
38fa0fefeSchristos.\" Generated from pam_acct_mgmt.c by gendoc.pl
4*0d9d0fd8Schristos.Dd June 27, 2023
544269bb5Schristos.Dt PAM_ACCT_MGMT 3
644269bb5Schristos.Os
744269bb5Schristos.Sh NAME
844269bb5Schristos.Nm pam_acct_mgmt
944269bb5Schristos.Nd perform PAM account validation procedures
1044269bb5Schristos.Sh SYNOPSIS
1144269bb5Schristos.In sys/types.h
1244269bb5Schristos.In security/pam_appl.h
1344269bb5Schristos.Ft "int"
1444269bb5Schristos.Fn pam_acct_mgmt "pam_handle_t *pamh" "int flags"
1544269bb5Schristos.Sh DESCRIPTION
1644269bb5SchristosThe
17e1b25b17Schristos.Fn pam_acct_mgmt
1844269bb5Schristosfunction verifies and enforces account restrictions
1944269bb5Schristosafter the user has been authenticated.
2044269bb5Schristos.Pp
2144269bb5SchristosThe
2244269bb5Schristos.Fa flags
2344269bb5Schristosargument is the binary or of zero or more of the following
2444269bb5Schristosvalues:
2544269bb5Schristos.Bl -tag -width 18n
2644269bb5Schristos.It Dv PAM_SILENT
2744269bb5SchristosDo not emit any messages.
2844269bb5Schristos.It Dv PAM_DISALLOW_NULL_AUTHTOK
2944269bb5SchristosFail if the user's authentication token is null.
3044269bb5Schristos.El
3144269bb5Schristos.Pp
3244269bb5SchristosIf any other bits are set,
33e1b25b17Schristos.Fn pam_acct_mgmt
3444269bb5Schristoswill return
3544269bb5Schristos.Dv PAM_SYMBOL_ERR .
3644269bb5Schristos.Sh RETURN VALUES
3744269bb5SchristosThe
38e1b25b17Schristos.Fn pam_acct_mgmt
3944269bb5Schristosfunction returns one of the following values:
4044269bb5Schristos.Bl -tag -width 18n
414cb4af11Schristos.It Bq Er PAM_SUCCESS
424cb4af11SchristosSuccess.
4344269bb5Schristos.It Bq Er PAM_ABORT
4444269bb5SchristosGeneral failure.
4544269bb5Schristos.It Bq Er PAM_ACCT_EXPIRED
4644269bb5SchristosUser account has expired.
4744269bb5Schristos.It Bq Er PAM_AUTH_ERR
4844269bb5SchristosAuthentication error.
4944269bb5Schristos.It Bq Er PAM_BUF_ERR
5044269bb5SchristosMemory buffer error.
5144269bb5Schristos.It Bq Er PAM_CONV_ERR
5244269bb5SchristosConversation failure.
5344269bb5Schristos.It Bq Er PAM_NEW_AUTHTOK_REQD
5444269bb5SchristosNew authentication token required.
5544269bb5Schristos.It Bq Er PAM_PERM_DENIED
5644269bb5SchristosPermission denied.
5744269bb5Schristos.It Bq Er PAM_SERVICE_ERR
5844269bb5SchristosError in service module.
5944269bb5Schristos.It Bq Er PAM_SYSTEM_ERR
6044269bb5SchristosSystem error.
6144269bb5Schristos.It Bq Er PAM_USER_UNKNOWN
6244269bb5SchristosUnknown user.
6344269bb5Schristos.El
6444269bb5Schristos.Sh SEE ALSO
6544269bb5Schristos.Xr pam 3 ,
6644269bb5Schristos.Xr pam_strerror 3
6744269bb5Schristos.Sh STANDARDS
6844269bb5Schristos.Rs
6944269bb5Schristos.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
7044269bb5Schristos.%D "June 1997"
7144269bb5Schristos.Re
7244269bb5Schristos.Sh AUTHORS
7344269bb5SchristosThe
74e1b25b17Schristos.Fn pam_acct_mgmt
75e1b25b17Schristosfunction and this manual page were
76e1b25b17Schristosdeveloped for the
7744269bb5Schristos.Fx
78e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the
7944269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under
8044269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035
8144269bb5Schristos.Pq Dq CBOSS ,
8244269bb5Schristosas part of the DARPA CHATS research program.
838fa0fefeSchristos.Pp
848fa0fefeSchristosThe OpenPAM library is maintained by
854cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
86