]> git.saurik.com Git - apple/xnu.git/blame_incremental - bsd/man/man5/core.5
xnu-344.49.tar.gz
[apple/xnu.git] / bsd / man / man5 / core.5
... / ...
CommitLineData
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
24A small number of signals which cause abnormal termination of a process
25also cause a record of the process's in-core state to be written
26to disk for later examination by one of the available debuggers.
27(See
28.Xr sigaction 2 . )
29This memory image is written to a file named by default
30.Nm core.pid
31in the
32.Nm /cores
33directory;
34provided the terminated process had write permission in the directory,
35and the directory existed.
36.Pp
37The maximum size of a core file is limited by
38.Xr setrlimit 2 .
39Files which would be larger than the limit are not created.
40.Pp
41The core file consists of the
42.Pa Xr Mach-O 5
43header as described in the
44.Aq Pa sys/loader.h
45file.
46The remainder of the core
47file consists of various sections described in the
48.Xr Mach-O 5
49header.
50.Sh SEE ALSO
51.Xr gdb 1 ,
52.Xr setrlimit 2 ,
53.Xr sigaction 2 ,
54.Xr Mach-O 5,
55.Xr sysctl 8
56.Sh HISTORY
57A
58.Nm
59file format appeared in
60.At v6 .