$Id: openpam_borrow_cred.c 649 2013-03-05 17:58:33Z des $
.Dd September 12, 2014 .Dt OPENPAM_BORROW_CRED 3 .Os .Sh NAME .Nm openpam_borrow_cred .Nd temporarily borrow user credentials .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h n security/openpam.h .Ft "int" .Fn openpam_borrow_cred "pam_handle_t *pamh" "const struct passwd *pwd" .Sh DESCRIPTION The .Fn openpam_borrow_cred function saves the current credentials and switches to those of the user specified by its .Fa pwd argument. The affected credentials are the effective UID, the effective GID, and the group access list. The original credentials can be restored using .Xr openpam_restore_cred 3 .
p .Sh RETURN VALUES The .Fn openpam_borrow_cred function returns one of the following values: l -tag -width 18n t Bq Er PAM_BUF_ERR Memory buffer error. t Bq Er PAM_PERM_DENIED Permission denied. t Bq Er PAM_SYSTEM_ERR System error. .El .Sh SEE ALSO .Xr setegid 2 , .Xr seteuid 2 , .Xr setgroups 2 , .Xr openpam_restore_cred 3 , .Xr pam 3 , .Xr pam_strerror 3 .Sh STANDARDS The .Fn openpam_borrow_cred function is an OpenPAM extension. .Sh AUTHORS The .Fn openpam_borrow_cred 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 .