xfree86 man page for pam_sm_setcred

Query: pam_sm_setcred

OS: xfree86

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

PAM_SM_SETCRED(3)						 Linux-PAM Manual						 PAM_SM_SETCRED(3)

NAME
pam_sm_setcred - PAM service function to alter credentials
SYNOPSIS
#define PAM_SM_AUTH #include <security/pam_modules.h> PAM_EXTERN int pam_sm_setcred(pam_handle_t *pamh, int flags, int argc, const char **argv);
DESCRIPTION
The pam_sm_setcred function is the service module's implementation of the pam_setcred(3) interface. This function performs the task of altering the credentials of the user with respect to the corresponding authorization scheme. Generally, an authentication module may have access to more information about a user than their authentication token. This function is used to make such information available to the application. It should only be called after the user has been authenticated but before a session has been established. Valid flags, which may be logically OR'd with PAM_SILENT, are: PAM_SILENT Do not emit any messages. PAM_ESTABLISH_CRED Initialize the credentials for the user. PAM_DELETE_CRED Delete the credentials associated with the authentication service. PAM_REINITIALIZE_CRED Reinitialize the user credentials. PAM_REFRESH_CRED Extend the lifetime of the user credentials. The way the auth stack is navigated in order to evaluate the pam_setcred() function call, independent of the pam_sm_setcred() return codes, is exactly the same way that it was navigated when evaluating the pam_authenticate() library call. Typically, if a stack entry was ignored in evaluating pam_authenticate(), it will be ignored when libpam evaluates the pam_setcred() function call. Otherwise, the return codes from each module specific pam_sm_setcred() call are treated as required.
RETURN VALUES
PAM_CRED_UNAVAIL This module cannot retrieve the user's credentials. PAM_CRED_EXPIRED The user's credentials have expired. PAM_CRED_ERR This module was unable to set the credentials of the user. PAM_SUCCESS The user credential was successfully set. PAM_USER_UNKNOWN The user is not known to this authentication module. These, non-PAM_SUCCESS, return values will typically lead to the credential stack failing. The first such error will dominate in the return value of pam_setcred().
SEE ALSO
pam(3), pam_authenticate(3), pam_setcred(3), pam_sm_authenticate(3), pam_strerror(3), PAM(8) Linux-PAM Manual 06/04/2011 PAM_SM_SETCRED(3)
Related Man Pages
pam_sm_setcred(3) - suse
pam_sm_setcred(3) - x11r4
pam_sm_setcred(3) - linux
pam_sm_setcred(3) - posix
pam_sm_setcred(3) - bsd
Similar Topics in the Unix Linux Community
No xorg.conf or XF86Config
PHP Write Man Pages to MySQL DB
Fedora 30 and Slackware 14.2, how to obtain the same rendering?
Shopt -s histappend