Compaq SC RMS Server User Manual


 
rms_setcorepath(3)
NAME
rms_setcorepath, rms_getcorepath – Set, get the path for application core files
SYNOPSIS
cc [ flag ... ] file ... -lrmscall [ library ... ]
#include <rms/rmscall.h>
int rms_setcorepath(caddr_t path);
int rms_getcorepath(pid_t pid, caddr_t path, int maxlen);
PARAMETERS
path Array containing the path name.
maxlen Size of the array pointed to by path.
pid Process identifier.
DESCRIPTION
The function rms_setcorepath() sets the core file path for the current process. The
core file path is set by rmsd as it starts a new parallel program and inherited by any
child processes. Administrator privileges are required to set a core path.
The function rms_getcorepath() returns the core file path of a process. If pid is
negative, it returns the core file path of the current process.
RETURN VALUES
Upon successful completion, rms_setcorepath() and rms_getcorepath() return 0.
Otherwise, they return -1 and set errno to indicate the error.
EACCESS Caller is not permitted to perform this operation.
ENOMEM Insufficient memory to perform this operation.
ESRCH Process does not exist.
EEXIST The core path has not been set.
RMS Kernel Module C-3