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