The pam_setcred function is used to establish, maintain and delete
the credentials of a user. It should be called to set the credentials
after a user has been authenticated and before a session is opened
for the user (with pam_open_session(3)). The credentials should be
deleted after the session has been closed (with
A credential is something that the user possesses. It is some
property, such as a Kerberos ticket, or a supplementary group
membership that make up the uniqueness of a given user. On a Linux
system the user's UID and GID's are credentials too. However, it has
been decided that these properties (along with the default
supplementary groups of which the user is a member) are credentials
that should be set directly by the application and not by PAM. Such
credentials should be established, by the application, prior to a
call to this function. For example, initgroups(2) (or equivalent)
should have been performed.
Valid flags, any one of which, may be logically OR'd with PAM_SILENT,
Initialize the credentials for the user.
Delete the user's credentials.
Fully reinitialize the user's credentials.
Extend the lifetime of the existing credentials.
Memory buffer error.
Failed to set user credentials.
User credentials are expired.
Failed to retrieve user credentials.
Data was successful stored.
A NULL pointer was submitted as PAM handle, the function was
called by a module or another system error occured.
User is not known to an authentication module.
This page is part of the linux-pam (Pluggable Authentication Modules
for Linux) project. Information about the project can be found at
⟨https://fedorahosted.org/linux-pam/⟩. If you have a bug report for
this manual page, see ⟨https://fedorahosted.org/linux-pam/report⟩.
This page was obtained from the tarball Linux-PAM-1.3.0.tar.gz
fetched from ⟨http://www.linux-pam.org/library/⟩ on 2017-03-13. If
you discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for the
page, or you have corrections or improvements to the information in
this COLOPHON (which is not part of the original manual page), send a
mail to email@example.com
Linux-PAM Manual 04/01/2016 PAM_SETCRED(3)