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
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.
12 .\" Copyright 2015 Joyent, Inc.
19 .Nd set process privileges
26 .Fa "struct ps_prochandle *P"
32 function updates the privileges of the process handle
34 to the set described by
36 The updated privilege set has restrictions on what it may change for a
37 process which are documented in the
41 In addition, the definition of the
43 structure is described in
46 The current privilege set for the process may be obtained through a call
50 Note, the privilege set may only be updated for active processes.
51 Process handles which correspond to core files, zombie processes, and
52 files, may not have their privilege sets updated.
54 Upon successful completion, the
58 and updates the privilege sets of the process.
63 is set to indicate the error.
65 For a full list of possible errors see the
72 function will fail if:
76 doesn't refer to an active process, but a core file, zombie, or a file.
78 .Sh INTERFACE STABILITY