Home | History | Annotate | Line # | Download | only in man
pam_chauthtok.3 revision 1.5 
      1 <<<<<<< pam_chauthtok.3
      2 .\"	$NetBSD: pam_chauthtok.3,v 1.5 2014/10/24 18:17:56 christos Exp $
      3 .\"
      4 =======
      5 >>>>>>> 1.1.1.4
      6 .\" Generated from pam_chauthtok.c by gendoc.pl
      7 .\" Id: pam_chauthtok.c 648 2013-03-05 17:54:27Z des 
      8 .Dd September 12, 2014
      9 .Dt PAM_CHAUTHTOK 3
     10 .Os
     11 .Sh NAME
     12 .Nm pam_chauthtok
     13 .Nd perform password related functions within the PAM framework
     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_chauthtok "pam_handle_t *pamh" "int flags"
     21 .Sh DESCRIPTION
     22 The
     23 .Fn pam_chauthtok
     24 function attempts to change the authentication token
     25 for the user associated with the pam context specified by the
     26 .Fa pamh
     27 argument.
     28 .Pp
     29 The
     30 .Fa flags
     31 argument is the binary or of zero or more of the following
     32 values:
     33 .Bl -tag -width 18n
     34 .It Dv PAM_SILENT
     35 Do not emit any messages.
     36 .It Dv PAM_CHANGE_EXPIRED_AUTHTOK
     37 Change only those authentication tokens that have expired.
     38 .El
     39 .Pp
     40 If any other bits are set,
     41 .Fn pam_chauthtok
     42 will return
     43 .Dv PAM_SYMBOL_ERR .
     44 .Sh RETURN VALUES
     45 The
     46 .Fn pam_chauthtok
     47 function returns one of the following values:
     48 .Bl -tag -width 18n
     49 .It Bq Er PAM_ABORT
     50 General failure.
     51 .It Bq Er PAM_AUTHTOK_DISABLE_AGING
     52 Authentication token aging disabled.
     53 .It Bq Er PAM_AUTHTOK_ERR
     54 Authentication token failure.
     55 .It Bq Er PAM_AUTHTOK_LOCK_BUSY
     56 Authentication token lock busy.
     57 .It Bq Er PAM_AUTHTOK_RECOVERY_ERR
     58 Failed to recover old authentication token.
     59 .It Bq Er PAM_BUF_ERR
     60 Memory buffer error.
     61 .It Bq Er PAM_CONV_ERR
     62 Conversation failure.
     63 .It Bq Er PAM_PERM_DENIED
     64 Permission denied.
     65 .It Bq Er PAM_SERVICE_ERR
     66 Error in service module.
     67 .It Bq Er PAM_SYMBOL_ERR
     68 Invalid symbol.
     69 .It Bq Er PAM_SYSTEM_ERR
     70 System error.
     71 .It Bq Er PAM_TRY_AGAIN
     72 Try again.
     73 .El
     74 .Sh SEE ALSO
     75 .Xr pam 3 ,
     76 .Xr pam_strerror 3
     77 .Sh STANDARDS
     78 .Rs
     79 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
     80 .%D "June 1997"
     81 .Re
     82 .Sh AUTHORS
     83 The
     84 .Fn pam_chauthtok
     85 function and this manual page were
     86 developed for the
     87 .Fx
     88 Project by ThinkSec AS and Network Associates Laboratories, the
     89 Security Research Division of Network Associates, Inc.\& under
     90 DARPA/SPAWAR contract N66001-01-C-8035
     91 .Pq Dq CBOSS ,
     92 as part of the DARPA CHATS research program.
     93 .Pp
     94 The OpenPAM library is maintained by
     95 .An Dag-Erling Sm\(/orgrav Aq des (a] des.no .
     96