PGCORE(3PROC) Process Control Library Functions PGCORE(3PROC)
Pfgcore, Pgcore - produce a core file of a process
Process Control Library (libproc, -lproc)
#include <libproc.h>
int
Pfgcore(struct ps_prochandle *P, int fd, core_content_t content);
int
Pgcore(struct ps_prochandle *P, const char *fname,
core_content_t content);
The Pgcore() and Pfgcore() functions produce core files of the handle
referred to by P. Core files represent a snapshot of a process and may
be manipulated by a wide variety of tools and libraries including
libproc(3LIB), mdb(1), pargs(1), pstack(1), and more. For details on
the core file format, see core(5).
Pfgcore() writes the core to the file represented by the open
descriptor fd. The file descriptor should be open for both read and
write. Pgcore() writes the core to the file path fname.
The content of the core is controlled by the content argument. It's
the inclusive-bitwise-OR of the various content types listed under the
core_content_t heading in the TYPES section in libproc(3LIB). Using
CC_CONTENT_INVALID is illegal and will result in an error.
Neither the Pgcore() or Pfgcore() functions stop the handle P. It is
up to the caller to stop the process; which is recommended for
obtaining a consistent view of the process. See the Pstop(3PROC)
function for a means to stop a handle.
Upon successful completion, the Pfcore() and Pgcore() functions return
0 and write out a core file to specified location. Otherwise, -1 is
returned. The Pfgcore() function will truncate fd and the Pgcore()
function will remove fname.
Uncommitted
MT-LEVEL
See LOCKING in libproc(3LIB).
libproc(3LIB), Pstop(3PROC), core(5), proc(5), coreadm(8)
illumos November 27, 2023 illumos
NAME
Pfgcore, Pgcore - produce a core file of a process
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h>
int
Pfgcore(struct ps_prochandle *P, int fd, core_content_t content);
int
Pgcore(struct ps_prochandle *P, const char *fname,
core_content_t content);
DESCRIPTION
The Pgcore() and Pfgcore() functions produce core files of the handle
referred to by P. Core files represent a snapshot of a process and may
be manipulated by a wide variety of tools and libraries including
libproc(3LIB), mdb(1), pargs(1), pstack(1), and more. For details on
the core file format, see core(5).
Pfgcore() writes the core to the file represented by the open
descriptor fd. The file descriptor should be open for both read and
write. Pgcore() writes the core to the file path fname.
The content of the core is controlled by the content argument. It's
the inclusive-bitwise-OR of the various content types listed under the
core_content_t heading in the TYPES section in libproc(3LIB). Using
CC_CONTENT_INVALID is illegal and will result in an error.
Neither the Pgcore() or Pfgcore() functions stop the handle P. It is
up to the caller to stop the process; which is recommended for
obtaining a consistent view of the process. See the Pstop(3PROC)
function for a means to stop a handle.
RETURN VALUES
Upon successful completion, the Pfcore() and Pgcore() functions return
0 and write out a core file to specified location. Otherwise, -1 is
returned. The Pfgcore() function will truncate fd and the Pgcore()
function will remove fname.
INTERFACE STABILITY
Uncommitted
MT-LEVEL
See LOCKING in libproc(3LIB).
SEE ALSO
libproc(3LIB), Pstop(3PROC), core(5), proc(5), coreadm(8)
illumos November 27, 2023 illumos