xref: /illumos-gate/usr/src/man/man3proc/Psecflags.3proc (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1d2a70789SRichard Lowe.\"
2d2a70789SRichard Lowe.\" This file and its contents are supplied under the terms of the
3d2a70789SRichard Lowe.\" Common Development and Distribution License ("CDDL"), version 1.0.
4d2a70789SRichard Lowe.\" You may only use this file in accordance with the terms of version
5d2a70789SRichard Lowe.\" 1.0 of the CDDL.
6d2a70789SRichard Lowe.\"
7d2a70789SRichard Lowe.\" A full copy of the text of the CDDL should have accompanied this
8d2a70789SRichard Lowe.\" source.  A copy of the CDDL is also available via the Internet at
9d2a70789SRichard Lowe.\" http://www.illumos.org/license/CDDL.
10d2a70789SRichard Lowe.\"
11d2a70789SRichard Lowe.\"
12d2a70789SRichard Lowe.\" Copyright 2016, Richard Lowe.
13d2a70789SRichard Lowe.\"
14d2a70789SRichard Lowe.Dd June 06, 2016
15d2a70789SRichard Lowe.Dt PSECFLAGS 3PROC
16d2a70789SRichard Lowe.Os
17d2a70789SRichard Lowe.Sh NAME
18d2a70789SRichard Lowe.Nm Psecflags ,
19d2a70789SRichard Lowe.Nm Psecflags_free
20d2a70789SRichard Lowe.Nd get and free process security flags
21ab618543SJohn Levon.Sh LIBRARY
22d2a70789SRichard Lowe.Lb libproc
23ab618543SJohn Levon.Sh SYNOPSIS
24d2a70789SRichard Lowe.In libproc.h
25d2a70789SRichard Lowe.Ft int
26d2a70789SRichard Lowe.Fo Psecflags
27d2a70789SRichard Lowe.Fa "struct ps_prochandle *P"
28d2a70789SRichard Lowe.Fa "prsecflags_t **psf"
29d2a70789SRichard Lowe.Fc
30d2a70789SRichard Lowe.Ft void
31d2a70789SRichard Lowe.Fo Psecflags_free
32d2a70789SRichard Lowe.Fa "struct ps_prochandle *P"
33d2a70789SRichard Lowe.Fa "prsecflags_t *psf"
34d2a70789SRichard Lowe.Fc
35d2a70789SRichard Lowe.Sh DESCRIPTION
36d2a70789SRichard LoweThe
37d2a70789SRichard Lowe.Fn Psecflags
38d2a70789SRichard Lowefunction obtains the security flags of the process handle
39d2a70789SRichard Lowe.Fa P .
40d2a70789SRichard LoweThe security flags structure will be dynamically allocated and a pointer to it
41d2a70789SRichard Lowewill be placed in
42d2a70789SRichard Lowe.Fa psf .
43d2a70789SRichard LoweIt must be released with a call to
44d2a70789SRichard Lowe.Fn Psecflags_free .
45d2a70789SRichard LoweThe definition of the
46d2a70789SRichard Lowe.Sy prsecflags_t
47d2a70789SRichard Lowestructure is documented in
48*bbf21555SRichard Lowe.Xr proc 5 .
49d2a70789SRichard Lowe.Pp
50d2a70789SRichard LoweThe
51d2a70789SRichard Lowe.Fn Psecflags_free
52d2a70789SRichard Lowefunction releases the storage in
53d2a70789SRichard Lowe.Fa psf
54d2a70789SRichard Lowethat was allocated as a result of calling
55d2a70789SRichard Lowe.Fn Psecflags .
56d2a70789SRichard Lowe.Sh RETURN VALUES
57d2a70789SRichard LoweUpon successful completion, the
58d2a70789SRichard Lowe.Fn Psecflags
59d2a70789SRichard Lowefunction returns
60d2a70789SRichard Lowe.Sy 0
61d2a70789SRichard Loweand
62d2a70789SRichard Lowe.Fa psf
6372d3dbb9SYuri Pankovis updated with a pointer to the allocated security flags.
6472d3dbb9SYuri PankovOtherwise,
65d2a70789SRichard Lowe.Sy -1
66d2a70789SRichard Loweis returned and
67d2a70789SRichard Lowe.Fa psf
68d2a70789SRichard Loweis not updated.
69d2a70789SRichard Lowe.Sh INTERFACE STABILITY
70d2a70789SRichard Lowe.Sy Uncommitted
71d2a70789SRichard Lowe.Sh MT-LEVEL
72d2a70789SRichard LoweSee
73d2a70789SRichard Lowe.Sy LOCKING
74d2a70789SRichard Lowein
75d2a70789SRichard Lowe.Xr libproc 3LIB .
76d2a70789SRichard Lowe.Sh SEE ALSO
77d2a70789SRichard Lowe.Xr libproc 3LIB ,
78*bbf21555SRichard Lowe.Xr proc 5 ,
79*bbf21555SRichard Lowe.Xr security-flags 7
80