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 PPRIV 3PROC 16.Os 17.Sh NAME 18.Nm Ppriv , 19.Nm Ppriv_free 20.Nd get and free process privilege sets 21.Sh SYNOPSIS 22.Lb libproc 23.In libproc.h 24.Ft int 25.Fo Ppriv 26.Fa "struct ps_prochandle *P" 27.Fa "prpriv_t **pprv" 28.Fc 29.Ft void 30.Fo Ppriv_free 31.Fa "struct ps_prochandle *P" 32.Fa "prpriv_t *prv" 33.Fc 34.Sh DESCRIPTION 35The 36.Fn Ppriv 37function obtains the privilege set of the process handle 38.Fa P . 39The privilege set, if it exists, will be dynamically allocated and a 40pointer to it will be placed in 41.Fa pprv . 42It must be released with a call to 43.Fn Ppriv_free . 44The definition of the 45.Sy prpriv_t 46structure is documented in 47.Xr proc 4 . 48.Pp 49The 50.Fn Ppriv_free 51function releases the storage in 52.Fa prv 53that was allocated as a result of calling 54.Fn Ppriv . 55.Sh RETURN VALUES 56Upon successful completion, the 57.Fn Ppriv 58function returns 59.Sy 0 60and 61.Fa pprv 62is updated with a pointer to the allocated privilege set. Otherwise, 63.Sy -1 64is returned and 65.Fa pprv 66is not updated. 67.Sh INTERFACE STABILITY 68.Sy Uncommitted 69.Sh MT-LEVEL 70See 71.Sy LOCKING 72in 73.Xr libproc 3LIB . 74.Sh SEE ALSO 75.Xr libproc 3LIB , 76.Xr proc 4 , 77.Xr privileges 5 78