2 * Copyright (c) 2000-2004 Apple Computer, Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * The contents of this file constitute Original Code as defined in and
7 * are subject to the Apple Public Source License Version 1.1 (the
8 * "License"). You may not use this file except in compliance with the
9 * License. Please obtain a copy of the License at
10 * http://www.apple.com/publicsource and read it before using this file.
12 * This Original Code and all software distributed under the License are
13 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
14 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
15 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
17 * License for the specific language governing rights and limitations
20 * @APPLE_LICENSE_HEADER_END@
22 /* Copyright (c) 1991 NeXT Computer, Inc. All rights reserved.
24 * File: bsd/kern/kern_core.c
26 * This file contains machine independent code for performing core dumps.
30 #include <mach/vm_param.h>
31 #include <mach/thread_status.h>
33 #include <sys/param.h>
34 #include <sys/systm.h>
35 #include <sys/signalvar.h>
36 #include <sys/resourcevar.h>
37 #include <sys/namei.h>
38 #include <sys/vnode_internal.h>
39 #include <sys/proc_internal.h>
40 #include <sys/kauth.h>
41 #include <sys/timeb.h>
42 #include <sys/times.h>
44 #include <sys/file_internal.h>
46 #include <sys/kernel.h>
49 #include <mach-o/loader.h>
50 #include <mach/vm_region.h>
51 #include <mach/vm_statistics.h>
53 #include <vm/vm_kern.h>
54 #include <vm/vm_protos.h> /* last */
55 #include <vm/vm_map.h> /* current_map() */
56 #include <mach/mach_vm.h> /* mach_vm_region_recurse() */
57 #include <mach/task.h> /* task_suspend() */
58 #include <kern/task.h> /* get_task_numacts() */
61 int flavor
; /* the number for this flavor */
62 int count
; /* count of ints in this flavor */
63 } mythread_state_flavor_t
;
67 mythread_state_flavor_t thread_flavor_array
[]={
68 {PPC_THREAD_STATE
, PPC_THREAD_STATE_COUNT
},
69 {PPC_FLOAT_STATE
, PPC_FLOAT_STATE_COUNT
},
70 {PPC_EXCEPTION_STATE
, PPC_EXCEPTION_STATE_COUNT
},
71 {PPC_VECTOR_STATE
, PPC_VECTOR_STATE_COUNT
}
74 #elif defined (__i386__)
75 mythread_state_flavor_t thread_flavor_array
[] = {
76 {x86_THREAD_STATE
, x86_THREAD_STATE_COUNT
},
77 {x86_FLOAT_STATE
, x86_FLOAT_STATE_COUNT
},
78 {x86_EXCEPTION_STATE
, x86_EXCEPTION_STATE_COUNT
},
83 #error architecture not supported
90 mythread_state_flavor_t
*flavors
;
94 /* XXX should be static */
95 void collectth_state(thread_t th_act
, void *tirp
);
97 /* XXX not in a Mach header anywhere */
98 kern_return_t
thread_getstatus(register thread_t act
, int flavor
,
99 thread_state_t tstate
, mach_msg_type_number_t
*count
);
100 void task_act_iterate_wth_args(task_t
, void(*)(thread_t
, void *), void *);
103 __private_extern__
int do_coredump
= 1; /* default: dump cores */
104 __private_extern__
int sugid_coredump
= 0; /* default: but not SGUID binaries */
107 collectth_state(thread_t th_act
, void *tirp
)
111 mythread_state_flavor_t
*flavors
;
112 struct thread_command
*tc
;
113 tir_t
*t
= (tir_t
*)tirp
;
116 * Fill in thread command structure.
119 hoffset
= t
->hoffset
;
120 flavors
= t
->flavors
;
122 tc
= (struct thread_command
*) (header
+ hoffset
);
124 tc
->cmdsize
= sizeof(struct thread_command
)
126 hoffset
+= sizeof(struct thread_command
);
128 * Follow with a struct thread_state_flavor and
129 * the appropriate thread state struct for each
130 * thread state flavor.
132 for (i
= 0; i
< mynum_flavors
; i
++) {
133 *(mythread_state_flavor_t
*)(header
+hoffset
) =
135 hoffset
+= sizeof(mythread_state_flavor_t
);
136 thread_getstatus(th_act
, flavors
[i
].flavor
,
137 (thread_state_t
)(header
+hoffset
),
139 hoffset
+= flavors
[i
].count
*sizeof(int);
142 t
->hoffset
= hoffset
;
146 * Create a core image on the file "core".
148 #define MAX_TSTATE_FLAVORS 10
150 coredump(struct proc
*p
)
153 kauth_cred_t cred
= kauth_cred_get();
154 struct vnode_attr va
;
155 struct vfs_context context
;
157 int thread_count
, segment_count
;
158 int command_size
, header_size
, tstate_size
;
161 vm_map_offset_t vmoffset
;
163 vm_map_size_t vmsize
;
166 vm_inherit_t inherit
;
169 char core_name
[MAXCOMLEN
+6];
171 mythread_state_flavor_t flavors
[MAX_TSTATE_FLAVORS
];
174 int nesting_depth
= 0;
176 struct vm_region_submap_info_64 vbr
;
180 struct mach_header
*mh
;
181 struct mach_header_64
*mh64
;
183 size_t mach_header_sz
= sizeof(struct mach_header
);
184 size_t segment_command_sz
= sizeof(struct segment_command
);
186 if (do_coredump
== 0 || /* Not dumping at all */
187 ( (sugid_coredump
== 0) && /* Not dumping SUID/SGID binaries */
188 ( (cred
->cr_svuid
!= cred
->cr_ruid
) ||
189 (cred
->cr_svgid
!= cred
->cr_rgid
)))) {
194 if (IS_64BIT_PROCESS(p
)) {
196 mach_header_sz
= sizeof(struct mach_header_64
);
197 segment_command_sz
= sizeof(struct segment_command_64
);
200 task
= current_task();
202 mapsize
= get_vmmap_size(map
);
204 if (mapsize
>= p
->p_rlimit
[RLIMIT_CORE
].rlim_cur
)
206 (void) task_suspend(task
);
208 /* create name according to sysctl'able format string */
209 name
= proc_core_name(p
->p_comm
, kauth_cred_getuid(cred
), p
->p_pid
);
211 /* if name creation fails, fall back to historical behaviour... */
213 sprintf(core_name
, "/cores/core.%d", p
->p_pid
);
217 context
.vc_ucred
= cred
;
219 if ((error
= vnode_open(name
, (O_CREAT
| FWRITE
| O_NOFOLLOW
), S_IRUSR
, VNODE_LOOKUP_NOFOLLOW
, &vp
, &context
)))
223 VATTR_WANTED(&va
, va_nlink
);
224 /* Don't dump to non-regular files or files with links. */
225 if (vp
->v_type
!= VREG
||
226 vnode_getattr(vp
, &va
, &context
) || va
.va_nlink
!= 1) {
231 VATTR_INIT(&va
); /* better to do it here than waste more stack in vnode_setsize */
232 VATTR_SET(&va
, va_data_size
, 0);
233 vnode_setattr(vp
, &va
, &context
);
234 p
->p_acflag
|= ACORE
;
237 * If the task is modified while dumping the file
238 * (e.g., changes in threads or VM, the resulting
239 * file will not necessarily be correct.
242 thread_count
= get_task_numacts(task
);
243 segment_count
= get_vmmap_entries(map
); /* XXX */
244 bcopy(thread_flavor_array
,flavors
,sizeof(thread_flavor_array
));
246 for (i
= 0; i
< mynum_flavors
; i
++)
247 tstate_size
+= sizeof(mythread_state_flavor_t
) +
248 (flavors
[i
].count
* sizeof(int));
250 command_size
= segment_count
* segment_command_sz
+
251 thread_count
*sizeof(struct thread_command
) +
252 tstate_size
*thread_count
;
254 header_size
= command_size
+ mach_header_sz
;
256 (void) kmem_alloc(kernel_map
,
257 (vm_offset_t
*)&header
,
258 (vm_size_t
)header_size
);
261 * Set up Mach-O header.
264 mh64
= (struct mach_header_64
*)header
;
265 mh64
->magic
= MH_MAGIC_64
;
266 mh64
->cputype
= cpu_type();
267 mh64
->cpusubtype
= cpu_subtype();
268 mh64
->filetype
= MH_CORE
;
269 mh64
->ncmds
= segment_count
+ thread_count
;
270 mh64
->sizeofcmds
= command_size
;
271 mh64
->reserved
= 0; /* 8 byte alignment */
273 mh
= (struct mach_header
*)header
;
274 mh
->magic
= MH_MAGIC
;
275 mh
->cputype
= cpu_type();
276 mh
->cpusubtype
= cpu_subtype();
277 mh
->filetype
= MH_CORE
;
278 mh
->ncmds
= segment_count
+ thread_count
;
279 mh
->sizeofcmds
= command_size
;
282 hoffset
= mach_header_sz
; /* offset into header */
283 foffset
= round_page(header_size
); /* offset into file */
284 vmoffset
= MACH_VM_MIN_ADDRESS
; /* offset into VM */
287 * We use to check for an error, here, now we try and get
290 while (segment_count
> 0) {
291 struct segment_command
*sc
;
292 struct segment_command_64
*sc64
;
295 * Get region information for next region.
299 vbrcount
= VM_REGION_SUBMAP_INFO_COUNT_64
;
300 if((kret
= mach_vm_region_recurse(map
,
301 &vmoffset
, &vmsize
, &nesting_depth
,
302 (vm_region_recurse_info_t
)&vbr
,
303 &vbrcount
)) != KERN_SUCCESS
) {
307 * If we get a valid mapping back, but we're dumping
308 * a 32 bit process, and it's over the allowable
309 * address space of a 32 bit process, it's the same
310 * as if mach_vm_region_recurse() failed.
313 (vmoffset
+ vmsize
> VM_MAX_ADDRESS
)) {
314 kret
= KERN_INVALID_ADDRESS
;
324 if(kret
!= KERN_SUCCESS
)
327 prot
= vbr
.protection
;
328 maxprot
= vbr
.max_protection
;
329 inherit
= vbr
.inheritance
;
331 * Fill in segment command structure.
334 sc64
= (struct segment_command_64
*)(header
+ hoffset
);
335 sc64
->cmd
= LC_SEGMENT_64
;
336 sc64
->cmdsize
= sizeof(struct segment_command_64
);
337 /* segment name is zeroed by kmem_alloc */
338 sc64
->segname
[0] = 0;
339 sc64
->vmaddr
= vmoffset
;
340 sc64
->vmsize
= vmsize
;
341 sc64
->fileoff
= foffset
;
342 sc64
->filesize
= vmsize
;
343 sc64
->maxprot
= maxprot
;
344 sc64
->initprot
= prot
;
347 sc
= (struct segment_command
*) (header
+ hoffset
);
348 sc
->cmd
= LC_SEGMENT
;
349 sc
->cmdsize
= sizeof(struct segment_command
);
350 /* segment name is zeroed by kmem_alloc */
352 sc
->vmaddr
= CAST_DOWN(vm_offset_t
,vmoffset
);
353 sc
->vmsize
= CAST_DOWN(vm_size_t
,vmsize
);
354 sc
->fileoff
= CAST_DOWN(uint32_t,foffset
);
355 sc
->filesize
= CAST_DOWN(uint32_t,vmsize
);
356 sc
->maxprot
= maxprot
;
362 * Write segment out. Try as hard as possible to
363 * get read access to the data.
365 if ((prot
& VM_PROT_READ
) == 0) {
366 mach_vm_protect(map
, vmoffset
, vmsize
, FALSE
,
370 * Only actually perform write if we can read.
371 * Note: if we can't read, then we end up with
372 * a hole in the file.
374 if ((maxprot
& VM_PROT_READ
) == VM_PROT_READ
375 && vbr
.user_tag
!= VM_MEMORY_IOKIT
376 && coredumpok(map
,vmoffset
)) {
377 vm_map_size_t tmp_vmsize
= vmsize
;
378 off_t xfer_foffset
= foffset
;
380 //LP64todo - works around vn_rdwr_64() 2G limit
381 while (tmp_vmsize
> 0) {
382 vm_map_size_t xfer_vmsize
= tmp_vmsize
;
383 if (xfer_vmsize
> INT_MAX
)
384 xfer_vmsize
= INT_MAX
;
385 error
= vn_rdwr_64(UIO_WRITE
, vp
,
386 vmoffset
, xfer_vmsize
, xfer_foffset
,
387 (IS_64BIT_PROCESS(p
) ? UIO_USERSPACE64
: UIO_USERSPACE32
),
388 IO_NODELOCKED
|IO_UNIT
, cred
, (int *) 0, p
);
389 tmp_vmsize
-= xfer_vmsize
;
390 xfer_foffset
+= xfer_vmsize
;
394 hoffset
+= segment_command_sz
;
401 * If there are remaining segments which have not been written
402 * out because break in the loop above, then they were not counted
403 * because they exceed the real address space of the executable
404 * type: remove them from the header's count. This is OK, since
405 * we are allowed to have a sparse area following the segments.
408 mh64
->ncmds
-= segment_count
;
410 mh
->ncmds
-= segment_count
;
413 tir1
.header
= header
;
414 tir1
.hoffset
= hoffset
;
415 tir1
.flavors
= flavors
;
416 tir1
.tstate_size
= tstate_size
;
417 task_act_iterate_wth_args(task
, collectth_state
,&tir1
);
420 * Write out the Mach header at the beginning of the
421 * file. OK to use a 32 bit write for this.
423 error
= vn_rdwr(UIO_WRITE
, vp
, (caddr_t
)header
, header_size
, (off_t
)0,
424 UIO_SYSSPACE32
, IO_NODELOCKED
|IO_UNIT
, cred
, (int *) 0, p
);
425 kmem_free(kernel_map
, header
, header_size
);
427 error1
= vnode_close(vp
, FWRITE
, &context
);