Bug 21712

Summary: core(5) manpage fails to mention kern.sugid_coredump
Product: Documentation Reporter: pjp <pjp>
Component: Books & ArticlesAssignee: dan <dan>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description pjp 2000-10-02 23:50:01 UTC 
	It takes too long for someone not familiar with coredump operations
	to figure out how to make a process dump core when that file
	is setugid or a process changes credentials with setuid(), seteuid(),
	setgid() ...  A mention in the manpage would be helpful, patch below.

Fix: unified patch below for /usr/src/share/man/man5/core.5
Comment 1 dan freebsd_committer freebsd_triage 2000-10-15 00:11:32 UTC 
Responsible Changed
From-To: freebsd-doc->dan

I'll quickly fix this. (Hi Peter!)
Comment 2 pjp 2001-04-01 09:47:05 UTC 
I had asked Dan to hold on with this PR as I didn't like the wording.  I still
don't fully like it but this is the best I have so far.

--- core.5.orig Sun Apr  1 04:16:46 2001
+++ core.5      Sun Apr  1 04:42:54 2001
@@ -78,6 +78,14 @@
 .Fx
 behaviour.
 .Pp
+By default, a process that changes user or group credentials whether
+real or effective won't create a corefile.  This behaviour can be 
+changed to generate a core dump when setting the
+.Xr sysctl 8
+variable
+.Va kern.sugid_coredump
+to 1.
+.Pp
 The core file consists of the
 .Fa u .
 area, whose size (in pages) is

-- 
-                                                                              -
Peter Philipp <pjp@daemonium.com>
Daemonium
Comment 3 nik freebsd_committer freebsd_triage 2002-01-09 13:16:31 UTC 
State Changed
From-To: open->closed

Revised text committed.