usr/src/man/man3proc/Pcontent.3proc

   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
  28 The
  29 .Fn Pcontent
  30 function describes information available from the process handle
  31 .Fa P .
  32 .Pp
  33 Different types of process handles have different kinds of content
  34 available to them.
  35 For example, handles to active and running processes have more information
  36 available than various core files, as the core file retains a subset of
  37 information available in the running process.
  38 Handles that refer to ELF objects, obtained through
  39 .Xr Pgrab_file 3PROC ,
  40 will not have information such as a stack available.
  41 The content of core files is controlled by
  42 .Xr coreadm 1M .
  43 .Pp
  44 The symbols that may be returned are listed in the
  45 .Sy core_content_t
  46 heading in the
  47 .Sy TYPES
  48 section in
  49 .Xr libproc 3LIB .
  50 .Sh RETURN VALUES
  51 Upon successful completion, the
  52 .Fn Pcontent
  53 function returns the bitwise-inclusive-OR of content types.
  54 Otherwise,
  55 .Dv CC_CONTENT_INVALID
  56 is returned to indicate an error.
  57 .Sh INTERFACE STABILITY
  58 .Sy Uncommitted
  59 .Sh MT-LEVEL
  60 See
  61 .Sy LOCKING
  62 in
  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