Home | History | Annotate | Line # | Download | only in man
pam_sm_chauthtok.3 revision 1.5 
      1 <<<<<<< pam_sm_chauthtok.3
      2 .\"	$NetBSD: pam_sm_chauthtok.3,v 1.5 2014/10/24 18:17:56 christos Exp $
      3 .\"
      4 =======
      5 >>>>>>> 1.1.1.4
      6 .\" Generated from pam_sm_chauthtok.c by gendoc.pl
      7 .\" Id: pam_sm_chauthtok.c 648 2013-03-05 17:54:27Z des 
      8 .Dd September 12, 2014
      9 .Dt PAM_SM_CHAUTHTOK 3
     10 .Os
     11 .Sh NAME
     12 .Nm pam_sm_chauthtok
     13 .Nd service module implementation for pam_chauthtok
     14 .Sh LIBRARY
     15 .Lb libpam
     16 .Sh SYNOPSIS
     17 .In sys/types.h
     18 .In security/pam_appl.h
     19 .In security/pam_modules.h
     20 .Ft "int"
     21 .Fn pam_sm_chauthtok "pam_handle_t *pamh" "int flags" "int argc" "const char **argv"
     22 .Sh DESCRIPTION
     23 The
     24 .Fn pam_sm_chauthtok
     25 function is the service module's implementation
     26 of the
     27 .Xr pam_chauthtok 3
     28 API function.
     29 .Pp
     30 When the application calls
     31 .Xr pam_chauthtok 3 ,
     32 the service function is
     33 called twice, first with the
     34 .Dv PAM_PRELIM_CHECK
     35 flag set and then again
     36 with the
     37 .Dv PAM_UPDATE_AUTHTOK
     38 flag set.
     39 .Sh RETURN VALUES
     40 The
     41 .Fn pam_sm_chauthtok
     42 function returns one of the following values:
     43 .Bl -tag -width 18n
     44 .It Bq Er PAM_ABORT
     45 General failure.
     46 .It Bq Er PAM_AUTHTOK_DISABLE_AGING
     47 Authentication token aging disabled.
     48 .It Bq Er PAM_AUTHTOK_ERR
     49 Authentication token failure.
     50 .It Bq Er PAM_AUTHTOK_LOCK_BUSY
     51 Authentication token lock busy.
     52 .It Bq Er PAM_AUTHTOK_RECOVERY_ERR
     53 Failed to recover old authentication token.
     54 .It Bq Er PAM_BUF_ERR
     55 Memory buffer error.
     56 .It Bq Er PAM_CONV_ERR
     57 Conversation failure.
     58 .It Bq Er PAM_IGNORE
     59 Ignore this module.
     60 .It Bq Er PAM_PERM_DENIED
     61 Permission denied.
     62 .It Bq Er PAM_SERVICE_ERR
     63 Error in service module.
     64 .It Bq Er PAM_SYSTEM_ERR
     65 System error.
     66 .It Bq Er PAM_TRY_AGAIN
     67 Try again.
     68 .El
     69 .Sh SEE ALSO
     70 .Xr pam 3 ,
     71 .Xr pam_chauthtok 3 ,
     72 .Xr pam_strerror 3
     73 .Sh STANDARDS
     74 .Rs
     75 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
     76 .%D "June 1997"
     77 .Re
     78 .Sh AUTHORS
     79 The
     80 .Fn pam_sm_chauthtok
     81 function and this manual page were
     82 developed for the
     83 .Fx
     84 Project by ThinkSec AS and Network Associates Laboratories, the
     85 Security Research Division of Network Associates, Inc.\& under
     86 DARPA/SPAWAR contract N66001-01-C-8035
     87 .Pq Dq CBOSS ,
     88 as part of the DARPA CHATS research program.
     89 .Pp
     90 The OpenPAM library is maintained by
     91 .An Dag-Erling Sm\(/orgrav Aq des (a] des.no .
     92