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 PSETPRIV 3PROC 16.Os 17.Sh NAME 18.Nm Psetpriv 19.Nd set process privileges 20.Sh LIBRARY 21.Lb libproc 22.Sh SYNOPSIS 23.In libproc.h 24.Ft int 25.Fo Psetpriv 26.Fa "struct ps_prochandle *P" 27.Fa "prpriv_t *pprv" 28.Fc 29.Sh DESCRIPTION 30The 31.Fn Psetpriv 32function updates the privileges of the process handle 33.Fa P 34to the set described by 35.Fa pprv . 36The updated privilege set has restrictions on what it may change for a 37process which are documented in the 38.Sy PCSPRIV 39section of 40.Xr proc 5 . 41In addition, the definition of the 42.Sy prpriv_t 43structure is described in 44.Xr proc 5 . 45.Pp 46The current privilege set for the process may be obtained through a call 47to 48.Xr Ppriv 3PROC . 49.Pp 50Note, the privilege set may only be updated for active processes. 51Process handles which correspond to core files, zombie processes, and 52files, may not have their privilege sets updated. 53.Sh RETURN VALUES 54Upon successful completion, the 55.Fn Psetpriv 56function returns 57.Sy 0 58and updates the privilege sets of the process. 59Otherwise, 60.Sy -1 61is returned and 62.Sy errno 63is set to indicate the error. 64.Sh ERRORS 65For a full list of possible errors see the 66.Sy DIAGNOSTICS 67section in 68.Xr proc 5 . 69.Pp 70The 71.Fn Psetpriv 72function will fail if: 73.Bl -tag -width Er 74.It Er EBADF 75.Fa P 76doesn't refer to an active process, but a core file, zombie, or a file. 77.El 78.Sh INTERFACE STABILITY 79.Sy Uncommitted 80.Sh MT-LEVEL 81See 82.Sy LOCKING 83in 84.Xr libproc 3LIB . 85.Sh SEE ALSO 86.Xr libproc 3LIB , 87.Xr Ppriv 3PROC , 88.Xr proc 5 , 89.Xr privileges 7 90