2 * Copyright (c) 1994, Sean Eric Fagan
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by Sean Eric Fagan.
16 * 4. The name of the author may not be used to endorse or promote products
17 * derived from this software without specific prior written permission.
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 #include <sys/cdefs.h>
33 __FBSDID("$FreeBSD$");
35 #include "opt_compat.h"
37 #include <sys/param.h>
38 #include <sys/systm.h>
40 #include <sys/mutex.h>
41 #include <sys/syscallsubr.h>
42 #include <sys/sysent.h>
43 #include <sys/sysproto.h>
46 #include <sys/vnode.h>
47 #include <sys/ptrace.h>
48 #include <sys/rwlock.h>
50 #include <sys/malloc.h>
51 #include <sys/signalvar.h>
53 #include <machine/reg.h>
55 #include <security/audit/audit.h>
59 #include <vm/vm_extern.h>
60 #include <vm/vm_map.h>
61 #include <vm/vm_kern.h>
62 #include <vm/vm_object.h>
63 #include <vm/vm_page.h>
64 #include <vm/vm_param.h>
66 #ifdef COMPAT_FREEBSD32
67 #include <sys/procfs.h>
68 #include <compat/freebsd32/freebsd32_signal.h>
70 struct ptrace_io_desc32 {
77 struct ptrace_vm_entry32 {
90 struct ptrace_lwpinfo32 {
91 lwpid_t pl_lwpid; /* LWP described. */
92 int pl_event; /* Event that stopped the LWP. */
93 int pl_flags; /* LWP flags. */
94 sigset_t pl_sigmask; /* LWP signal mask */
95 sigset_t pl_siglist; /* LWP pending signal */
96 struct siginfo32 pl_siginfo; /* siginfo for signal */
97 char pl_tdname[MAXCOMLEN + 1]; /* LWP name. */
98 pid_t pl_child_pid; /* New child pid */
99 u_int pl_syscall_code;
100 u_int pl_syscall_narg;
106 * Functions implemented using PROC_ACTION():
108 * proc_read_regs(proc, regs)
109 * Get the current user-visible register set from the process
110 * and copy it into the regs structure (<machine/reg.h>).
111 * The process is stopped at the time read_regs is called.
113 * proc_write_regs(proc, regs)
114 * Update the current register set from the passed in regs
115 * structure. Take care to avoid clobbering special CPU
116 * registers or privileged bits in the PSL.
117 * Depending on the architecture this may have fix-up work to do,
118 * especially if the IAR or PCW are modified.
119 * The process is stopped at the time write_regs is called.
121 * proc_read_fpregs, proc_write_fpregs
122 * deal with the floating point register set, otherwise as above.
124 * proc_read_dbregs, proc_write_dbregs
125 * deal with the processor debug register set, otherwise as above.
128 * Arrange for the process to trap after executing a single instruction.
131 #define PROC_ACTION(action) do { \
134 PROC_LOCK_ASSERT(td->td_proc, MA_OWNED); \
135 if ((td->td_proc->p_flag & P_INMEM) == 0) \
143 proc_read_regs(struct thread *td, struct reg *regs)
146 PROC_ACTION(fill_regs(td, regs));
150 proc_write_regs(struct thread *td, struct reg *regs)
153 PROC_ACTION(set_regs(td, regs));
157 proc_read_dbregs(struct thread *td, struct dbreg *dbregs)
160 PROC_ACTION(fill_dbregs(td, dbregs));
164 proc_write_dbregs(struct thread *td, struct dbreg *dbregs)
167 PROC_ACTION(set_dbregs(td, dbregs));
171 * Ptrace doesn't support fpregs at all, and there are no security holes
172 * or translations for fpregs, so we can just copy them.
175 proc_read_fpregs(struct thread *td, struct fpreg *fpregs)
178 PROC_ACTION(fill_fpregs(td, fpregs));
182 proc_write_fpregs(struct thread *td, struct fpreg *fpregs)
185 PROC_ACTION(set_fpregs(td, fpregs));
188 #ifdef COMPAT_FREEBSD32
189 /* For 32 bit binaries, we need to expose the 32 bit regs layouts. */
191 proc_read_regs32(struct thread *td, struct reg32 *regs32)
194 PROC_ACTION(fill_regs32(td, regs32));
198 proc_write_regs32(struct thread *td, struct reg32 *regs32)
201 PROC_ACTION(set_regs32(td, regs32));
205 proc_read_dbregs32(struct thread *td, struct dbreg32 *dbregs32)
208 PROC_ACTION(fill_dbregs32(td, dbregs32));
212 proc_write_dbregs32(struct thread *td, struct dbreg32 *dbregs32)
215 PROC_ACTION(set_dbregs32(td, dbregs32));
219 proc_read_fpregs32(struct thread *td, struct fpreg32 *fpregs32)
222 PROC_ACTION(fill_fpregs32(td, fpregs32));
226 proc_write_fpregs32(struct thread *td, struct fpreg32 *fpregs32)
229 PROC_ACTION(set_fpregs32(td, fpregs32));
234 proc_sstep(struct thread *td)
237 PROC_ACTION(ptrace_single_step(td));
241 proc_rwmem(struct proc *p, struct uio *uio)
244 vm_offset_t pageno; /* page number */
246 int error, fault_flags, page_offset, writing;
249 * Assert that someone has locked this vmspace. (Should be
250 * curthread but we can't assert that.) This keeps the process
251 * from exiting out from under us until this operation completes.
253 KASSERT(p->p_lock >= 1, ("%s: process %p (pid %d) not held", __func__,
259 map = &p->p_vmspace->vm_map;
262 * If we are writing, then we request vm_fault() to create a private
263 * copy of each page. Since these copies will not be writeable by the
264 * process, we must explicity request that they be dirtied.
266 writing = uio->uio_rw == UIO_WRITE;
267 reqprot = writing ? VM_PROT_COPY | VM_PROT_READ : VM_PROT_READ;
268 fault_flags = writing ? VM_FAULT_DIRTY : VM_FAULT_NORMAL;
271 * Only map in one page at a time. We don't have to, but it
272 * makes things easier. This way is trivial - right?
279 uva = (vm_offset_t)uio->uio_offset;
282 * Get the page number of this segment.
284 pageno = trunc_page(uva);
285 page_offset = uva - pageno;
288 * How many bytes to copy
290 len = min(PAGE_SIZE - page_offset, uio->uio_resid);
293 * Fault and hold the page on behalf of the process.
295 error = vm_fault_hold(map, pageno, reqprot, fault_flags, &m);
296 if (error != KERN_SUCCESS) {
297 if (error == KERN_RESOURCE_SHORTAGE)
305 * Now do the i/o move.
307 error = uiomove_fromphys(&m, page_offset, len, uio);
309 /* Make the I-cache coherent for breakpoints. */
310 if (writing && error == 0) {
311 vm_map_lock_read(map);
312 if (vm_map_check_protection(map, pageno, pageno +
313 PAGE_SIZE, VM_PROT_EXECUTE))
314 vm_sync_icache(map, uva, len);
315 vm_map_unlock_read(map);
325 } while (error == 0 && uio->uio_resid > 0);
331 ptrace_vm_entry(struct thread *td, struct proc *p, struct ptrace_vm_entry *pve)
335 vm_map_entry_t entry;
336 vm_object_t obj, tobj, lobj;
339 char *freepath, *fullpath;
346 vm = vmspace_acquire_ref(p);
348 vm_map_lock_read(map);
351 entry = map->header.next;
353 while (index < pve->pve_entry && entry != &map->header) {
357 if (index != pve->pve_entry) {
361 while (entry != &map->header &&
362 (entry->eflags & MAP_ENTRY_IS_SUB_MAP) != 0) {
366 if (entry == &map->header) {
371 /* We got an entry. */
372 pve->pve_entry = index + 1;
373 pve->pve_timestamp = map->timestamp;
374 pve->pve_start = entry->start;
375 pve->pve_end = entry->end - 1;
376 pve->pve_offset = entry->offset;
377 pve->pve_prot = entry->protection;
379 /* Backing object's path needed? */
380 if (pve->pve_pathlen == 0)
383 pathlen = pve->pve_pathlen;
384 pve->pve_pathlen = 0;
386 obj = entry->object.vm_object;
388 VM_OBJECT_RLOCK(obj);
391 vm_map_unlock_read(map);
393 pve->pve_fsid = VNOVAL;
394 pve->pve_fileid = VNOVAL;
396 if (error == 0 && obj != NULL) {
398 for (tobj = obj; tobj != NULL; tobj = tobj->backing_object) {
400 VM_OBJECT_RLOCK(tobj);
402 VM_OBJECT_RUNLOCK(lobj);
404 pve->pve_offset += tobj->backing_object_offset;
406 vp = vm_object_vnode(lobj);
410 VM_OBJECT_RUNLOCK(lobj);
411 VM_OBJECT_RUNLOCK(obj);
416 vn_fullpath(td, vp, &fullpath, &freepath);
417 vn_lock(vp, LK_SHARED | LK_RETRY);
418 if (VOP_GETATTR(vp, &vattr, td->td_ucred) == 0) {
419 pve->pve_fileid = vattr.va_fileid;
420 pve->pve_fsid = vattr.va_fsid;
424 if (fullpath != NULL) {
425 pve->pve_pathlen = strlen(fullpath) + 1;
426 if (pve->pve_pathlen <= pathlen) {
427 error = copyout(fullpath, pve->pve_path,
430 error = ENAMETOOLONG;
432 if (freepath != NULL)
433 free(freepath, M_TEMP);
438 CTR3(KTR_PTRACE, "PT_VM_ENTRY: pid %d, entry %d, start %p",
439 p->p_pid, pve->pve_entry, pve->pve_start);
444 #ifdef COMPAT_FREEBSD32
446 ptrace_vm_entry32(struct thread *td, struct proc *p,
447 struct ptrace_vm_entry32 *pve32)
449 struct ptrace_vm_entry pve;
452 pve.pve_entry = pve32->pve_entry;
453 pve.pve_pathlen = pve32->pve_pathlen;
454 pve.pve_path = (void *)(uintptr_t)pve32->pve_path;
456 error = ptrace_vm_entry(td, p, &pve);
458 pve32->pve_entry = pve.pve_entry;
459 pve32->pve_timestamp = pve.pve_timestamp;
460 pve32->pve_start = pve.pve_start;
461 pve32->pve_end = pve.pve_end;
462 pve32->pve_offset = pve.pve_offset;
463 pve32->pve_prot = pve.pve_prot;
464 pve32->pve_fileid = pve.pve_fileid;
465 pve32->pve_fsid = pve.pve_fsid;
468 pve32->pve_pathlen = pve.pve_pathlen;
473 ptrace_lwpinfo_to32(const struct ptrace_lwpinfo *pl,
474 struct ptrace_lwpinfo32 *pl32)
477 bzero(pl32, sizeof(*pl32));
478 pl32->pl_lwpid = pl->pl_lwpid;
479 pl32->pl_event = pl->pl_event;
480 pl32->pl_flags = pl->pl_flags;
481 pl32->pl_sigmask = pl->pl_sigmask;
482 pl32->pl_siglist = pl->pl_siglist;
483 siginfo_to_siginfo32(&pl->pl_siginfo, &pl32->pl_siginfo);
484 strcpy(pl32->pl_tdname, pl->pl_tdname);
485 pl32->pl_child_pid = pl->pl_child_pid;
486 pl32->pl_syscall_code = pl->pl_syscall_code;
487 pl32->pl_syscall_narg = pl->pl_syscall_narg;
489 #endif /* COMPAT_FREEBSD32 */
492 * Process debugging system call.
494 #ifndef _SYS_SYSPROTO_H_
503 #ifdef COMPAT_FREEBSD32
505 * This CPP subterfuge is to try and reduce the number of ifdefs in
506 * the body of the code.
507 * COPYIN(uap->addr, &r.reg, sizeof r.reg);
509 * copyin(uap->addr, &r.reg, sizeof r.reg);
511 * copyin(uap->addr, &r.reg32, sizeof r.reg32);
512 * .. except this is done at runtime.
514 #define COPYIN(u, k, s) wrap32 ? \
515 copyin(u, k ## 32, s ## 32) : \
517 #define COPYOUT(k, u, s) wrap32 ? \
518 copyout(k ## 32, u, s ## 32) : \
521 #define COPYIN(u, k, s) copyin(u, k, s)
522 #define COPYOUT(k, u, s) copyout(k, u, s)
525 sys_ptrace(struct thread *td, struct ptrace_args *uap)
528 * XXX this obfuscation is to reduce stack usage, but the register
529 * structs may be too large to put on the stack anyway.
532 struct ptrace_io_desc piod;
533 struct ptrace_lwpinfo pl;
534 struct ptrace_vm_entry pve;
538 #ifdef COMPAT_FREEBSD32
539 struct dbreg32 dbreg32;
540 struct fpreg32 fpreg32;
542 struct ptrace_io_desc32 piod32;
543 struct ptrace_lwpinfo32 pl32;
544 struct ptrace_vm_entry32 pve32;
550 #ifdef COMPAT_FREEBSD32
553 if (SV_CURPROC_FLAG(SV_ILP32))
556 AUDIT_ARG_PID(uap->pid);
557 AUDIT_ARG_CMD(uap->req);
558 AUDIT_ARG_VALUE(uap->data);
561 case PT_GET_EVENT_MASK:
568 error = COPYIN(uap->addr, &r.reg, sizeof r.reg);
571 error = COPYIN(uap->addr, &r.fpreg, sizeof r.fpreg);
574 error = COPYIN(uap->addr, &r.dbreg, sizeof r.dbreg);
576 case PT_SET_EVENT_MASK:
577 if (uap->data != sizeof(r.ptevents))
580 error = copyin(uap->addr, &r.ptevents, uap->data);
583 error = COPYIN(uap->addr, &r.piod, sizeof r.piod);
586 error = COPYIN(uap->addr, &r.pve, sizeof r.pve);
595 error = kern_ptrace(td, uap->req, uap->pid, addr, uap->data);
601 error = COPYOUT(&r.pve, uap->addr, sizeof r.pve);
604 error = COPYOUT(&r.piod, uap->addr, sizeof r.piod);
607 error = COPYOUT(&r.reg, uap->addr, sizeof r.reg);
610 error = COPYOUT(&r.fpreg, uap->addr, sizeof r.fpreg);
613 error = COPYOUT(&r.dbreg, uap->addr, sizeof r.dbreg);
615 case PT_GET_EVENT_MASK:
616 /* NB: The size in uap->data is validated in kern_ptrace(). */
617 error = copyout(&r.ptevents, uap->addr, uap->data);
620 /* NB: The size in uap->data is validated in kern_ptrace(). */
621 error = copyout(&r.pl, uap->addr, uap->data);
630 #ifdef COMPAT_FREEBSD32
632 * PROC_READ(regs, td2, addr);
634 * proc_read_regs(td2, addr);
636 * proc_read_regs32(td2, addr);
637 * .. except this is done at runtime. There is an additional
638 * complication in that PROC_WRITE disallows 32 bit consumers
639 * from writing to 64 bit address space targets.
641 #define PROC_READ(w, t, a) wrap32 ? \
642 proc_read_ ## w ## 32(t, a) : \
643 proc_read_ ## w (t, a)
644 #define PROC_WRITE(w, t, a) wrap32 ? \
645 (safe ? proc_write_ ## w ## 32(t, a) : EINVAL ) : \
646 proc_write_ ## w (t, a)
648 #define PROC_READ(w, t, a) proc_read_ ## w (t, a)
649 #define PROC_WRITE(w, t, a) proc_write_ ## w (t, a)
653 proc_set_traced(struct proc *p, bool stop)
656 PROC_LOCK_ASSERT(p, MA_OWNED);
657 p->p_flag |= P_TRACED;
659 p->p_flag2 |= P2_PTRACE_FSTP;
660 p->p_ptevents = PTRACE_DEFAULT;
661 p->p_oppid = p->p_pptr->p_pid;
665 kern_ptrace(struct thread *td, int req, pid_t pid, void *addr, int data)
669 struct proc *curp, *p, *pp;
670 struct thread *td2 = NULL, *td3;
671 struct ptrace_io_desc *piod = NULL;
672 struct ptrace_lwpinfo *pl;
673 int error, write, tmp, num;
674 int proctree_locked = 0;
675 lwpid_t tid = 0, *buf;
676 #ifdef COMPAT_FREEBSD32
677 int wrap32 = 0, safe = 0;
678 struct ptrace_io_desc32 *piod32 = NULL;
679 struct ptrace_lwpinfo32 *pl32 = NULL;
680 struct ptrace_lwpinfo plr;
685 /* Lock proctree before locking the process. */
696 case PT_GET_EVENT_MASK:
697 case PT_SET_EVENT_MASK:
699 sx_xlock(&proctree_lock);
707 if (req == PT_TRACE_ME) {
711 if (pid <= PID_MAX) {
712 if ((p = pfind(pid)) == NULL) {
714 sx_xunlock(&proctree_lock);
718 td2 = tdfind(pid, -1);
721 sx_xunlock(&proctree_lock);
729 AUDIT_ARG_PROCESS(p);
731 if ((p->p_flag & P_WEXIT) != 0) {
735 if ((error = p_cansee(td, p)) != 0)
738 if ((error = p_candebug(td, p)) != 0)
742 * System processes can't be debugged.
744 if ((p->p_flag & P_SYSTEM) != 0) {
750 if ((p->p_flag & P_STOPPED_TRACE) != 0) {
751 KASSERT(p->p_xthread != NULL, ("NULL p_xthread"));
754 td2 = FIRST_THREAD_IN_PROC(p);
759 #ifdef COMPAT_FREEBSD32
761 * Test if we're a 32 bit client and what the target is.
762 * Set the wrap controls accordingly.
764 if (SV_CURPROC_FLAG(SV_ILP32)) {
765 if (SV_PROC_FLAG(td2->td_proc, SV_ILP32))
776 * Always legal, when there is a parent process which
777 * could trace us. Otherwise, reject.
779 if ((p->p_flag & P_TRACED) != 0) {
783 if (p->p_pptr == initproc) {
791 if (p == td->td_proc) {
797 if (p->p_flag & P_TRACED) {
802 /* Can't trace an ancestor if you're being traced. */
803 if (curp->p_flag & P_TRACED) {
804 for (pp = curp->p_pptr; pp != NULL; pp = pp->p_pptr) {
817 /* Allow thread to clear single step for itself */
818 if (td->td_tid == tid)
823 /* not being traced... */
824 if ((p->p_flag & P_TRACED) == 0) {
829 /* not being traced by YOU */
830 if (p->p_pptr != td->td_proc) {
835 /* not currently stopped */
836 if ((p->p_flag & (P_STOPPED_SIG | P_STOPPED_TRACE)) == 0 ||
837 p->p_suspcount != p->p_numthreads ||
838 (p->p_flag & P_WAITED) == 0) {
843 if ((p->p_flag & P_STOPPED_TRACE) == 0) {
844 static int count = 0;
846 printf("P_STOPPED_TRACE not set.\n");
853 /* Keep this process around until we finish this request. */
858 * Single step fixup ala procfs
864 * Actually do the requests
867 td->td_retval[0] = 0;
871 /* set my trace flag and "owner" so it can read/write me */
872 proc_set_traced(p, false);
873 if (p->p_flag & P_PPWAIT)
874 p->p_flag |= P_PPTRACE;
875 CTR1(KTR_PTRACE, "PT_TRACE_ME: pid %d", p->p_pid);
879 /* security check done above */
881 * It would be nice if the tracing relationship was separate
882 * from the parent relationship but that would require
883 * another set of links in the proc struct or for "wait"
884 * to scan the entire proc table. To make life easier,
885 * we just re-parent the process we're trying to trace.
886 * The old parent is remembered so we can put things back
889 proc_set_traced(p, true);
890 if (p->p_pptr != td->td_proc) {
891 proc_reparent(p, td->td_proc);
894 CTR2(KTR_PTRACE, "PT_ATTACH: pid %d, oppid %d", p->p_pid,
896 goto sendsig; /* in PT_CONTINUE below */
899 CTR2(KTR_PTRACE, "PT_CLEARSTEP: tid %d (pid %d)", td2->td_tid,
901 error = ptrace_clear_single_step(td2);
905 CTR2(KTR_PTRACE, "PT_SETSTEP: tid %d (pid %d)", td2->td_tid,
907 error = ptrace_single_step(td2);
911 CTR2(KTR_PTRACE, "PT_SUSPEND: tid %d (pid %d)", td2->td_tid,
913 td2->td_dbgflags |= TDB_SUSPEND;
915 td2->td_flags |= TDF_NEEDSUSPCHK;
920 CTR2(KTR_PTRACE, "PT_RESUME: tid %d (pid %d)", td2->td_tid,
922 td2->td_dbgflags &= ~TDB_SUSPEND;
926 CTR3(KTR_PTRACE, "PT_FOLLOW_FORK: pid %d %s -> %s", p->p_pid,
927 p->p_ptevents & PTRACE_FORK ? "enabled" : "disabled",
928 data ? "enabled" : "disabled");
930 p->p_ptevents |= PTRACE_FORK;
932 p->p_ptevents &= ~PTRACE_FORK;
936 CTR3(KTR_PTRACE, "PT_LWP_EVENTS: pid %d %s -> %s", p->p_pid,
937 p->p_ptevents & PTRACE_LWP ? "enabled" : "disabled",
938 data ? "enabled" : "disabled");
940 p->p_ptevents |= PTRACE_LWP;
942 p->p_ptevents &= ~PTRACE_LWP;
945 case PT_GET_EVENT_MASK:
946 if (data != sizeof(p->p_ptevents)) {
950 CTR2(KTR_PTRACE, "PT_GET_EVENT_MASK: pid %d mask %#x", p->p_pid,
952 *(int *)addr = p->p_ptevents;
955 case PT_SET_EVENT_MASK:
956 if (data != sizeof(p->p_ptevents)) {
961 if ((tmp & ~(PTRACE_EXEC | PTRACE_SCE | PTRACE_SCX |
962 PTRACE_FORK | PTRACE_LWP | PTRACE_VFORK)) != 0) {
966 CTR3(KTR_PTRACE, "PT_SET_EVENT_MASK: pid %d mask %#x -> %#x",
967 p->p_pid, p->p_ptevents, tmp);
977 /* Zero means do not send any signal */
978 if (data < 0 || data > _SIG_MAXSIG) {
985 CTR3(KTR_PTRACE, "PT_STEP: tid %d (pid %d), sig = %d",
986 td2->td_tid, p->p_pid, data);
987 error = ptrace_single_step(td2);
995 if (addr != (void *)1) {
996 error = ptrace_set_pc(td2,
997 (u_long)(uintfptr_t)addr);
1003 p->p_ptevents |= PTRACE_SCE;
1005 "PT_TO_SCE: pid %d, events = %#x, PC = %#lx, sig = %d",
1006 p->p_pid, p->p_ptevents,
1007 (u_long)(uintfptr_t)addr, data);
1010 p->p_ptevents |= PTRACE_SCX;
1012 "PT_TO_SCX: pid %d, events = %#x, PC = %#lx, sig = %d",
1013 p->p_pid, p->p_ptevents,
1014 (u_long)(uintfptr_t)addr, data);
1017 p->p_ptevents |= PTRACE_SYSCALL;
1019 "PT_SYSCALL: pid %d, events = %#x, PC = %#lx, sig = %d",
1020 p->p_pid, p->p_ptevents,
1021 (u_long)(uintfptr_t)addr, data);
1025 "PT_CONTINUE: pid %d, PC = %#lx, sig = %d",
1026 p->p_pid, (u_long)(uintfptr_t)addr, data);
1032 * Reset the process parent.
1034 * NB: This clears P_TRACED before reparenting
1035 * a detached process back to its original
1036 * parent. Otherwise the debugee will be set
1037 * as an orphan of the debugger.
1039 p->p_flag &= ~(P_TRACED | P_WAITED);
1040 if (p->p_oppid != p->p_pptr->p_pid) {
1041 PROC_LOCK(p->p_pptr);
1042 sigqueue_take(p->p_ksi);
1043 PROC_UNLOCK(p->p_pptr);
1045 pp = proc_realparent(p);
1046 proc_reparent(p, pp);
1048 p->p_sigparent = SIGCHLD;
1050 "PT_DETACH: pid %d reparented to pid %d, sig %d",
1051 p->p_pid, pp->p_pid, data);
1053 CTR2(KTR_PTRACE, "PT_DETACH: pid %d, sig %d",
1057 FOREACH_THREAD_IN_PROC(p, td3) {
1058 if ((td3->td_dbgflags & TDB_FSTP) != 0) {
1059 sigqueue_delete(&td3->td_sigqueue,
1062 td3->td_dbgflags &= ~(TDB_XSIG | TDB_FSTP);
1064 if ((p->p_flag2 & P2_PTRACE_FSTP) != 0) {
1065 sigqueue_delete(&p->p_sigqueue, SIGSTOP);
1066 p->p_flag2 &= ~P2_PTRACE_FSTP;
1069 /* should we send SIGCHLD? */
1070 /* childproc_continued(p); */
1076 * Clear the pending event for the thread that just
1077 * reported its event (p_xthread). This may not be
1078 * the thread passed to PT_CONTINUE, PT_STEP, etc. if
1079 * the debugger is resuming a different thread.
1082 if (proctree_locked) {
1083 sx_xunlock(&proctree_lock);
1084 proctree_locked = 0;
1087 p->p_xthread = NULL;
1088 if ((p->p_flag & (P_STOPPED_SIG | P_STOPPED_TRACE)) != 0) {
1089 /* deliver or queue signal */
1090 td2->td_dbgflags &= ~TDB_XSIG;
1091 td2->td_xsig = data;
1094 * P_WKILLED is insurance that a PT_KILL/SIGKILL always
1095 * works immediately, even if another thread is
1096 * unsuspended first and attempts to handle a different
1097 * signal or if the POSIX.1b style signal queue cannot
1098 * accommodate any new signals.
1100 if (data == SIGKILL)
1101 p->p_flag |= P_WKILLED;
1103 if (req == PT_DETACH) {
1104 FOREACH_THREAD_IN_PROC(p, td3)
1105 td3->td_dbgflags &= ~TDB_SUSPEND;
1108 * unsuspend all threads, to not let a thread run,
1109 * you should use PT_SUSPEND to suspend it before
1110 * continuing process.
1113 p->p_flag &= ~(P_STOPPED_TRACE|P_STOPPED_SIG|P_WAITED);
1114 thread_unsuspend(p);
1116 if (req == PT_ATTACH)
1117 kern_psignal(p, data);
1120 kern_psignal(p, data);
1126 td2->td_dbgflags |= TDB_USERWR;
1133 /* write = 0 set above */
1134 iov.iov_base = write ? (caddr_t)&data : (caddr_t)&tmp;
1135 iov.iov_len = sizeof(int);
1138 uio.uio_offset = (off_t)(uintptr_t)addr;
1139 uio.uio_resid = sizeof(int);
1140 uio.uio_segflg = UIO_SYSSPACE; /* i.e.: the uap */
1141 uio.uio_rw = write ? UIO_WRITE : UIO_READ;
1143 error = proc_rwmem(p, &uio);
1144 if (uio.uio_resid != 0) {
1146 * XXX proc_rwmem() doesn't currently return ENOSPC,
1147 * so I think write() can bogusly return 0.
1148 * XXX what happens for short writes? We don't want
1149 * to write partial data.
1150 * XXX proc_rwmem() returns EPERM for other invalid
1151 * addresses. Convert this to EINVAL. Does this
1152 * clobber returns of EPERM for other reasons?
1154 if (error == 0 || error == ENOSPC || error == EPERM)
1155 error = EINVAL; /* EOF */
1158 td->td_retval[0] = tmp;
1161 CTR3(KTR_PTRACE, "PT_WRITE: pid %d: %p <= %#x",
1162 p->p_pid, addr, data);
1164 CTR3(KTR_PTRACE, "PT_READ: pid %d: %p >= %#x",
1165 p->p_pid, addr, tmp);
1171 #ifdef COMPAT_FREEBSD32
1174 iov.iov_base = (void *)(uintptr_t)piod32->piod_addr;
1175 iov.iov_len = piod32->piod_len;
1176 uio.uio_offset = (off_t)(uintptr_t)piod32->piod_offs;
1177 uio.uio_resid = piod32->piod_len;
1182 iov.iov_base = piod->piod_addr;
1183 iov.iov_len = piod->piod_len;
1184 uio.uio_offset = (off_t)(uintptr_t)piod->piod_offs;
1185 uio.uio_resid = piod->piod_len;
1189 uio.uio_segflg = UIO_USERSPACE;
1191 #ifdef COMPAT_FREEBSD32
1192 tmp = wrap32 ? piod32->piod_op : piod->piod_op;
1194 tmp = piod->piod_op;
1199 CTR3(KTR_PTRACE, "PT_IO: pid %d: READ (%p, %#x)",
1200 p->p_pid, (uintptr_t)uio.uio_offset, uio.uio_resid);
1201 uio.uio_rw = UIO_READ;
1205 CTR3(KTR_PTRACE, "PT_IO: pid %d: WRITE (%p, %#x)",
1206 p->p_pid, (uintptr_t)uio.uio_offset, uio.uio_resid);
1207 td2->td_dbgflags |= TDB_USERWR;
1208 uio.uio_rw = UIO_WRITE;
1215 error = proc_rwmem(p, &uio);
1216 #ifdef COMPAT_FREEBSD32
1218 piod32->piod_len -= uio.uio_resid;
1221 piod->piod_len -= uio.uio_resid;
1226 CTR1(KTR_PTRACE, "PT_KILL: pid %d", p->p_pid);
1228 goto sendsig; /* in PT_CONTINUE above */
1231 CTR2(KTR_PTRACE, "PT_SETREGS: tid %d (pid %d)", td2->td_tid,
1233 td2->td_dbgflags |= TDB_USERWR;
1234 error = PROC_WRITE(regs, td2, addr);
1238 CTR2(KTR_PTRACE, "PT_GETREGS: tid %d (pid %d)", td2->td_tid,
1240 error = PROC_READ(regs, td2, addr);
1244 CTR2(KTR_PTRACE, "PT_SETFPREGS: tid %d (pid %d)", td2->td_tid,
1246 td2->td_dbgflags |= TDB_USERWR;
1247 error = PROC_WRITE(fpregs, td2, addr);
1251 CTR2(KTR_PTRACE, "PT_GETFPREGS: tid %d (pid %d)", td2->td_tid,
1253 error = PROC_READ(fpregs, td2, addr);
1257 CTR2(KTR_PTRACE, "PT_SETDBREGS: tid %d (pid %d)", td2->td_tid,
1259 td2->td_dbgflags |= TDB_USERWR;
1260 error = PROC_WRITE(dbregs, td2, addr);
1264 CTR2(KTR_PTRACE, "PT_GETDBREGS: tid %d (pid %d)", td2->td_tid,
1266 error = PROC_READ(dbregs, td2, addr);
1271 #ifdef COMPAT_FREEBSD32
1272 (!wrap32 && data > sizeof(*pl)) ||
1273 (wrap32 && data > sizeof(*pl32))) {
1275 data > sizeof(*pl)) {
1280 #ifdef COMPAT_FREEBSD32
1287 bzero(pl, sizeof(*pl));
1288 pl->pl_lwpid = td2->td_tid;
1289 pl->pl_event = PL_EVENT_NONE;
1291 if (td2->td_dbgflags & TDB_XSIG) {
1292 pl->pl_event = PL_EVENT_SIGNAL;
1293 if (td2->td_dbgksi.ksi_signo != 0 &&
1294 #ifdef COMPAT_FREEBSD32
1295 ((!wrap32 && data >= offsetof(struct ptrace_lwpinfo,
1296 pl_siginfo) + sizeof(pl->pl_siginfo)) ||
1297 (wrap32 && data >= offsetof(struct ptrace_lwpinfo32,
1298 pl_siginfo) + sizeof(struct siginfo32)))
1300 data >= offsetof(struct ptrace_lwpinfo, pl_siginfo)
1301 + sizeof(pl->pl_siginfo)
1304 pl->pl_flags |= PL_FLAG_SI;
1305 pl->pl_siginfo = td2->td_dbgksi.ksi_info;
1308 if (td2->td_dbgflags & TDB_SCE)
1309 pl->pl_flags |= PL_FLAG_SCE;
1310 else if (td2->td_dbgflags & TDB_SCX)
1311 pl->pl_flags |= PL_FLAG_SCX;
1312 if (td2->td_dbgflags & TDB_EXEC)
1313 pl->pl_flags |= PL_FLAG_EXEC;
1314 if (td2->td_dbgflags & TDB_FORK) {
1315 pl->pl_flags |= PL_FLAG_FORKED;
1316 pl->pl_child_pid = td2->td_dbg_forked;
1317 if (td2->td_dbgflags & TDB_VFORK)
1318 pl->pl_flags |= PL_FLAG_VFORKED;
1319 } else if ((td2->td_dbgflags & (TDB_SCX | TDB_VFORK)) ==
1321 pl->pl_flags |= PL_FLAG_VFORK_DONE;
1322 if (td2->td_dbgflags & TDB_CHILD)
1323 pl->pl_flags |= PL_FLAG_CHILD;
1324 if (td2->td_dbgflags & TDB_BORN)
1325 pl->pl_flags |= PL_FLAG_BORN;
1326 if (td2->td_dbgflags & TDB_EXIT)
1327 pl->pl_flags |= PL_FLAG_EXITED;
1328 pl->pl_sigmask = td2->td_sigmask;
1329 pl->pl_siglist = td2->td_siglist;
1330 strcpy(pl->pl_tdname, td2->td_name);
1331 if ((td2->td_dbgflags & (TDB_SCE | TDB_SCX)) != 0) {
1332 pl->pl_syscall_code = td2->td_dbg_sc_code;
1333 pl->pl_syscall_narg = td2->td_dbg_sc_narg;
1335 pl->pl_syscall_code = 0;
1336 pl->pl_syscall_narg = 0;
1338 #ifdef COMPAT_FREEBSD32
1340 ptrace_lwpinfo_to32(pl, pl32);
1343 "PT_LWPINFO: tid %d (pid %d) event %d flags %#x child pid %d syscall %d",
1344 td2->td_tid, p->p_pid, pl->pl_event, pl->pl_flags,
1345 pl->pl_child_pid, pl->pl_syscall_code);
1349 CTR2(KTR_PTRACE, "PT_GETNUMLWPS: pid %d: %d threads", p->p_pid,
1351 td->td_retval[0] = p->p_numthreads;
1355 CTR3(KTR_PTRACE, "PT_GETLWPLIST: pid %d: data %d, actual %d",
1356 p->p_pid, data, p->p_numthreads);
1361 num = imin(p->p_numthreads, data);
1363 buf = malloc(num * sizeof(lwpid_t), M_TEMP, M_WAITOK);
1366 FOREACH_THREAD_IN_PROC(p, td2) {
1369 buf[tmp++] = td2->td_tid;
1372 error = copyout(buf, addr, tmp * sizeof(lwpid_t));
1375 td->td_retval[0] = tmp;
1379 case PT_VM_TIMESTAMP:
1380 CTR2(KTR_PTRACE, "PT_VM_TIMESTAMP: pid %d: timestamp %d",
1381 p->p_pid, p->p_vmspace->vm_map.timestamp);
1382 td->td_retval[0] = p->p_vmspace->vm_map.timestamp;
1387 #ifdef COMPAT_FREEBSD32
1389 error = ptrace_vm_entry32(td, p, addr);
1392 error = ptrace_vm_entry(td, p, addr);
1397 #ifdef __HAVE_PTRACE_MACHDEP
1398 if (req >= PT_FIRSTMACH) {
1400 error = cpu_ptrace(td2, req, addr, data);
1404 /* Unknown request. */
1410 /* Drop our hold on this process now that the request has completed. */
1414 if (proctree_locked)
1415 sx_xunlock(&proctree_lock);
1422 * Stop a process because of a debugging event;
1423 * stay stopped until p->p_step is cleared
1424 * (cleared by PIOCCONT in procfs).
1427 stopevent(struct proc *p, unsigned int event, unsigned int val)
1430 PROC_LOCK_ASSERT(p, MA_OWNED);
1432 CTR3(KTR_PTRACE, "stopevent: pid %d event %u val %u", p->p_pid, event,
1436 p->p_xthread = NULL;
1437 p->p_stype = event; /* Which event caused the stop? */
1438 wakeup(&p->p_stype); /* Wake up any PIOCWAIT'ing procs */
1439 msleep(&p->p_step, &p->p_mtx, PWAIT, "stopevent", 0);
1440 } while (p->p_step);