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. The definition of the 37.Sy prcred_t 38structure may be found in 39.Xr proc 4 . 40.Pp 41Note, the credentials may only be updated for an active process. If the 42process handle refers to a zombie process, core file, or a file, then 43.Fn Psetcred 44will fail. 45.Sh RETURN VALUES 46Upon successful completion, the 47.Fn Psetcred 48function returns 49.Sy 0 50and updates the credentials of the process 51.Fa P . 52Otherwise, 53.Sy -1 54is returned. 55.Sh INTERFACE STABILITY 56.Sy Uncommitted 57.Sh MT-LEVEL 58See 59.Sy LOCKING 60in 61.Xr libproc 3LIB . 62.Sh SEE ALSO 63.Xr libproc 3LIB , 64.Xr Pcred 3PROC , 65.Xr proc 4 66