ChorusOS man pages section 2K: Kernel System Calls

pdump(2K)

NAME

pdump- dump core image of a process

SYNOPSIS

#include <pdump.h>

pid

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The pdump() function stops the process identified by its pid (see getpid(2K)), creates an image of the process context in a core file, and then restarts the process.

The core file contains information about each of the process's threads and all memory regions associated with the process. Only regions attached to the actor are dumped, supervisor regions not bound to the process are not dumped.

The tunable iom.maxcoresize defines a limit (maximum size) that must not be superseded when creating a core file. If iom.maxcoresize is set to 0, no core dump may be performed.

RETURN VALUES

The pdump() function returns 0 if the process was dumped successfully. Otherwise, pdump() returns -1 and sets errno to indicate the error.

ERRORS

The pdump() function will fail and no core file will be generated if:

EFBIG: iom.maxcoresize is set to 0, preventing core file generation.
EFBIG: The size of the generated core file exceeds iom.maxcoresize.
ENONEM: There is not enough memory to perform the request.
EPERM: The calling process is not a supervisor process, and the process ID of the calling process does not match the process ID of the dumped process.
ESRCH: The process asked for a dump using an invalid pid.
ENOTSUP: The CORE_DUMP feature is not implemented.

pdump() may also return error codes from I/O operations from open(2POSIX), close(2POSIX), write(2POSIX).

ENVIRONMENT VARIABLES

The COREDIR environment variable defines the directory in which all core files are generated. By default, core files are generated in /tmp.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving