xref: /illumos-gate/usr/src/man/man3proc/Pcontent.3proc (revision 32ece1f96d76b7ae0165091c2bc2a3cdce36971b)
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 2015 Joyent, Inc.
13.\"
14.Dd May 11, 2016
15.Dt PCONTENT 3PROC
16.Os
17.Sh NAME
18.Nm Pconent
19.Nd obtain process content types available
20.Sh SYNOPSIS
21.Lb libproc
22.In libproc.h
23.Ft "core_content_t"
24.Fo Pcontent
25.Fa "struct ps_prochandle *P"
26.Fc
27.Sh DESCRIPTION
28The
29.Fn Pcontent
30function describes information available from the process handle
31.Fa P .
32.Pp
33Different types of process handles have different kinds of content
34available to them.
35For example, handles to active and running processes have more information
36available than various core files, as the core file retains a subset of
37information available in the running process.
38Handles that refer to ELF objects, obtained through
39.Xr Pgrab_file 3PROC ,
40will not have information such as a stack available.
41The content of core files is controlled by
42.Xr coreadm 1M .
43.Pp
44The symbols that may be returned are listed in the
45.Sy core_content_t
46heading in the
47.Sy TYPES
48section in
49.Xr libproc 3LIB .
50.Sh RETURN VALUES
51Upon successful completion, the
52.Fn Pcontent
53function returns the bitwise-inclusive-OR of content types.
54Otherwise,
55.Dv CC_CONTENT_INVALID
56is returned to indicate an error.
57.Sh INTERFACE STABILITY
58.Sy Uncommitted
59.Sh MT-LEVEL
60See
61.Sy LOCKING
62in
63.Xr libproc 3LIB .
64.Sh SEE ALSO
65.Xr libproc 3LIB ,
66.Xr Pcreate 3PROC ,
67.Xr Pgrab 3PROC ,
68.Xr Pgrab_core 3PROC ,
69.Xr Pgrab_file 3PROC ,
70.Xr proc 4
71