contrib/openpam/doc/man/pam_acct_mgmt.3

   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
  15 The
  16 .Fn pam_acct_mgmt
  17 function verifies and enforces account restrictions
  18 after the user has been authenticated.
  19 .Pp
  20 The
  21 .Fa flags
  22 argument is the binary or of zero or more of the following
  23 values:
  24 .Bl -tag -width 18n
  25 .It Dv PAM_SILENT
  26 Do not emit any messages.
  27 .It Dv PAM_DISALLOW_NULL_AUTHTOK
  28 Fail if the user's authentication token is null.
  29 .El
  30 .Pp
  31 If any other bits are set,
  32 .Fn pam_acct_mgmt
  33 will return
  34 .Dv PAM_SYMBOL_ERR .
  35 .Sh RETURN VALUES
  36 The
  37 .Fn pam_acct_mgmt
  38 function returns one of the following values:
  39 .Bl -tag -width 18n
  40 .It Bq Er PAM_ABORT
  41 General failure.
  42 .It Bq Er PAM_ACCT_EXPIRED
  43 User account has expired.
  44 .It Bq Er PAM_AUTH_ERR
  45 Authentication error.
  46 .It Bq Er PAM_BUF_ERR
  47 Memory buffer error.
  48 .It Bq Er PAM_CONV_ERR
  49 Conversation failure.
  50 .It Bq Er PAM_NEW_AUTHTOK_REQD
  51 New authentication token required.
  52 .It Bq Er PAM_PERM_DENIED
  53 Permission denied.
  54 .It Bq Er PAM_SERVICE_ERR
  55 Error in service module.
  56 .It Bq Er PAM_SYSTEM_ERR
  57 System error.
  58 .It Bq Er PAM_USER_UNKNOWN
  59 Unknown 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
  70 The
  71 .Fn pam_acct_mgmt
  72 function and this manual page were
  73 developed for the
  74 .Fx
  75 Project by ThinkSec AS and Network Associates Laboratories, the
  76 Security Research Division of Network Associates, Inc.\& under
  77 DARPA/SPAWAR contract N66001-01-C-8035
  78 .Pq Dq CBOSS ,
  79 as part of the DARPA CHATS research program.
  80 .Pp
  81 The OpenPAM library is maintained by
  82 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .