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.

pidThe 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:

0Successful completion. 

>0An 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