unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



coredump(1)							  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 correspond-
  ing 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