2 * Copyright (c) 1995-1996 Søren Schmidt
3 * Copyright (c) 1996 Peter Wemm
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer
11 * in this position and unchanged.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software withough specific prior written permission
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 * $FreeBSD: src/sys/kern/imgact_elf.c,v 1.73.2.13 2002/12/28 19:49:41 dillon Exp $
30 * $DragonFly: src/sys/kern/imgact_elf.c,v 1.31 2005/07/04 16:02:58 dillon Exp $
33 #include <sys/param.h>
35 #include <sys/fcntl.h>
37 #include <sys/imgact.h>
38 #include <sys/imgact_elf.h>
39 #include <sys/kernel.h>
40 #include <sys/malloc.h>
42 #include <sys/systm.h>
44 #include <sys/nlookup.h>
45 #include <sys/pioctl.h>
46 #include <sys/procfs.h>
47 #include <sys/resourcevar.h>
48 #include <sys/signalvar.h>
50 #include <sys/syscall.h>
51 #include <sys/sysctl.h>
52 #include <sys/sysent.h>
53 #include <sys/vnode.h>
56 #include <vm/vm_kern.h>
57 #include <vm/vm_param.h>
60 #include <vm/vm_map.h>
61 #include <vm/vm_object.h>
62 #include <vm/vm_extern.h>
64 #include <machine/elf.h>
65 #include <machine/md_var.h>
66 #include <sys/mount.h>
68 #define OLD_EI_BRAND 8
73 static int elf_check_header (const Elf_Ehdr *hdr);
74 static int elf_freebsd_fixup (register_t **stack_base,
75 struct image_params *imgp);
76 static int elf_load_file (struct proc *p, const char *file, u_long *addr,
78 static int elf_load_section (struct proc *p,
79 struct vmspace *vmspace, struct vnode *vp,
80 vm_offset_t offset, caddr_t vmaddr, size_t memsz, size_t filsz,
82 static int exec_elf_imgact (struct image_params *imgp);
84 static int elf_trace = 0;
85 SYSCTL_INT(_debug, OID_AUTO, elf_trace, CTLFLAG_RW, &elf_trace, 0, "");
86 static int elf_legacy_coredump = 0;
87 SYSCTL_INT(_debug, OID_AUTO, elf_legacy_coredump, CTLFLAG_RW,
88 &elf_legacy_coredump, 0, "");
90 static int dragonfly_match_abi_note(const Elf_Note *);
91 static int freebsd_match_abi_note(const Elf_Note *);
93 static struct sysentvec elf_freebsd_sysvec = {
113 static Elf_Brandinfo freebsd_brand_info = {
116 freebsd_match_abi_note,
118 "/usr/libexec/ld-elf.so.1",
122 static Elf_Brandinfo dragonfly_brand_info = {
125 dragonfly_match_abi_note,
127 "/usr/libexec/ld-elf.so.2",
131 static Elf_Brandinfo *elf_brand_list[MAX_BRANDS] = {
132 &dragonfly_brand_info,
139 freebsd_match_abi_note(const Elf_Note *abi_note)
141 const char *abi_name = (const char *)
142 ((const uint8_t *)abi_note + sizeof(*abi_note));
144 if (abi_note->n_namesz != sizeof("FreeBSD"))
146 if (memcmp(abi_name, "FreeBSD", sizeof("FreeBSD")))
152 dragonfly_match_abi_note(const Elf_Note *abi_note)
154 const char *abi_name = (const char *)
155 ((const uint8_t *)abi_note + sizeof(*abi_note));
157 if (abi_note->n_namesz != sizeof("DragonFly"))
159 if (memcmp(abi_name, "DragonFly", sizeof("DragonFly")))
165 elf_insert_brand_entry(Elf_Brandinfo *entry)
169 for (i=1; i<MAX_BRANDS; i++) {
170 if (elf_brand_list[i] == NULL) {
171 elf_brand_list[i] = entry;
181 elf_remove_brand_entry(Elf_Brandinfo *entry)
185 for (i=1; i<MAX_BRANDS; i++) {
186 if (elf_brand_list[i] == entry) {
187 elf_brand_list[i] = NULL;
197 elf_brand_inuse(Elf_Brandinfo *entry)
202 FOREACH_PROC_IN_SYSTEM(p) {
203 if (p->p_sysent == entry->sysvec) {
213 elf_check_header(const Elf_Ehdr *hdr)
216 hdr->e_ident[EI_CLASS] != ELF_TARG_CLASS ||
217 hdr->e_ident[EI_DATA] != ELF_TARG_DATA ||
218 hdr->e_ident[EI_VERSION] != EV_CURRENT ||
219 hdr->e_phentsize != sizeof(Elf_Phdr) ||
220 hdr->e_ehsize != sizeof(Elf_Ehdr) ||
221 hdr->e_version != ELF_TARG_VER)
224 if (!ELF_MACHINE_OK(hdr->e_machine))
231 elf_load_section(struct proc *p, struct vmspace *vmspace, struct vnode *vp,
232 vm_offset_t offset, caddr_t vmaddr, size_t memsz, size_t filsz,
236 vm_offset_t map_addr;
241 vm_offset_t file_addr;
242 vm_offset_t data_buf = 0;
244 VOP_GETVOBJECT(vp, &object);
248 * It's necessary to fail if the filsz + offset taken from the
249 * header is greater than the actual file pager object's size.
250 * If we were to allow this, then the vm_map_find() below would
251 * walk right off the end of the file object and into the ether.
253 * While I'm here, might as well check for something else that
254 * is invalid: filsz cannot be greater than memsz.
256 if ((off_t)filsz + offset > object->un_pager.vnp.vnp_size ||
258 uprintf("elf_load_section: truncated ELF file\n");
262 map_addr = trunc_page((vm_offset_t)vmaddr);
263 file_addr = trunc_page(offset);
266 * We have two choices. We can either clear the data in the last page
267 * of an oversized mapping, or we can start the anon mapping a page
268 * early and copy the initialized data into that first page. We
269 * choose the second..
272 map_len = trunc_page(offset+filsz) - file_addr;
274 map_len = round_page(offset+filsz) - file_addr;
277 vm_object_reference(object);
279 /* cow flags: don't dump readonly sections in core */
280 cow = MAP_COPY_ON_WRITE | MAP_PREFAULT |
281 (prot & VM_PROT_WRITE ? 0 : MAP_DISABLE_COREDUMP);
283 count = vm_map_entry_reserve(MAP_RESERVE_COUNT);
284 vm_map_lock(&vmspace->vm_map);
285 rv = vm_map_insert(&vmspace->vm_map, &count,
287 file_addr, /* file offset */
288 map_addr, /* virtual start */
289 map_addr + map_len,/* virtual end */
293 vm_map_unlock(&vmspace->vm_map);
294 vm_map_entry_release(count);
295 if (rv != KERN_SUCCESS) {
296 vm_object_deallocate(object);
300 /* we can stop now if we've covered it all */
301 if (memsz == filsz) {
308 * We have to get the remaining bit of the file into the first part
309 * of the oversized map segment. This is normally because the .data
310 * segment in the file is extended to provide bss. It's a neat idea
311 * to try and save a page, but it's a pain in the behind to implement.
313 copy_len = (offset + filsz) - trunc_page(offset + filsz);
314 map_addr = trunc_page((vm_offset_t)vmaddr + filsz);
315 map_len = round_page((vm_offset_t)vmaddr + memsz) - map_addr;
317 /* This had damn well better be true! */
319 count = vm_map_entry_reserve(MAP_RESERVE_COUNT);
320 vm_map_lock(&vmspace->vm_map);
321 rv = vm_map_insert(&vmspace->vm_map, &count,
323 map_addr, map_addr + map_len,
324 VM_PROT_ALL, VM_PROT_ALL, 0);
325 vm_map_unlock(&vmspace->vm_map);
326 vm_map_entry_release(count);
327 if (rv != KERN_SUCCESS) {
333 vm_object_reference(object);
334 rv = vm_map_find(exec_map,
336 trunc_page(offset + filsz),
342 MAP_COPY_ON_WRITE | MAP_PREFAULT_PARTIAL);
343 if (rv != KERN_SUCCESS) {
344 vm_object_deallocate(object);
348 /* send the page fragment to user space */
349 error = copyout((caddr_t)data_buf, (caddr_t)map_addr, copy_len);
350 vm_map_remove(exec_map, data_buf, data_buf + PAGE_SIZE);
357 * set it to the specified protection
359 vm_map_protect(&vmspace->vm_map, map_addr, map_addr + map_len, prot,
366 * Load the file "file" into memory. It may be either a shared object
369 * The "addr" reference parameter is in/out. On entry, it specifies
370 * the address where a shared object should be loaded. If the file is
371 * an executable, this value is ignored. On exit, "addr" specifies
372 * where the file was actually loaded.
374 * The "entry" reference parameter is out only. On exit, it specifies
375 * the entry point for the loaded file.
378 elf_load_file(struct proc *p, const char *file, u_long *addr, u_long *entry)
381 struct nlookupdata nd;
383 struct image_params image_params;
385 const Elf_Ehdr *hdr = NULL;
386 const Elf_Phdr *phdr = NULL;
387 struct nlookupdata *nd;
388 struct vmspace *vmspace = p->p_vmspace;
390 struct image_params *imgp;
393 u_long base_addr = 0;
394 int error, i, numsegs;
395 struct thread *td = p->p_thread;
397 tempdata = malloc(sizeof(*tempdata), M_TEMP, M_WAITOK);
399 attr = &tempdata->attr;
400 imgp = &tempdata->image_params;
403 * Initialize part of the common data
407 imgp->firstpage = NULL;
408 imgp->image_header = NULL;
411 error = nlookup_init(nd, file, UIO_SYSSPACE, NLC_FOLLOW);
415 error = cache_vget(nd->nl_ncp, nd->nl_cred, LK_EXCLUSIVE, &imgp->vp);
421 * Check permissions, modes, uid, etc on the file, and "open" it.
423 error = exec_check_permissions(imgp);
425 VOP_UNLOCK(imgp->vp, 0, td);
429 error = exec_map_first_page(imgp);
431 * Also make certain that the interpreter stays the same, so set
432 * its VTEXT flag, too.
435 imgp->vp->v_flag |= VTEXT;
436 VOP_UNLOCK(imgp->vp, 0, td);
440 hdr = (const Elf_Ehdr *)imgp->image_header;
441 if ((error = elf_check_header(hdr)) != 0)
443 if (hdr->e_type == ET_DYN)
445 else if (hdr->e_type == ET_EXEC)
452 /* Only support headers that fit within first page for now
453 * (multiplication of two Elf_Half fields will not overflow) */
454 if ((hdr->e_phoff > PAGE_SIZE) ||
455 (hdr->e_phentsize * hdr->e_phnum) > PAGE_SIZE - hdr->e_phoff) {
460 phdr = (const Elf_Phdr *)(imgp->image_header + hdr->e_phoff);
462 for (i = 0, numsegs = 0; i < hdr->e_phnum; i++) {
463 if (phdr[i].p_type == PT_LOAD) { /* Loadable segment */
465 if (phdr[i].p_flags & PF_X)
466 prot |= VM_PROT_EXECUTE;
467 if (phdr[i].p_flags & PF_W)
468 prot |= VM_PROT_WRITE;
469 if (phdr[i].p_flags & PF_R)
470 prot |= VM_PROT_READ;
472 error = elf_load_section(
473 p, vmspace, imgp->vp,
475 (caddr_t)phdr[i].p_vaddr +
478 phdr[i].p_filesz, prot);
482 * Establish the base address if this is the
486 base_addr = trunc_page(phdr[i].p_vaddr + rbase);
491 *entry=(unsigned long)hdr->e_entry + rbase;
495 exec_unmap_first_page(imgp);
500 free(tempdata, M_TEMP);
506 * non static, as it can be overridden by start_init()
508 int fallback_elf_brand = -1;
509 SYSCTL_INT(_kern, OID_AUTO, fallback_elf_brand, CTLFLAG_RW,
510 &fallback_elf_brand, -1,
511 "ELF brand of last resort");
514 exec_elf_imgact(struct image_params *imgp)
516 const Elf_Ehdr *hdr = (const Elf_Ehdr *) imgp->image_header;
517 const Elf_Phdr *phdr;
518 Elf_Auxargs *elf_auxargs = NULL;
519 struct vmspace *vmspace;
521 u_long text_size = 0, data_size = 0, total_size = 0;
522 u_long text_addr = 0, data_addr = 0;
523 u_long seg_size, seg_addr;
524 u_long addr, entry = 0, proghdr = 0;
526 const char *interp = NULL;
527 const Elf_Note *abi_note = NULL;
528 Elf_Brandinfo *brand_info;
534 * Do we have a valid ELF header ?
536 if (elf_check_header(hdr) != 0 || hdr->e_type != ET_EXEC)
540 * From here on down, we return an errno, not -1, as we've
541 * detected an ELF file.
544 if ((hdr->e_phoff > PAGE_SIZE) ||
545 (hdr->e_phoff + hdr->e_phentsize * hdr->e_phnum) > PAGE_SIZE) {
546 /* Only support headers in first page for now */
549 phdr = (const Elf_Phdr*)(imgp->image_header + hdr->e_phoff);
552 * From this point on, we may have resources that need to be freed.
555 exec_new_vmspace(imgp, NULL);
558 * Yeah, I'm paranoid. There is every reason in the world to get
559 * VTEXT now since from here on out, there are places we can have
560 * a context switch. Better safe than sorry; I really don't want
561 * the file to change while it's being loaded.
563 vsetflags(imgp->vp, VTEXT);
565 vmspace = imgp->proc->p_vmspace;
567 for (i = 0; i < hdr->e_phnum; i++) {
568 switch(phdr[i].p_type) {
570 case PT_LOAD: /* Loadable segment */
572 if (phdr[i].p_flags & PF_X)
573 prot |= VM_PROT_EXECUTE;
574 if (phdr[i].p_flags & PF_W)
575 prot |= VM_PROT_WRITE;
576 if (phdr[i].p_flags & PF_R)
577 prot |= VM_PROT_READ;
579 if ((error = elf_load_section(imgp->proc,
582 (caddr_t)phdr[i].p_vaddr,
584 phdr[i].p_filesz, prot)) != 0)
588 * If this segment contains the program headers,
589 * remember their virtual address for the AT_PHDR
590 * aux entry. Static binaries don't usually include
593 if (phdr[i].p_offset == 0 &&
594 hdr->e_phoff + hdr->e_phnum * hdr->e_phentsize
596 proghdr = phdr[i].p_vaddr + hdr->e_phoff;
598 seg_addr = trunc_page(phdr[i].p_vaddr);
599 seg_size = round_page(phdr[i].p_memsz +
600 phdr[i].p_vaddr - seg_addr);
603 * Is this .text or .data? We can't use
604 * VM_PROT_WRITE or VM_PROT_EXEC, it breaks the
605 * alpha terribly and possibly does other bad
606 * things so we stick to the old way of figuring
607 * it out: If the segment contains the program
608 * entry point, it's a text segment, otherwise it
611 * Note that obreak() assumes that data_addr +
612 * data_size == end of data load area, and the ELF
613 * file format expects segments to be sorted by
614 * address. If multiple data segments exist, the
615 * last one will be used.
617 if (hdr->e_entry >= phdr[i].p_vaddr &&
618 hdr->e_entry < (phdr[i].p_vaddr +
620 text_size = seg_size;
621 text_addr = seg_addr;
622 entry = (u_long)hdr->e_entry;
624 data_size = seg_size;
625 data_addr = seg_addr;
627 total_size += seg_size;
630 * Check limits. It should be safe to check the
631 * limits after loading the segment since we do
632 * not actually fault in all the segment's pages.
635 imgp->proc->p_rlimit[RLIMIT_DATA].rlim_cur ||
636 text_size > maxtsiz ||
638 imgp->proc->p_rlimit[RLIMIT_VMEM].rlim_cur) {
643 case PT_INTERP: /* Path to interpreter */
644 if (phdr[i].p_filesz > MAXPATHLEN ||
645 phdr[i].p_offset + phdr[i].p_filesz > PAGE_SIZE) {
649 interp = imgp->image_header + phdr[i].p_offset;
651 case PT_NOTE: /* Check for .note.ABI-tag */
653 const Elf_Note *tmp_note;
654 /* XXX handle anything outside the first page */
655 if (phdr[i].p_offset + phdr[i].p_filesz > PAGE_SIZE)
657 if (phdr[i].p_filesz < sizeof(Elf_Note))
658 continue; /* ENOEXEC? */
659 tmp_note = (const Elf_Note *)(imgp->image_header + phdr[i].p_offset);
660 if (tmp_note->n_type != 1)
662 if (tmp_note->n_namesz + sizeof(Elf_Note) +
663 tmp_note->n_descsz > phdr[i].p_filesz)
664 continue; /* ENOEXEC? */
668 case PT_PHDR: /* Program header table info */
669 proghdr = phdr[i].p_vaddr;
676 vmspace->vm_tsize = text_size >> PAGE_SHIFT;
677 vmspace->vm_taddr = (caddr_t)(uintptr_t)text_addr;
678 vmspace->vm_dsize = data_size >> PAGE_SHIFT;
679 vmspace->vm_daddr = (caddr_t)(uintptr_t)data_addr;
681 addr = ELF_RTLD_ADDR(vmspace);
683 imgp->entry_addr = entry;
687 /* We support three types of branding -- (1) the ELF EI_OSABI field
688 * that SCO added to the ELF spec, (2) FreeBSD 3.x's traditional string
689 * branding w/in the ELF header, and (3) path of the `interp_path'
690 * field. We should also look for an ".note.ABI-tag" ELF section now
691 * in all Linux ELF binaries, FreeBSD 4.1+, and some NetBSD ones.
694 /* If the executable has a brand, search for it in the brand list. */
695 if (brand_info == NULL && hdr->e_ident[EI_OSABI] != ELFOSABI_NONE) {
696 for (i = 0; i < MAX_BRANDS; i++) {
697 Elf_Brandinfo *bi = elf_brand_list[i];
700 (hdr->e_ident[EI_OSABI] == bi->brand
702 strncmp((const char *)&hdr->e_ident[OLD_EI_BRAND],
703 bi->compat_3_brand, strlen(bi->compat_3_brand)))) {
710 /* Search for a recognized ABI. */
711 if (brand_info == NULL && abi_note != NULL) {
712 for (i = 0; i < MAX_BRANDS; i++) {
713 Elf_Brandinfo *bi = elf_brand_list[i];
715 if (bi != NULL && bi->match_abi_note != NULL &&
716 (*bi->match_abi_note)(abi_note)) {
724 * ELFOSABI_NONE == ELFOSABI_SYSV, so a SYSV binary misses all
725 * checks so far, since it is neither branded nor does it have
726 * an ABI note. If the EI_OSABI field is ELFOSABI_NONE, assume
727 * it is svr4 and look for an entry in the elf_brand_list with
728 * match_abi_note == NULL.
730 if (brand_info == NULL && hdr->e_ident[EI_OSABI] == ELFOSABI_NONE) {
731 for (i = 0; i < MAX_BRANDS; i++) {
732 Elf_Brandinfo *bi = elf_brand_list[i];
734 if (bi != NULL && bi->match_abi_note == NULL &&
735 ELFOSABI_SYSV == bi->brand) {
742 /* Lacking a recognized ABI, search for a recognized interpreter. */
743 if (brand_info == NULL && interp != NULL) {
744 for (i = 0; i < MAX_BRANDS; i++) {
745 Elf_Brandinfo *bi = elf_brand_list[i];
748 strcmp(interp, bi->interp_path) == 0) {
755 /* Lacking a recognized interpreter, try the default brand */
756 if (brand_info == NULL) {
757 for (i = 0; i < MAX_BRANDS; i++) {
758 Elf_Brandinfo *bi = elf_brand_list[i];
760 if (bi != NULL && fallback_elf_brand == bi->brand) {
767 if (brand_info == NULL) {
768 uprintf("ELF binary type \"%u\" not known.\n",
769 hdr->e_ident[EI_OSABI]);
774 imgp->proc->p_sysent = brand_info->sysvec;
775 if (interp != NULL) {
776 path = malloc(MAXPATHLEN, M_TEMP, M_WAITOK);
777 snprintf(path, MAXPATHLEN, "%s%s",
778 brand_info->emul_path, interp);
779 if ((error = elf_load_file(imgp->proc, path, &addr,
780 &imgp->entry_addr)) != 0) {
781 if ((error = elf_load_file(imgp->proc, interp, &addr,
782 &imgp->entry_addr)) != 0) {
783 uprintf("ELF interpreter %s not found\n", path);
792 * Construct auxargs table (used by the fixup routine)
794 elf_auxargs = malloc(sizeof(Elf_Auxargs), M_TEMP, M_WAITOK);
795 elf_auxargs->execfd = -1;
796 elf_auxargs->phdr = proghdr;
797 elf_auxargs->phent = hdr->e_phentsize;
798 elf_auxargs->phnum = hdr->e_phnum;
799 elf_auxargs->pagesz = PAGE_SIZE;
800 elf_auxargs->base = addr;
801 elf_auxargs->flags = 0;
802 elf_auxargs->entry = entry;
803 elf_auxargs->trace = elf_trace;
805 imgp->auxargs = elf_auxargs;
806 imgp->interpreted = 0;
813 elf_freebsd_fixup(register_t **stack_base, struct image_params *imgp)
815 Elf_Auxargs *args = (Elf_Auxargs *)imgp->auxargs;
818 pos = *stack_base + (imgp->args->argc + imgp->args->envc + 2);
821 AUXARGS_ENTRY(pos, AT_DEBUG, 1);
823 if (args->execfd != -1) {
824 AUXARGS_ENTRY(pos, AT_EXECFD, args->execfd);
826 AUXARGS_ENTRY(pos, AT_PHDR, args->phdr);
827 AUXARGS_ENTRY(pos, AT_PHENT, args->phent);
828 AUXARGS_ENTRY(pos, AT_PHNUM, args->phnum);
829 AUXARGS_ENTRY(pos, AT_PAGESZ, args->pagesz);
830 AUXARGS_ENTRY(pos, AT_FLAGS, args->flags);
831 AUXARGS_ENTRY(pos, AT_ENTRY, args->entry);
832 AUXARGS_ENTRY(pos, AT_BASE, args->base);
833 AUXARGS_ENTRY(pos, AT_NULL, 0);
835 free(imgp->auxargs, M_TEMP);
836 imgp->auxargs = NULL;
839 suword(*stack_base, (long) imgp->args->argc);
844 * Code for generating ELF core dumps.
847 typedef int (*segment_callback) (vm_map_entry_t, void *);
849 /* Closure for cb_put_phdr(). */
850 struct phdr_closure {
851 Elf_Phdr *phdr; /* Program header to fill in (incremented) */
852 Elf_Phdr *phdr_max; /* Pointer bound for error check */
853 Elf_Off offset; /* Offset of segment in core file */
856 /* Closure for cb_size_segment(). */
857 struct sseg_closure {
858 int count; /* Count of writable segments. */
859 size_t vsize; /* Total size of all writable segments. */
862 /* Closure for cb_put_fp(). */
865 struct vn_hdr *vnh_max;
870 typedef struct elf_buf {
876 static void *target_reserve(elf_buf_t target, size_t bytes, int *error);
878 static int cb_put_phdr (vm_map_entry_t, void *);
879 static int cb_size_segment (vm_map_entry_t, void *);
880 static int cb_fpcount_segment(vm_map_entry_t, void *);
881 static int cb_put_fp(vm_map_entry_t, void *);
884 static int each_segment (struct proc *, segment_callback, void *, int);
885 static int elf_corehdr (struct proc *, struct file *, struct ucred *,
887 static int elf_puthdr (struct proc *, elf_buf_t, const prstatus_t *,
888 const prfpregset_t *, const prpsinfo_t *, int);
889 static int elf_putnote (elf_buf_t, const char *, int, const void *, size_t);
891 static int elf_putsigs(struct proc *, elf_buf_t);
892 static int elf_puttextvp(struct proc *, elf_buf_t);
893 static int elf_putfiles(struct proc *, elf_buf_t);
895 extern int osreldate;
898 elf_coredump(struct proc *p, struct vnode *vp, off_t limit)
903 if ((error = falloc(NULL, &fp, NULL)) != 0)
905 fsetcred(fp, p->p_ucred);
910 fp->f_data = (caddr_t)vp;
911 fp->f_flag = O_CREAT|O_WRONLY|O_NOFOLLOW;
912 fp->f_ops = &vnode_fileops;
913 fp->f_type = DTYPE_VNODE;
914 VOP_UNLOCK(vp, 0, p->p_thread);
916 error = generic_elf_coredump(p, fp, limit);
920 fp->f_ops = &badfileops;
922 fdrop(fp, p->p_thread);
927 generic_elf_coredump(struct proc *p, struct file *fp, off_t limit)
929 struct ucred *cred = p->p_ucred;
931 struct sseg_closure seginfo;
932 struct elf_buf target;
935 printf("can't dump core - null fp\n");
938 * Size the program segments
942 each_segment(p, cb_size_segment, &seginfo, 1);
945 * Calculate the size of the core file header area by making
946 * a dry run of generating it. Nothing is written, but the
947 * size is calculated.
949 bzero(&target, sizeof(target));
950 elf_puthdr(p, &target, NULL, NULL, NULL, seginfo.count);
952 if (target.off + seginfo.vsize >= limit)
956 * Allocate memory for building the header, fill it up,
959 target.off_max = target.off;
961 target.buf = malloc(target.off_max, M_TEMP, M_WAITOK|M_ZERO);
963 if (target.buf == NULL)
965 error = elf_corehdr(p, fp, cred, seginfo.count, &target);
967 /* Write the contents of all of the writable segments. */
973 php = (Elf_Phdr *)(target.buf + sizeof(Elf_Ehdr)) + 1;
974 for (i = 0; i < seginfo.count; i++) {
975 error = fp_write(fp, (caddr_t)php->p_vaddr,
976 php->p_filesz, &nbytes);
982 free(target.buf, M_TEMP);
988 * A callback for each_segment() to write out the segment's
989 * program header entry.
992 cb_put_phdr(vm_map_entry_t entry, void *closure)
994 struct phdr_closure *phc = closure;
995 Elf_Phdr *phdr = phc->phdr;
997 if (phc->phdr == phc->phdr_max)
1000 phc->offset = round_page(phc->offset);
1002 phdr->p_type = PT_LOAD;
1003 phdr->p_offset = phc->offset;
1004 phdr->p_vaddr = entry->start;
1006 phdr->p_filesz = phdr->p_memsz = entry->end - entry->start;
1007 phdr->p_align = PAGE_SIZE;
1009 if (entry->protection & VM_PROT_READ)
1010 phdr->p_flags |= PF_R;
1011 if (entry->protection & VM_PROT_WRITE)
1012 phdr->p_flags |= PF_W;
1013 if (entry->protection & VM_PROT_EXECUTE)
1014 phdr->p_flags |= PF_X;
1016 phc->offset += phdr->p_filesz;
1022 * A callback for each_writable_segment() to gather information about
1023 * the number of segments and their total size.
1026 cb_size_segment(vm_map_entry_t entry, void *closure)
1028 struct sseg_closure *ssc = closure;
1031 ssc->vsize += entry->end - entry->start;
1036 * A callback for each_segment() to gather information about
1037 * the number of text segments.
1040 cb_fpcount_segment(vm_map_entry_t entry, void *closure)
1042 int *count = closure;
1045 if (entry->object.vm_object->type == OBJT_VNODE) {
1046 vp = (struct vnode *)entry->object.vm_object->handle;
1047 if ((vp->v_flag & VCKPT) && curproc->p_textvp == vp)
1055 cb_put_fp(vm_map_entry_t entry, void *closure)
1057 struct fp_closure *fpc = closure;
1058 struct vn_hdr *vnh = fpc->vnh;
1059 Elf_Phdr *phdr = &vnh->vnh_phdr;
1064 * If an entry represents a vnode then write out a file handle.
1066 * If we are checkpointing a checkpoint-restored program we do
1067 * NOT record the filehandle for the old checkpoint vnode (which
1068 * is mapped all over the place). Instead we rely on the fact
1069 * that a checkpoint-restored program does not mmap() the checkpt
1070 * vnode NOCORE, so its contents will be written out to the
1071 * new checkpoint file. This is necessary because the 'old'
1072 * checkpoint file is typically destroyed when a new one is created
1073 * and thus cannot be used to restore the new checkpoint.
1075 * Theoretically we could create a chain of checkpoint files and
1076 * operate the checkpointing operation kinda like an incremental
1077 * checkpoint, but a checkpoint restore would then likely wind up
1078 * referencing many prior checkpoint files and that is a bit over
1079 * the top for the purpose of the checkpoint API.
1081 if (entry->object.vm_object->type == OBJT_VNODE) {
1082 vp = (struct vnode *)entry->object.vm_object->handle;
1083 if ((vp->v_flag & VCKPT) && curproc->p_textvp == vp)
1085 if (vnh == fpc->vnh_max)
1089 vnh->vnh_fh.fh_fsid = vp->v_mount->mnt_stat.f_fsid;
1090 error = VFS_VPTOFH(vp, &vnh->vnh_fh.fh_fid);
1092 char *freepath, *fullpath;
1094 if (vn_fullpath(curproc, vp, &fullpath, &freepath)) {
1095 printf("Warning: coredump, error %d: cannot store file handle for vnode %p\n", error, vp);
1097 printf("Warning: coredump, error %d: cannot store file handle for %s\n", error, fullpath);
1098 free(freepath, M_TEMP);
1103 phdr->p_type = PT_LOAD;
1104 phdr->p_offset = 0; /* not written to core */
1105 phdr->p_vaddr = entry->start;
1107 phdr->p_filesz = phdr->p_memsz = entry->end - entry->start;
1108 phdr->p_align = PAGE_SIZE;
1110 if (entry->protection & VM_PROT_READ)
1111 phdr->p_flags |= PF_R;
1112 if (entry->protection & VM_PROT_WRITE)
1113 phdr->p_flags |= PF_W;
1114 if (entry->protection & VM_PROT_EXECUTE)
1115 phdr->p_flags |= PF_X;
1123 * For each writable segment in the process's memory map, call the given
1124 * function with a pointer to the map entry and some arbitrary
1125 * caller-supplied data.
1128 each_segment(struct proc *p, segment_callback func, void *closure, int writable)
1131 vm_map_t map = &p->p_vmspace->vm_map;
1132 vm_map_entry_t entry;
1134 for (entry = map->header.next; error == 0 && entry != &map->header;
1135 entry = entry->next) {
1139 * Don't dump inaccessible mappings, deal with legacy
1142 * Note that read-only segments related to the elf binary
1143 * are marked MAP_ENTRY_NOCOREDUMP now so we no longer
1144 * need to arbitrarily ignore such segments.
1146 if (elf_legacy_coredump) {
1147 if (writable && (entry->protection & VM_PROT_RW) != VM_PROT_RW)
1150 if (writable && (entry->protection & VM_PROT_ALL) == 0)
1155 * Dont include memory segment in the coredump if
1156 * MAP_NOCORE is set in mmap(2) or MADV_NOCORE in
1157 * madvise(2). Do not dump submaps (i.e. parts of the
1160 if (writable && entry->eflags & (MAP_ENTRY_NOCOREDUMP|MAP_ENTRY_IS_SUB_MAP))
1163 if ((obj = entry->object.vm_object) == NULL)
1166 /* Find the deepest backing object. */
1167 while (obj->backing_object != NULL)
1168 obj = obj->backing_object;
1170 /* Ignore memory-mapped devices and such things. */
1171 if (obj->type != OBJT_DEFAULT &&
1172 obj->type != OBJT_SWAP &&
1173 obj->type != OBJT_VNODE)
1176 error = (*func)(entry, closure);
1183 target_reserve(elf_buf_t target, size_t bytes, int *error)
1188 if (target->off + bytes > target->off_max)
1191 res = target->buf + target->off;
1193 target->off += bytes;
1198 * Write the core file header to the file, including padding up to
1199 * the page boundary.
1202 elf_corehdr(struct proc *p, struct file *fp, struct ucred *cred, int numsegs,
1207 prfpregset_t fpregset;
1212 prfpregset_t *fpregset;
1215 tempdata = malloc(sizeof(*tempdata), M_TEMP, M_ZERO | M_WAITOK);
1216 status = &tempdata->status;
1217 fpregset = &tempdata->fpregset;
1218 psinfo = &tempdata->psinfo;
1220 /* Gather the information for the header. */
1221 status->pr_version = PRSTATUS_VERSION;
1222 status->pr_statussz = sizeof(prstatus_t);
1223 status->pr_gregsetsz = sizeof(gregset_t);
1224 status->pr_fpregsetsz = sizeof(fpregset_t);
1225 status->pr_osreldate = osreldate;
1226 status->pr_cursig = p->p_sig;
1227 status->pr_pid = p->p_pid;
1228 fill_regs(p, &status->pr_reg);
1230 fill_fpregs(p, fpregset);
1232 psinfo->pr_version = PRPSINFO_VERSION;
1233 psinfo->pr_psinfosz = sizeof(prpsinfo_t);
1234 strncpy(psinfo->pr_fname, p->p_comm, sizeof(psinfo->pr_fname) - 1);
1236 /* XXX - We don't fill in the command line arguments properly yet. */
1237 strncpy(psinfo->pr_psargs, p->p_comm, PRARGSZ);
1239 /* Fill in the header. */
1240 error = elf_puthdr(p, target, status, fpregset, psinfo, numsegs);
1242 free(tempdata, M_TEMP);
1244 /* Write it to the core file. */
1246 error = fp_write(fp, target->buf, target->off, &nbytes);
1251 elf_puthdr(struct proc *p, elf_buf_t target, const prstatus_t *status,
1252 const prfpregset_t *fpregset, const prpsinfo_t *psinfo, int numsegs)
1261 ehdr = target_reserve(target, sizeof(Elf_Ehdr), &error);
1263 phoff = target->off;
1264 phdr = target_reserve(target, (numsegs + 1) * sizeof(Elf_Phdr), &error);
1266 noteoff = target->off;
1268 error = elf_putnote(target, "FreeBSD", NT_PRSTATUS,
1269 status, sizeof *status);
1272 error = elf_putnote(target, "FreeBSD", NT_FPREGSET,
1273 fpregset, sizeof *fpregset);
1276 error = elf_putnote(target, "FreeBSD", NT_PRPSINFO,
1277 psinfo, sizeof *psinfo);
1279 notesz = target->off - noteoff;
1282 * put extra cruft for dumping process state here
1283 * - we really want it be before all the program
1285 * - we just need to update the offset accordingly
1286 * and GDB will be none the wiser.
1289 error = elf_puttextvp(p, target);
1291 error = elf_putsigs(p, target);
1293 error = elf_putfiles(p, target);
1296 * Align up to a page boundary for the program segments. The
1297 * actual data will be written to the outptu file, not to elf_buf_t,
1298 * so we do not have to do any further bounds checking.
1300 target->off = round_page(target->off);
1301 if (error == 0 && ehdr != NULL) {
1303 * Fill in the ELF header.
1305 ehdr->e_ident[EI_MAG0] = ELFMAG0;
1306 ehdr->e_ident[EI_MAG1] = ELFMAG1;
1307 ehdr->e_ident[EI_MAG2] = ELFMAG2;
1308 ehdr->e_ident[EI_MAG3] = ELFMAG3;
1309 ehdr->e_ident[EI_CLASS] = ELF_CLASS;
1310 ehdr->e_ident[EI_DATA] = ELF_DATA;
1311 ehdr->e_ident[EI_VERSION] = EV_CURRENT;
1312 ehdr->e_ident[EI_OSABI] = ELFOSABI_FREEBSD;
1313 ehdr->e_ident[EI_ABIVERSION] = 0;
1314 ehdr->e_ident[EI_PAD] = 0;
1315 ehdr->e_type = ET_CORE;
1316 ehdr->e_machine = ELF_ARCH;
1317 ehdr->e_version = EV_CURRENT;
1319 ehdr->e_phoff = phoff;
1321 ehdr->e_ehsize = sizeof(Elf_Ehdr);
1322 ehdr->e_phentsize = sizeof(Elf_Phdr);
1323 ehdr->e_phnum = numsegs + 1;
1324 ehdr->e_shentsize = sizeof(Elf_Shdr);
1326 ehdr->e_shstrndx = SHN_UNDEF;
1328 if (error == 0 && phdr != NULL) {
1330 * Fill in the program header entries.
1332 struct phdr_closure phc;
1334 /* The note segement. */
1335 phdr->p_type = PT_NOTE;
1336 phdr->p_offset = noteoff;
1339 phdr->p_filesz = notesz;
1345 /* All the writable segments from the program. */
1347 phc.phdr_max = phdr + numsegs;
1348 phc.offset = target->off;
1349 each_segment(p, cb_put_phdr, &phc, 1);
1355 elf_putnote(elf_buf_t target, const char *name, int type,
1356 const void *desc, size_t descsz)
1362 note.n_namesz = strlen(name) + 1;
1363 note.n_descsz = descsz;
1365 dst = target_reserve(target, sizeof(note), &error);
1367 bcopy(¬e, dst, sizeof note);
1368 dst = target_reserve(target, note.n_namesz, &error);
1370 bcopy(name, dst, note.n_namesz);
1371 target->off = roundup2(target->off, sizeof(Elf_Size));
1372 dst = target_reserve(target, note.n_descsz, &error);
1374 bcopy(desc, dst, note.n_descsz);
1375 target->off = roundup2(target->off, sizeof(Elf_Size));
1381 elf_putsigs(struct proc *p, elf_buf_t target)
1384 struct ckpt_siginfo *csi;
1386 csi = target_reserve(target, sizeof(struct ckpt_siginfo), &error);
1388 csi->csi_ckptpisz = sizeof(struct ckpt_siginfo);
1389 bcopy(p->p_procsig, &csi->csi_procsig, sizeof(struct procsig));
1390 bcopy(p->p_procsig->ps_sigacts, &csi->csi_sigacts, sizeof(struct sigacts));
1391 bcopy(&p->p_realtimer, &csi->csi_itimerval, sizeof(struct itimerval));
1392 bcopy(&p->p_sigmask, &csi->csi_sigmask, sizeof(sigset_t));
1393 csi->csi_sigparent = p->p_sigparent;
1399 elf_putfiles(struct proc *p, elf_buf_t target)
1403 struct ckpt_filehdr *cfh = NULL;
1404 struct ckpt_fileinfo *cfi;
1408 * the duplicated loop is gross, but it was the only way
1409 * to eliminate uninitialized variable warnings
1411 cfh = target_reserve(target, sizeof(struct ckpt_filehdr), &error);
1413 cfh->cfh_nfiles = 0;
1417 * ignore STDIN/STDERR/STDOUT.
1419 for (i = 3; error == 0 && i < p->p_fd->fd_nfiles; i++) {
1420 if ((fp = p->p_fd->fd_files[i].fp) == NULL)
1423 * XXX Only checkpoint vnodes for now.
1425 if (fp->f_type != DTYPE_VNODE)
1427 cfi = target_reserve(target, sizeof(struct ckpt_fileinfo),
1431 cfi->cfi_index = -1;
1432 cfi->cfi_type = fp->f_type;
1433 cfi->cfi_flags = fp->f_flag;
1434 cfi->cfi_offset = fp->f_offset;
1435 /* f_count and f_msgcount should not be saved/restored */
1436 /* XXX save cred info */
1438 switch(fp->f_type) {
1440 vp = (struct vnode *)fp->f_data;
1442 * it looks like a bug in ptrace is marking
1443 * a non-vnode as a vnode - until we find the
1444 * root cause this will at least prevent
1445 * further panics from truss
1447 if (vp == NULL || vp->v_mount == NULL)
1451 cfi->cfi_fh.fh_fsid = vp->v_mount->mnt_stat.f_fsid;
1452 error = VFS_VPTOFH(vp, &cfi->cfi_fh.fh_fid);
1462 elf_puttextvp(struct proc *p, elf_buf_t target)
1466 struct fp_closure fpc;
1467 struct ckpt_vminfo *vminfo;
1469 vminfo = target_reserve(target, sizeof(struct ckpt_vminfo), &error);
1470 if (vminfo != NULL) {
1471 vminfo->cvm_dsize = p->p_vmspace->vm_dsize;
1472 vminfo->cvm_tsize = p->p_vmspace->vm_tsize;
1473 vminfo->cvm_daddr = p->p_vmspace->vm_daddr;
1474 vminfo->cvm_taddr = p->p_vmspace->vm_taddr;
1478 vn_count = target_reserve(target, sizeof(int), &error);
1479 if (target->buf != NULL) {
1480 fpc.vnh = (struct vn_hdr *)(target->buf + target->off);
1481 fpc.vnh_max = fpc.vnh +
1482 (target->off_max - target->off) / sizeof(struct vn_hdr);
1483 error = each_segment(p, cb_put_fp, &fpc, 0);
1485 *vn_count = fpc.count;
1487 error = each_segment(p, cb_fpcount_segment, &fpc.count, 0);
1489 target->off += fpc.count * sizeof(struct vn_hdr);
1495 * Tell kern_execve.c about it, with a little help from the linker.
1497 static struct execsw elf_execsw = {exec_elf_imgact, "ELF"};
1498 EXEC_SET_ORDERED(elf, elf_execsw, SI_ORDER_FIRST);