Return to gcore.1 CVS log

Up to [local] / src / usr.bin / gcore

Annotation of src/usr.bin/gcore/gcore.1, Revision 1.1.1.1

1.1       deraadt     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.
                      9: .\" 2. Redistributions in binary form must reproduce the above copyright
                     10: .\"    notice, this list of conditions and the following disclaimer in the
                     11: .\"    documentation and/or other materials provided with the distribution.
                     12: .\" 3. All advertising materials mentioning features or use of this software
                     13: .\"    must display the following acknowledgement:
                     14: .\"    This product includes software developed by the University of
                     15: .\"    California, Berkeley and its contributors.
                     16: .\" 4. Neither the name of the University nor the names of its contributors
                     17: .\"    may be used to endorse or promote products derived from this software
                     18: .\"    without specific prior written permission.
                     19: .\"
                     20: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     21: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     22: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     23: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     24: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     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: .\"     $NetBSD: gcore.1,v 1.2 1995/09/05 02:50:58 tls Exp $
                     34: .\"
                     35: .Dd "April 18, 1994"
                     36: .Dt GCORE 1
                     37: .Os BSD 4.2
                     38: .Sh NAME
                     39: .Nm gcore
                     40: .Nd get core images of running process
                     41: .Sh SYNOPSIS
                     42: .Nm gcore
                     43: .Op Fl s
                     44: .Op Fl c Ar core
                     45: .Ar exec pid
                     46: .Sh DESCRIPTION
                     47: .Nm Gcore
                     48: creates a core image of the specified process,
                     49: suitable for use with
                     50: .Xr gdb  1 .
                     51: By default, the core is written to the file
                     52: .Dq Pa core.<pid> .
                     53: Both the executable image,
                     54: .Ar exec ,
                     55: and the process identifier,
                     56: .Ar pid ,
                     57: must be given on the command line.
                     58: .Pp
                     59: The options are:
                     60: .Bl -tag -width indent
                     61: .It Fl c
                     62: Write the core file to the specified file instead of
                     63: .Dq Pa core.<pid> .
                     64: .It Fl s
                     65: Stop the process while gathering the core image, and resume it
                     66: when done.  This guarantees that the resulting core dump will
                     67: be in a consistent state.  The process is resumed even if it was
                     68: already stopped.
                     69: The same effect can be achieved manually with
                     70: .Xr kill 1 .
                     71: .El
                     72: .Sh FILES
                     73: .Bl -tag -width /var/log/messages -compact
                     74: .It Pa core.<pid>
                     75: The core image.
                     76: .EL
                     77: .Dp
                     78: .Sh HISTORY
                     79: .Nm Gcore
                     80: appeared in 4.2BSD.
                     81: .Sh BUGS
                     82: Context switches or paging activity that occur while
                     83: .Nm gcore
                     84: is running may cause the program to become confused.
                     85: For best results, use -s to temporarily stop the target process.
                     86: .Pp
                     87: .Nm Gcore
                     88: is not compatible with the original 4.2BSD version.
                     89: In particular, 4.4BSD requires the
                     90: .Ar exec
                     91: argument.