coreadm.2 (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

coreadm(2) coreadm(2)

NAME

coreadm - application core ﬁle administration

SYNOPSIS

#include <sys/core.h>

int coreadm(int c_version, pid_t c_pid, corefile_settings_t *c_in,

corefile_settings_t *c_out);

DESCRIPTION

coreadm() system call is used to specify the location and pattern for core ﬁles produced by abnormally

terminating processes. See core (4). This system call can be used to specify a system wide location for

core ﬁle placement and/or a process speciﬁc pattern.

The structure,

corefile_settings_t

is used to specify a system wide or a per-process core ﬁle pat-

tern and also specify the current system wide core ﬁle settings.

corefile_settings_t

is deﬁned in

the header

<sys/core.h>.

Member Type Member Name Description

The core ﬁle pattern.char c_pattern

Core ﬁle settings.uint64_t c_flags

Parameters

c_version is expected to be set to COREADM_VERSION

. It is critical for future backward compatibility

that the

COREADM_VERSION

macro itself be used and not its value.

c_pattern is the core ﬁle pattern. A core ﬁle name pattern is a normal ﬁle system path name with

embedded variables, speciﬁed with a leading % character, that are expanded from values in effect when a

core ﬁle is generated by the operating system. An expanded pattern length greater than MAXPATHLEN

will be truncated to MAXPATHLEN.

The possible values are:

%p process ID

%xp Process ID in hex

%u effective user-ID

%xu effective user-ID in Hex

%g effective group-ID

%xg effective group-ID in Hex

%c thread’s CPU number when the core ﬁle was created

%f executable ﬁle name, up to a maximum of MAXCOMMLEN characters

%n system node name (uname -n)

%t time-stamp (in UTC time format)

%T time-stamp (in UTC time format, without micro seconds)

%% literal %

c_ﬂags is used to control the system wide core ﬁle settings. The ﬂag values can be combination of

COREADM_GLBL_ENABLED Enable/Disable creation of global core ﬁles.

COREADM_PROC_ENABLED Enable/Disable creation of per-process core ﬁles.

COREADM_GLBL_SETID_ENABLED Enable/Disable creation of global core ﬁles for

setuid

processes.

COREADM_PROC_SETID_ENABLED Enable/Disable creation of per-process core ﬁle for

setuid

processes.

If a ﬂag value is not set, then the option is disabled.

For per-process core ﬁle setting, c_ﬂags can either be 0 or

COREADM_PROC_ENABLED. The former dis-

ables core ﬁle creation (for that process) and the latter enables it.

c_pid Should be a (valid) pid of a target process or 0. If c_pid is zero, then the settings are applied to

global core ﬁle settings. If c_pid is 1, then the settings are applied to init (1M).

c_in If non-NULL, then the values will be used as new core ﬁle settings. If this is NULL, then the

c_out parameter is expected to be non-NULL and system call is used to interrogate the current

settings.

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
coreadm(2) coreadm(2) NAME coreadm - application core file administration SYNOPSIS #include int coreadm(int c_version, pid_t corefile_settings_t *c_out); c_pid, corefile_settings_t *c_in, DESCRIPTION coreadm() system call is used to specify the location and pattern for core files produced by abnormally terminating processes. See core (4). This system call can be used to specify a system wide location for core file placement and/or a process specific pattern.
PAGE 2
coreadm(2) c_out coreadm(2) If non-NULL, the current settings are returned in this parameter. RETURN VALUE Upon successful completion, coreadm() returns 0. Otherwise, a value of -1 is returned and errno is set to indicate the error. ERRORS [EPERM] coreadm() fails and does not change the core file settings if the effective user-ID of the calling process is not a user having appropriate privileges. A cA [EFAULT] The input or output parameter passed to coreadm() is an invalid address.
PAGE 3
coreadm(2) coreadm(2) fprintf(stderr,"Usage %s \n", argv[0]); exit(2); } bzero(&c_in, sizeof(c_in)); bzero(&c_out,sizeof(c_out)); strcpy(c_in.c_pattern,"core.%p.%t"); c_in.c_flags = COREADM_PROC_ENABLED; /* Read the current settings. */ ret = coreadm(COREADM_VERSION, (pid_t)0, \ (corefile_settings_t *) NULL, &c_out); if (ret) { perror("coreadm"); exit(ret); } if ((c_out.c_flags & COREADM_PROC_ENABLED) == 0) { fprintf(stdout, "Warning: System wide Per-process core file dumping\ currently disabled.
PAGE 4
coreadm(2) coreadm(2) if (ret) { perror("coreadm"); exit(ret); } } SEE ALSO coreadm(1M), exec(2), fork(2), pstat(2), ttrace(2), core(4).