Index Index for
Section 1
Index Alphabetical
listing for C
Bottom of page Bottom of
page

coredump(1)

NAME

coredump - Creates a core snapshot of a running process

SYNOPSIS

coredump [directory] pid

OPERANDS

directory A directory in which to put the core snapshot. The default is the current directory. pid The process id of the running process.

DESCRIPTION

The coredump command creates a core snapshot of a running process. To use the coredump command, you: · Must have root privileges or own the process specified (pid). · Must have procfs enabled. By default, the snapshot is placed in a file named core, in the current directory. You can specify a different directory with the directory operand. If core-file-naming is enabled at the system or application level (see the Programmer's Guide), the core file will be named automatically according to the following convention: core.prog-name.host-name.tag where tag is a uniquely assigned number. To examine the core snapshot, use the dbx(1) debugger or the ladebug(1) debugger (if installed) as you would when examining the core dump resulting from a program crash.

ERRORS

If any of the following conditions occurs, errno is set to the corresponding value: [ESRCH] No such process. There is no running process with that process id. [EPERM] Permission denied. You do not own the process or do not have the necessary privileges.

EXIT STATUS

The following exit values are returned: 0 Successful completion. >0 An error occurred.

FILES

core Default name of a core snapshot file. /usr/sbin/coredump Location of the coredump program.

SEE ALSO

dbx(1), ladebug(1), proc(4). Programmer's Guide

Index Index for
Section 1
Index Alphabetical
listing for C
Top of page Top of
page