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