NAME    [Toc]    [Back]

       coredump - Creates a core snapshot of a running process

SYNOPSIS    [Toc]    [Back]

       coredump [directory] pid

OPERANDS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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.progname.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    [Toc]    [Back]

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

EXIT STATUS    [Toc]    [Back]

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

FILES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       dbx(1), ladebug(1), proc(4).

       Programmer's Guide



                                                      coredump(1)