gcore.1 (131507) | gcore.1 (199805) |
---|---|
1.\" Copyright (c) 1983, 1990, 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)gcore.1 8.2 (Berkeley) 4/18/94 | 1.\" Copyright (c) 1983, 1990, 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)gcore.1 8.2 (Berkeley) 4/18/94 |
33.\" $FreeBSD: head/usr.bin/gcore/gcore.1 131507 2004-07-03 00:24:45Z ru $ | 33.\" $FreeBSD: head/usr.bin/gcore/gcore.1 199805 2009-11-25 15:23:14Z attilio $ |
34.\" | 34.\" |
35.Dd April 18, 1994 | 35.Dd November 18, 2009 |
36.Dt GCORE 1 37.Os 38.Sh NAME 39.Nm gcore 40.Nd get core images of running process 41.Sh SYNOPSIS 42.Nm 43.Op Fl s --- 6 unchanged lines hidden (view full) --- 50utility creates a core image of the specified process, 51suitable for use with 52.Xr gdb 1 . 53By default, the core is written to the file 54.Dq Pa core.<pid> . 55The process identifier, 56.Ar pid , 57must be given on the command line. | 36.Dt GCORE 1 37.Os 38.Sh NAME 39.Nm gcore 40.Nd get core images of running process 41.Sh SYNOPSIS 42.Nm 43.Op Fl s --- 6 unchanged lines hidden (view full) --- 50utility creates a core image of the specified process, 51suitable for use with 52.Xr gdb 1 . 53By default, the core is written to the file 54.Dq Pa core.<pid> . 55The process identifier, 56.Ar pid , 57must be given on the command line. |
58If no executable image is 59specified, 60.Nm 61will use 62.Dq Pa /proc/<pid>/file . | |
63.Pp 64The following options are available: 65.Bl -tag -width indent 66.It Fl c 67Write the core file to the specified file instead of 68.Dq Pa core.<pid> . 69.It Fl s 70Stop the process while gathering the core image, and resume it --- 4 unchanged lines hidden (view full) --- 75already stopped. 76The same effect can be achieved manually with 77.Xr kill 1 . 78.El 79.Sh FILES 80.Bl -tag -width /var/log/messages -compact 81.It Pa core.<pid> 82the core image | 58.Pp 59The following options are available: 60.Bl -tag -width indent 61.It Fl c 62Write the core file to the specified file instead of 63.Dq Pa core.<pid> . 64.It Fl s 65Stop the process while gathering the core image, and resume it --- 4 unchanged lines hidden (view full) --- 70already stopped. 71The same effect can be achieved manually with 72.Xr kill 1 . 73.El 74.Sh FILES 75.Bl -tag -width /var/log/messages -compact 76.It Pa core.<pid> 77the core image |
83.It Pa /proc/<pid>/file 84the executable image | |
85.El 86.Sh HISTORY 87A 88.Nm 89utility appeared in 90.Bx 4.2 . 91.Sh BUGS | 78.El 79.Sh HISTORY 80A 81.Nm 82utility appeared in 83.Bx 4.2 . 84.Sh BUGS |
92Context switches or paging activity that occur while | 85Because of the 86.Xr ptrace 2 87usage |
93.Nm | 88.Nm |
94is running may cause the program to become confused. 95For best results, use 96.Fl s 97to temporarily stop the target process. | 89may not work with processes which are actively investigated with 90.Xr truss 1 91or 92.Xr gdb 1 . 93Additionally, interruptable sleeps may exit with EINTR. |
98.Pp 99The 100.Nm 101utility is not compatible with the original 102.Bx 4.2 103version. | 94.Pp 95The 96.Nm 97utility is not compatible with the original 98.Bx 4.2 99version. |