bsd/man/man5/core.5

   1 .\""Copyright (c) 2001 Apple Computer, Inc. All Rights Reserved.
   2 .\"The contents of this file constitute Original Code as defined in and are
   3 .\"subject to the Apple Public Source License Version 1.2 (the 'License').
   4 .\"You may not use this file except in compliance with the
   5 .\"License. Please obtain a copy of the License at
   6 .\"http://www.apple.com/publicsource and read it before using this file.
   7 .\"
   8 .\"This Original Code and all software distributed under the License are
   9 .\"distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  10 .\"EXPRESS OR IMPLIED, AND APPLE
  11 .\"HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY
  12 .\"WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
  13 .\"QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  14 .\"specific language governing rights and limitations under the License."
  15 .Dd March 18, 2002
  16 .Dt CORE 5
  17 .Os
  18 .Sh NAME
  19 .Nm core
  20 .Nd memory image file format
  21 .Sh SYNOPSIS
  22 .In sys/param.h
  23 .Sh DESCRIPTION
  24 A small number of signals which cause abnormal termination of a process
  25 also cause a record of the process's in-core state to be written
  26 to disk for later examination by one of the available debuggers.
  27 (See
  28 .Xr sigaction 2 . )
  29 This memory image is written to a file named by default
  30 .Pa core.pid ,
  31 where
  32 .Va pid
  33 is the process ID of the process,
  34 in the
  35 .Pa /cores
  36 directory,
  37 provided the terminated process had write permission in the directory,
  38 and the directory existed.
  39 .Pp
  40 The maximum size of a core file is limited by
  41 .Xr setrlimit 2 .
  42 Files which would be larger than the limit are not created.
  43 .Pp
  44 The core file consists of the
  45 .Xr Mach-O 5
  46 header as  described in the
  47 .Aq Pa mach-o/loader.h
  48 file.
  49 The remainder of the core
  50 file consists of various sections described in the
  51 .Xr Mach-O 5
  52 header.
  53 .Sh NOTE
  54 Core dumps are disabled by default under Darwin/Mac OS X.  To re-enable
  55 core dumps, a privileged user must edit
  56 .Pa /etc/hostconfig
  57 to contain the line:
  58 .Bd -literal
  59 COREDUMPS=-YES-
  60 .Ed
  61 .Sh SEE ALSO
  62 .Xr gdb 1 ,
  63 .Xr setrlimit 2 ,
  64 .Xr sigaction 2 ,
  65 .Xr Mach-O 5 ,
  66 .Xr sysctl 8
  67 .Sh HISTORY
  68 A
  69 .Nm
  70 file format appeared in
  71 .At v6 .