$Id: pam_setcred.c 648 2013-03-05 17:54:27Z des $
.Dd September 12, 2014 .Dt PAM_SETCRED 3 .Os .Sh NAME .Nm pam_setcred .Nd modify / delete user credentials for an authentication service .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h .Ft "int" .Fn pam_setcred "pam_handle_t *pamh" "int flags" .Sh DESCRIPTION The .Fn pam_setcred function manages the application's credentials.
p The .Fa flags argument is the binary or of zero or more of the following values: l -tag -width 18n t Dv PAM_SILENT Do not emit any messages. t Dv PAM_ESTABLISH_CRED Establish the credentials of the target user. t Dv PAM_DELETE_CRED Revoke all established credentials. t Dv PAM_REINITIALIZE_CRED Fully reinitialise credentials. t Dv PAM_REFRESH_CRED Refresh credentials. .El
p The latter four are mutually exclusive.
p If any other bits are set, .Fn pam_setcred will return .Dv PAM_SYMBOL_ERR . .Sh RETURN VALUES The .Fn pam_setcred function returns one of the following values: l -tag -width 18n t Bq Er PAM_ABORT General failure. t Bq Er PAM_BUF_ERR Memory buffer error. t Bq Er PAM_CONV_ERR Conversation failure. t Bq Er PAM_CRED_ERR Failed to set user credentials. t Bq Er PAM_CRED_EXPIRED User credentials have expired. t Bq Er PAM_CRED_UNAVAIL Failed to retrieve user credentials. t Bq Er PAM_PERM_DENIED Permission denied. t Bq Er PAM_SERVICE_ERR Error in service module. t Bq Er PAM_SYMBOL_ERR Invalid symbol. t Bq Er PAM_SYSTEM_ERR System error. t Bq Er PAM_USER_UNKNOWN Unknown user. .El .Sh SEE ALSO .Xr pam 3 , .Xr pam_strerror 3 .Sh STANDARDS .Rs .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" .%D "June 1997" .Re .Sh AUTHORS The .Fn pam_setcred function and this manual page were developed for the .Fx Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
q Dq CBOSS , as part of the DARPA CHATS research program.
p The OpenPAM library is maintained by .An Dag-Erling Sm\(/orgrav Aq des@des.no .