|author||Steve Langasek <firstname.lastname@example.org>||2019-01-03 16:26:05 -0800|
|committer||Steve Langasek <email@example.com>||2019-01-03 17:26:38 -0800|
New upstream version 1.0.1
Diffstat (limited to 'doc/man/pam_setcred.3')
1 files changed, 104 insertions, 0 deletions
diff --git a/doc/man/pam_setcred.3 b/doc/man/pam_setcred.3
new file mode 100644
@@ -0,0 +1,104 @@
+.\" Title: pam_setcred
+.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
+.\" Date: 04/16/2008
+.\" Manual: Linux-PAM Manual
+.\" Source: Linux-PAM Manual
+.TH "PAM_SETCRED" "3" "04/16/2008" "Linux-PAM Manual" "Linux-PAM Manual"
+.\" disable hyphenation
+.\" disable justification (adjust text to left margin only)
+pam_setcred - establish / delete user credentials
+.BI "int pam_setcred(pam_handle_t\ *" "pamh" ", int\ " "flags" ");"
+function is used to establish, maintain and delete the credentials of a user\. It should be called after a user has been authenticated and before a session is opened for the user (with
+A credential is something that the user possesses\. It is some property, such as a
+ticket, or a supplementary group membership that make up the uniqueness of a given user\. On a Linux system the user\'s
+\fIGID\fR\'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,
+(or equivalent) should have been performed\.
+\fIflags\fR, any one of which, may be logically OR\'d with
+Initialize the credentials for the user\.
+Delete the user\'s credentials\.
+Fully reinitialize the user\'s credentials\.
+Extend the lifetime of the existing credentials\.
+.SH "RETURN VALUES"
+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\.
+.SH "SEE ALSO"