xref: /freebsd/contrib/openpam/doc/man/openpam_borrow_cred.3 (revision 45538173c120eadca115fd7e56c657905bf73771)
1ce77a8d6SDag-Erling Smørgrav.\" Generated from openpam_borrow_cred.c by gendoc.pl
2*45538173SDag-Erling Smørgrav.Dd May 31, 2025
393889be5SDag-Erling Smørgrav.Dt OPENPAM_BORROW_CRED 3
493889be5SDag-Erling Smørgrav.Os
593889be5SDag-Erling Smørgrav.Sh NAME
693889be5SDag-Erling Smørgrav.Nm openpam_borrow_cred
793889be5SDag-Erling Smørgrav.Nd temporarily borrow user credentials
893889be5SDag-Erling Smørgrav.Sh SYNOPSIS
9644f2b7cSDag-Erling Smørgrav.In sys/types.h
1093889be5SDag-Erling Smørgrav.In security/pam_appl.h
11ac7e3b9dSDag-Erling Smørgrav.In security/openpam.h
12ca236e63SDag-Erling Smørgrav.Ft "int"
1393889be5SDag-Erling Smørgrav.Fn openpam_borrow_cred "pam_handle_t *pamh" "const struct passwd *pwd"
1493889be5SDag-Erling Smørgrav.Sh DESCRIPTION
1593889be5SDag-Erling SmørgravThe
162f3ed619SDag-Erling Smørgrav.Fn openpam_borrow_cred
1793889be5SDag-Erling Smørgravfunction saves the current credentials and
1893889be5SDag-Erling Smørgravswitches to those of the user specified by its
19b33ab329SDag-Erling Smørgrav.Fa pwd
20b33ab329SDag-Erling Smørgravargument.
21b33ab329SDag-Erling SmørgravThe affected credentials are the effective UID, the effective GID, and
22b33ab329SDag-Erling Smørgravthe group access list.
23b33ab329SDag-Erling SmørgravThe original credentials can be restored using
2493889be5SDag-Erling Smørgrav.Xr openpam_restore_cred 3 .
2593889be5SDag-Erling Smørgrav.Pp
2693889be5SDag-Erling Smørgrav.Sh RETURN VALUES
2793889be5SDag-Erling SmørgravThe
282f3ed619SDag-Erling Smørgrav.Fn openpam_borrow_cred
2993889be5SDag-Erling Smørgravfunction returns one of the following values:
3093889be5SDag-Erling Smørgrav.Bl -tag -width 18n
3149e56509SDag-Erling Smørgrav.It Bq Er PAM_SUCCESS
3249e56509SDag-Erling SmørgravSuccess.
3393889be5SDag-Erling Smørgrav.It Bq Er PAM_BUF_ERR
3493889be5SDag-Erling SmørgravMemory buffer error.
3593889be5SDag-Erling Smørgrav.It Bq Er PAM_PERM_DENIED
3693889be5SDag-Erling SmørgravPermission denied.
3793889be5SDag-Erling Smørgrav.It Bq Er PAM_SYSTEM_ERR
3893889be5SDag-Erling SmørgravSystem error.
3993889be5SDag-Erling Smørgrav.El
4093889be5SDag-Erling Smørgrav.Sh SEE ALSO
41b33ab329SDag-Erling Smørgrav.Xr setegid 2 ,
42b33ab329SDag-Erling Smørgrav.Xr seteuid 2 ,
43b33ab329SDag-Erling Smørgrav.Xr setgroups 2 ,
4493889be5SDag-Erling Smørgrav.Xr openpam_restore_cred 3 ,
4593889be5SDag-Erling Smørgrav.Xr pam 3 ,
46b33ab329SDag-Erling Smørgrav.Xr pam_strerror 3
4793889be5SDag-Erling Smørgrav.Sh STANDARDS
4893889be5SDag-Erling SmørgravThe
492f3ed619SDag-Erling Smørgrav.Fn openpam_borrow_cred
5093889be5SDag-Erling Smørgravfunction is an OpenPAM extension.
5193889be5SDag-Erling Smørgrav.Sh AUTHORS
5293889be5SDag-Erling SmørgravThe
532f3ed619SDag-Erling Smørgrav.Fn openpam_borrow_cred
542f3ed619SDag-Erling Smørgravfunction and this manual page were
552f3ed619SDag-Erling Smørgravdeveloped for the
56ca236e63SDag-Erling Smørgrav.Fx
572f3ed619SDag-Erling SmørgravProject by ThinkSec AS and Network Associates Laboratories, the
589bc006deSDag-Erling SmørgravSecurity Research Division of Network Associates, Inc.\& under
59ca236e63SDag-Erling SmørgravDARPA/SPAWAR contract N66001-01-C-8035
6093889be5SDag-Erling Smørgrav.Pq Dq CBOSS ,
6193889be5SDag-Erling Smørgravas part of the DARPA CHATS research program.
62ce77a8d6SDag-Erling Smørgrav.Pp
63ce77a8d6SDag-Erling SmørgravThe OpenPAM library is maintained by
64*45538173SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav Aq Mt des@des.dev .
65