gcore.1 (f247324df75b7f55b48b92acb3b42a5ae2deac8a) gcore.1 (3898680cf705cef4e1cc606b44cd91fc4252bcd5)
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.

--- 28 unchanged lines hidden (view full) ---

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
44.Op Fl c Ar core
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.

--- 28 unchanged lines hidden (view full) ---

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
44.Op Fl c Ar core
45.Op Ar exec
45.Op Ar executable
46.Ar pid
47.Sh DESCRIPTION
46.Ar pid
47.Sh DESCRIPTION
48.Nm Gcore
49creates a core image of the specified process,
48The
49.Nm
50utility creates a core image of the specified process,
50suitable for use with
51.Xr gdb 1 .
52By default, the core is written to the file
53.Dq Pa core.<pid> .
54The process identifier,
55.Ar pid ,
56must be given on the command line.
57If no executable image is
58specified,
59.Nm
60will use
61.Dq Pa /proc/<pid>/file .
62.Pp
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
63The options are:
64The following options are available:
64.Bl -tag -width indent
65.It Fl c
66Write the core file to the specified file instead of
67.Dq Pa core.<pid> .
68.It Fl s
69Stop the process while gathering the core image, and resume it
70when done. This guarantees that the resulting core dump will
71be in a consistent state. The process is resumed even if it was
72already stopped.
73The same effect can be achieved manually with
74.Xr kill 1 .
75.El
76.Sh FILES
77.Bl -tag -width /var/log/messages -compact
78.It Pa core.<pid>
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
71when done. This guarantees that the resulting core dump will
72be in a consistent state. The process is resumed even if it was
73already stopped.
74The same effect can be achieved manually with
75.Xr kill 1 .
76.El
77.Sh FILES
78.Bl -tag -width /var/log/messages -compact
79.It Pa core.<pid>
79The core image.
80the core image
80.It Pa /proc/<pid>/file
81.It Pa /proc/<pid>/file
81The executable image.
82the executable image
82.El
83.Sh HISTORY
83.El
84.Sh HISTORY
84.Nm Gcore
85appeared in
85A
86.Nm
87utility appeared in
86.Bx 4.2 .
87.Sh BUGS
88Context switches or paging activity that occur while
89.Nm
90is running may cause the program to become confused.
91For best results, use
92.Fl s
93to temporarily stop the target process.
94.Pp
88.Bx 4.2 .
89.Sh BUGS
90Context switches or paging activity that occur while
91.Nm
92is running may cause the program to become confused.
93For best results, use
94.Fl s
95to temporarily stop the target process.
96.Pp
95.Nm Gcore
96is not compatible with the original
97The
98.Nm
99utility is not compatible with the original
97.Bx 4.2
98version.
100.Bx 4.2
101version.