Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > G

gcore(1)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

gcore — get core images of running processes

SYNOPSIS

gcore [-o filename] process-id...

DESCRIPTION

The gcore command creates a core image of each specified process. By default, the name of the core image file for process-id will be core.process-id. The process information in the core file can be obtained by using debuggers.

When the gcore command creates a core image of each specified process, the process is temporarily stopped. Further, when the creation of core image is complete, the process continues to execute.

Options

-o filename

Creates the core file with name of the file as filename.process-id. If multiple process-id values are specified, filename will be common for all the core image files. See the EXAMPLES section.

Operands

process-id

The process ID for which a core image file will be created.

RETURN VALUE

Upon completion, gcore exits with one of the following values:

0

A core file was successfully created.

>0

An error condition was encountered. In such a case, the creation of a core file is not guaranteed. The error conditions could be because of

  • A nonexistent or incorrect process ID was specified.

  • An invalid option was specified.

  • The current working directory of the process or directory from which gcore was invoked had no write permissions.

  • The current working directory of the process was not accessible.

  • The file system is full.

EXAMPLES

Example 1

Dump the core image of process 1030 in the file "core.1030".

gcore 1030

Example 2

Dump the core image of the process 1030 in the file "test.1030".

gcore -o test 1030

Example 3

Dump the core image of the processes 1030, 1031, 1032, and 1033 in the files "core.1030", "core.1031", "core.1032", "core.1033".

gcore 1030 1031 1032 1033

Example 4

Dump the core image of the processes 1030, 1031, 1032, and 1033 in the files test.1030, test.1031, test.1032, test.1033.

gcore -o test 1030 1031 1032 1033

FILES

core.process-id

Core image file for process-id. (Both where gcore is invoked and the current working directory of the process.)

AUTHOR

gcore was developed by Chris Bertin (HP).

SEE ALSO

adb(1), gdb(1), kill(1), ttrace(2), a.out(4), core(4).

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.