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 LIBRARY 21.Lb libproc 22.Sh SYNOPSIS 23.In libproc.h 24.Ft int 25.Fo Psetcred 26.Fa "struct ps_prochandle *P" 27.Fa "const prcred_t *credp" 28.Fc 29.Sh DESCRIPTION 30The 31.Fn Psetcred 32function updates the credentials of the process handle 33.Fa P 34to the values set in 35.Fa credp . 36.Fa credp 37must be fully initialized. 38The definition of the 39.Sy prcred_t 40structure may be found in 41.Xr proc 5 . 42.Pp 43Note, the credentials may only be updated for an active process. 44If the process handle refers to a zombie process, core file, or a file, then 45.Fn Psetcred 46will fail. 47.Sh RETURN VALUES 48Upon successful completion, the 49.Fn Psetcred 50function returns 51.Sy 0 52and updates the credentials of the process 53.Fa P . 54Otherwise, 55.Sy -1 56is returned. 57.Sh INTERFACE STABILITY 58.Sy Uncommitted 59.Sh MT-LEVEL 60See 61.Sy LOCKING 62in 63.Xr libproc 3LIB . 64.Sh SEE ALSO 65.Xr libproc 3LIB , 66.Xr Pcred 3PROC , 67.Xr proc 5 68