1.\" 2.\" This file and its contents are supplied under the terms of the 3.\" Common Development and Distribution License ("CDDL"), version 1.0. 4.\" You may only use this file in accordance with the terms of version 5.\" 1.0 of the CDDL. 6.\" 7.\" A full copy of the text of the CDDL should have accompanied this 8.\" source. A copy of the CDDL is also available via the Internet at 9.\" http://www.illumos.org/license/CDDL. 10.\" 11.\" 12.\" Copyright 2015 Joyent, Inc. 13.\" 14.Dd May 11, 2016 15.Dt PSETCRED 3PROC 16.Os 17.Sh NAME 18.Nm Psetcred 19.Nd set process credentials 20.Sh SYNOPSIS 21.Lb libproc 22.In libproc.h 23.Ft int 24.Fo Psetcred 25.Fa "struct ps_prochandle *P" 26.Fa "const prcred_t *credp" 27.Fc 28.Sh DESCRIPTION 29The 30.Fn Psetcred 31function updates the credentials of the process handle 32.Fa P 33to the values set in 34.Fa credp . 35.Fa credp 36must be fully initialized. 37The definition of the 38.Sy prcred_t 39structure may be found in 40.Xr proc 4 . 41.Pp 42Note, the credentials may only be updated for an active process. 43If the process handle refers to a zombie process, core file, or a file, then 44.Fn Psetcred 45will fail. 46.Sh RETURN VALUES 47Upon successful completion, the 48.Fn Psetcred 49function returns 50.Sy 0 51and updates the credentials of the process 52.Fa P . 53Otherwise, 54.Sy -1 55is returned. 56.Sh INTERFACE STABILITY 57.Sy Uncommitted 58.Sh MT-LEVEL 59See 60.Sy LOCKING 61in 62.Xr libproc 3LIB . 63.Sh SEE ALSO 64.Xr libproc 3LIB , 65.Xr Pcred 3PROC , 66.Xr proc 4 67