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