xref: /illumos-gate/usr/src/man/man3proc/Psecflags.3proc (revision d48be21240dfd051b689384ce2b23479d757f2d8)
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 5 .
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 5 ,
79.Xr security-flags 7
80