2 * Copyright (c) 2000-2004 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1991 NeXT Computer, Inc. All rights reserved.
30 * File: bsd/kern/kern_core.c
32 * This file contains machine independent code for performing core dumps.
36 #include <mach/vm_param.h>
37 #include <mach/thread_status.h>
39 #include <sys/param.h>
40 #include <sys/systm.h>
41 #include <sys/signalvar.h>
42 #include <sys/resourcevar.h>
43 #include <sys/namei.h>
44 #include <sys/vnode_internal.h>
45 #include <sys/proc_internal.h>
46 #include <sys/kauth.h>
47 #include <sys/timeb.h>
48 #include <sys/times.h>
50 #include <sys/file_internal.h>
52 #include <sys/kernel.h>
55 #include <mach-o/loader.h>
56 #include <mach/vm_region.h>
57 #include <mach/vm_statistics.h>
59 #include <vm/vm_kern.h>
60 #include <vm/vm_protos.h> /* last */
61 #include <vm/vm_map.h> /* current_map() */
62 #include <mach/mach_vm.h> /* mach_vm_region_recurse() */
63 #include <mach/task.h> /* task_suspend() */
64 #include <kern/task.h> /* get_task_numacts() */
67 int flavor
; /* the number for this flavor */
68 int count
; /* count of ints in this flavor */
69 } mythread_state_flavor_t
;
73 mythread_state_flavor_t thread_flavor_array
[]={
74 {PPC_THREAD_STATE
, PPC_THREAD_STATE_COUNT
},
75 {PPC_FLOAT_STATE
, PPC_FLOAT_STATE_COUNT
},
76 {PPC_EXCEPTION_STATE
, PPC_EXCEPTION_STATE_COUNT
},
77 {PPC_VECTOR_STATE
, PPC_VECTOR_STATE_COUNT
}
80 #elif defined (__i386__)
81 mythread_state_flavor_t thread_flavor_array
[] = {
82 {i386_THREAD_STATE
, i386_THREAD_STATE_COUNT
},
83 {i386_THREAD_FPSTATE
, i386_THREAD_FPSTATE_COUNT
},
84 {i386_THREAD_EXCEPTSTATE
, i386_THREAD_EXCEPTSTATE_COUNT
},
85 {i386_THREAD_CTHREADSTATE
, i386_THREAD_CTHREADSTATE_COUNT
},
86 {i386_NEW_THREAD_STATE
, i386_NEW_THREAD_STATE_COUNT
},
87 {i386_FLOAT_STATE
, i386_FLOAT_STATE_COUNT
},
88 {i386_ISA_PORT_MAP_STATE
, i386_ISA_PORT_MAP_STATE_COUNT
},
89 {i386_V86_ASSIST_STATE
, i386_V86_ASSIST_STATE_COUNT
},
90 {THREAD_SYSCALL_STATE
, i386_THREAD_SYSCALL_STATE_COUNT
}
95 #error architecture not supported
102 mythread_state_flavor_t
*flavors
;
106 /* XXX should be static */
107 void collectth_state(thread_t th_act
, void *tirp
);
109 /* XXX not in a Mach header anywhere */
110 kern_return_t
thread_getstatus(register thread_t act
, int flavor
,
111 thread_state_t tstate
, mach_msg_type_number_t
*count
);
112 void task_act_iterate_wth_args(task_t
, void(*)(thread_t
, void *), void *);
115 __private_extern__
int do_coredump
= 1; /* default: dump cores */
116 __private_extern__
int sugid_coredump
= 0; /* default: but not SGUID binaries */
119 collectth_state(thread_t th_act
, void *tirp
)
123 mythread_state_flavor_t
*flavors
;
124 struct thread_command
*tc
;
125 tir_t
*t
= (tir_t
*)tirp
;
128 * Fill in thread command structure.
131 hoffset
= t
->hoffset
;
132 flavors
= t
->flavors
;
134 tc
= (struct thread_command
*) (header
+ hoffset
);
136 tc
->cmdsize
= sizeof(struct thread_command
)
138 hoffset
+= sizeof(struct thread_command
);
140 * Follow with a struct thread_state_flavor and
141 * the appropriate thread state struct for each
142 * thread state flavor.
144 for (i
= 0; i
< mynum_flavors
; i
++) {
145 *(mythread_state_flavor_t
*)(header
+hoffset
) =
147 hoffset
+= sizeof(mythread_state_flavor_t
);
148 thread_getstatus(th_act
, flavors
[i
].flavor
,
149 (thread_state_t
)(header
+hoffset
),
151 hoffset
+= flavors
[i
].count
*sizeof(int);
154 t
->hoffset
= hoffset
;
158 * Create a core image on the file "core".
160 #define MAX_TSTATE_FLAVORS 10
162 coredump(struct proc
*p
)
165 kauth_cred_t cred
= kauth_cred_get();
166 struct vnode_attr va
;
167 struct vfs_context context
;
169 int thread_count
, segment_count
;
170 int command_size
, header_size
, tstate_size
;
173 vm_map_offset_t vmoffset
;
175 vm_map_size_t vmsize
;
178 vm_inherit_t inherit
;
181 char core_name
[MAXCOMLEN
+6];
183 mythread_state_flavor_t flavors
[MAX_TSTATE_FLAVORS
];
186 int nesting_depth
= 0;
188 struct vm_region_submap_info_64 vbr
;
192 struct mach_header
*mh
;
193 struct mach_header_64
*mh64
;
195 size_t mach_header_sz
= sizeof(struct mach_header
);
196 size_t segment_command_sz
= sizeof(struct segment_command
);
198 if (do_coredump
== 0 || /* Not dumping at all */
199 ( (sugid_coredump
== 0) && /* Not dumping SUID/SGID binaries */
200 ( (cred
->cr_svuid
!= cred
->cr_ruid
) ||
201 (cred
->cr_svgid
!= cred
->cr_rgid
)))) {
206 if (IS_64BIT_PROCESS(p
)) {
208 mach_header_sz
= sizeof(struct mach_header_64
);
209 segment_command_sz
= sizeof(struct segment_command_64
);
212 task
= current_task();
214 mapsize
= get_vmmap_size(map
);
216 if (mapsize
>= p
->p_rlimit
[RLIMIT_CORE
].rlim_cur
)
218 (void) task_suspend(task
);
220 /* create name according to sysctl'able format string */
221 name
= proc_core_name(p
->p_comm
, kauth_cred_getuid(cred
), p
->p_pid
);
223 /* if name creation fails, fall back to historical behaviour... */
225 sprintf(core_name
, "/cores/core.%d", p
->p_pid
);
229 context
.vc_ucred
= cred
;
231 if ((error
= vnode_open(name
, (O_CREAT
| FWRITE
| O_NOFOLLOW
), S_IRUSR
, VNODE_LOOKUP_NOFOLLOW
, &vp
, &context
)))
235 VATTR_WANTED(&va
, va_nlink
);
236 /* Don't dump to non-regular files or files with links. */
237 if (vp
->v_type
!= VREG
||
238 vnode_getattr(vp
, &va
, &context
) || va
.va_nlink
!= 1) {
243 VATTR_INIT(&va
); /* better to do it here than waste more stack in vnode_setsize */
244 VATTR_SET(&va
, va_data_size
, 0);
245 vnode_setattr(vp
, &va
, &context
);
246 p
->p_acflag
|= ACORE
;
249 * If the task is modified while dumping the file
250 * (e.g., changes in threads or VM, the resulting
251 * file will not necessarily be correct.
254 thread_count
= get_task_numacts(task
);
255 segment_count
= get_vmmap_entries(map
); /* XXX */
256 bcopy(thread_flavor_array
,flavors
,sizeof(thread_flavor_array
));
258 for (i
= 0; i
< mynum_flavors
; i
++)
259 tstate_size
+= sizeof(mythread_state_flavor_t
) +
260 (flavors
[i
].count
* sizeof(int));
262 command_size
= segment_count
* segment_command_sz
+
263 thread_count
*sizeof(struct thread_command
) +
264 tstate_size
*thread_count
;
266 header_size
= command_size
+ mach_header_sz
;
268 (void) kmem_alloc(kernel_map
,
269 (vm_offset_t
*)&header
,
270 (vm_size_t
)header_size
);
273 * Set up Mach-O header.
276 mh64
= (struct mach_header_64
*)header
;
277 mh64
->magic
= MH_MAGIC_64
;
278 mh64
->cputype
= cpu_type();
279 mh64
->cpusubtype
= cpu_subtype();
280 mh64
->filetype
= MH_CORE
;
281 mh64
->ncmds
= segment_count
+ thread_count
;
282 mh64
->sizeofcmds
= command_size
;
283 mh64
->reserved
= 0; /* 8 byte alignment */
285 mh
= (struct mach_header
*)header
;
286 mh
->magic
= MH_MAGIC
;
287 mh
->cputype
= cpu_type();
288 mh
->cpusubtype
= cpu_subtype();
289 mh
->filetype
= MH_CORE
;
290 mh
->ncmds
= segment_count
+ thread_count
;
291 mh
->sizeofcmds
= command_size
;
294 hoffset
= mach_header_sz
; /* offset into header */
295 foffset
= round_page(header_size
); /* offset into file */
296 vmoffset
= MACH_VM_MIN_ADDRESS
; /* offset into VM */
299 * We use to check for an error, here, now we try and get
302 while (segment_count
> 0) {
303 struct segment_command
*sc
;
304 struct segment_command_64
*sc64
;
307 * Get region information for next region.
311 vbrcount
= VM_REGION_SUBMAP_INFO_COUNT_64
;
312 if((kret
= mach_vm_region_recurse(map
,
313 &vmoffset
, &vmsize
, &nesting_depth
,
314 (vm_region_recurse_info_t
)&vbr
,
315 &vbrcount
)) != KERN_SUCCESS
) {
319 * If we get a valid mapping back, but we're dumping
320 * a 32 bit process, and it's over the allowable
321 * address space of a 32 bit process, it's the same
322 * as if mach_vm_region_recurse() failed.
325 (vmoffset
+ vmsize
> VM_MAX_ADDRESS
)) {
326 kret
= KERN_INVALID_ADDRESS
;
336 if(kret
!= KERN_SUCCESS
)
339 prot
= vbr
.protection
;
340 maxprot
= vbr
.max_protection
;
341 inherit
= vbr
.inheritance
;
343 * Fill in segment command structure.
346 sc64
= (struct segment_command_64
*)(header
+ hoffset
);
347 sc64
->cmd
= LC_SEGMENT_64
;
348 sc64
->cmdsize
= sizeof(struct segment_command_64
);
349 /* segment name is zeroed by kmem_alloc */
350 sc64
->segname
[0] = 0;
351 sc64
->vmaddr
= vmoffset
;
352 sc64
->vmsize
= vmsize
;
353 sc64
->fileoff
= foffset
;
354 sc64
->filesize
= vmsize
;
355 sc64
->maxprot
= maxprot
;
356 sc64
->initprot
= prot
;
359 sc
= (struct segment_command
*) (header
+ hoffset
);
360 sc
->cmd
= LC_SEGMENT
;
361 sc
->cmdsize
= sizeof(struct segment_command
);
362 /* segment name is zeroed by kmem_alloc */
364 sc
->vmaddr
= CAST_DOWN(vm_offset_t
,vmoffset
);
365 sc
->vmsize
= CAST_DOWN(vm_size_t
,vmsize
);
366 sc
->fileoff
= CAST_DOWN(uint32_t,foffset
);
367 sc
->filesize
= CAST_DOWN(uint32_t,vmsize
);
368 sc
->maxprot
= maxprot
;
374 * Write segment out. Try as hard as possible to
375 * get read access to the data.
377 if ((prot
& VM_PROT_READ
) == 0) {
378 mach_vm_protect(map
, vmoffset
, vmsize
, FALSE
,
382 * Only actually perform write if we can read.
383 * Note: if we can't read, then we end up with
384 * a hole in the file.
386 if ((maxprot
& VM_PROT_READ
) == VM_PROT_READ
387 && vbr
.user_tag
!= VM_MEMORY_IOKIT
388 && coredumpok(map
,vmoffset
)) {
389 vm_map_size_t tmp_vmsize
= vmsize
;
390 off_t xfer_foffset
= foffset
;
392 //LP64todo - works around vn_rdwr_64() 2G limit
393 while (tmp_vmsize
> 0) {
394 vm_map_size_t xfer_vmsize
= tmp_vmsize
;
395 if (xfer_vmsize
> INT_MAX
)
396 xfer_vmsize
= INT_MAX
;
397 error
= vn_rdwr_64(UIO_WRITE
, vp
,
398 vmoffset
, xfer_vmsize
, xfer_foffset
,
399 (IS_64BIT_PROCESS(p
) ? UIO_USERSPACE64
: UIO_USERSPACE32
),
400 IO_NODELOCKED
|IO_UNIT
, cred
, (int *) 0, p
);
401 tmp_vmsize
-= xfer_vmsize
;
402 xfer_foffset
+= xfer_vmsize
;
406 hoffset
+= segment_command_sz
;
413 * If there are remaining segments which have not been written
414 * out because break in the loop above, then they were not counted
415 * because they exceed the real address space of the executable
416 * type: remove them from the header's count. This is OK, since
417 * we are allowed to have a sparse area following the segments.
420 mh64
->ncmds
-= segment_count
;
422 mh
->ncmds
-= segment_count
;
425 tir1
.header
= header
;
426 tir1
.hoffset
= hoffset
;
427 tir1
.flavors
= flavors
;
428 tir1
.tstate_size
= tstate_size
;
429 task_act_iterate_wth_args(task
, collectth_state
,&tir1
);
432 * Write out the Mach header at the beginning of the
433 * file. OK to use a 32 bit write for this.
435 error
= vn_rdwr(UIO_WRITE
, vp
, (caddr_t
)header
, header_size
, (off_t
)0,
436 UIO_SYSSPACE32
, IO_NODELOCKED
|IO_UNIT
, cred
, (int *) 0, p
);
437 kmem_free(kernel_map
, header
, header_size
);
439 error1
= vnode_close(vp
, FWRITE
, &context
);