xnu-1228.15.4.tar.gz

[apple/xnu.git] / bsd / man / man5 / core.5

diff --git a/bsd/man/man5/core.5 b/bsd/man/man5/core.5
index 097ce4f3480d16eb7284bdedd3237818dc71ef84..dae3c4c510a77cfbdcc51e34462698324c3db39c 100644 (file)
--- a/bsd/man/man5/core.5
+++ b/bsd/man/man5/core.5
@@ -27,10 +27,13 @@ to disk for later examination by one of the available debuggers.
 (See
 .Xr sigaction 2 . )
 This memory image is written to a file named by default
-.Nm core.pid
+.Pa core.pid ,
+where
+.Va pid
+is the process ID of the process,
 in the
-.Nm /cores
-directory;
+.Pa /cores
+directory,
 provided the terminated process had write permission in the directory,
 and the directory existed.
 .Pp
@@ -39,19 +42,27 @@ The maximum size of a core file is limited by
 Files which would be larger than the limit are not created.
 .Pp
 The core file consists of the
-.Pa Xr Mach-O 5
+.Xr Mach-O 5
 header as  described in the
-.Aq Pa sys/loader.h
+.Aq Pa mach-o/loader.h
 file.
 The remainder of the core
 file consists of various sections described in the
 .Xr Mach-O 5
 header.
+.Sh NOTE
+Core dumps are disabled by default under Darwin/Mac OS X.  To re-enable 
+core dumps, a privileged user must edit
+.Pa /etc/hostconfig
+to contain the line:
+.Bd -literal
+COREDUMPS=-YES-
+.Ed
 .Sh SEE ALSO
 .Xr gdb 1 ,
 .Xr setrlimit 2 ,
 .Xr sigaction 2 ,
-.Xr Mach-O 5,
+.Xr Mach-O 5 ,
 .Xr sysctl 8
 .Sh HISTORY
 A