xref: /freebsd/sys/ddb/db_thread.c (revision 2e3f49888ec8851bafb22011533217487764fdb0)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2004 Marcel Moolenaar
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #include <sys/param.h>
30 #include <sys/systm.h>
31 #include <sys/kdb.h>
32 #include <sys/proc.h>
33 
34 #include <machine/pcb.h>
35 
36 #include <ddb/ddb.h>
37 #include <ddb/db_command.h>
38 #include <ddb/db_sym.h>
39 
40 void
41 db_print_thread(void)
42 {
43 	pid_t pid;
44 
45 	pid = -1;
46 	if (kdb_thread->td_proc != NULL)
47 		pid = kdb_thread->td_proc->p_pid;
48 	db_printf("[ thread pid %d tid %ld ]\n", pid, (long)kdb_thread->td_tid);
49 }
50 
51 void
52 db_set_thread(db_expr_t tid, bool hastid, db_expr_t cnt, char *mod)
53 {
54 	struct thread *thr;
55 	int err;
56 
57 	if (hastid) {
58 		thr = db_lookup_thread(tid, false);
59 		if (thr != NULL) {
60 			err = kdb_thr_select(thr);
61 			if (err != 0) {
62 				db_printf("unable to switch to thread %ld\n",
63 				    (long)thr->td_tid);
64 				return;
65 			}
66 			db_dot = PC_REGS();
67 		} else {
68 			db_printf("%d: invalid thread\n", (int)tid);
69 			return;
70 		}
71 	}
72 
73 	db_print_thread();
74 	db_print_loc_and_inst(PC_REGS());
75 }
76 
77 void
78 db_show_threads(db_expr_t addr, bool hasaddr, db_expr_t cnt, char *mod)
79 {
80 	jmp_buf jb;
81 	void *prev_jb;
82 	struct thread *thr;
83 
84 	thr = kdb_thr_first();
85 	while (!db_pager_quit && thr != NULL) {
86 		db_printf("  %6ld (%p) (stack %p)  ", (long)thr->td_tid, thr,
87 		    (void *)thr->td_kstack);
88 		prev_jb = kdb_jmpbuf(jb);
89 		if (setjmp(jb) == 0) {
90 			if (thr->td_proc->p_flag & P_INMEM) {
91 				if (db_trace_thread(thr, 1) != 0)
92 					db_printf("***\n");
93 			} else
94 				db_printf("*** swapped out\n");
95 		}
96 		kdb_jmpbuf(prev_jb);
97 		thr = kdb_thr_next(thr);
98 	}
99 }
100 
101 /*
102  * Lookup a thread based on a db expression address.  We assume that the
103  * address was parsed in hexadecimal.  We reparse the address in decimal
104  * first and try to treat it as a thread ID to find an associated thread.
105  * If that fails and check_pid is true, we treat the decimal value as a
106  * PID.  If that matches a process, we return the first thread in that
107  * process.  Otherwise, we treat the addr as a pointer to a thread.
108  */
109 struct thread *
110 db_lookup_thread(db_expr_t addr, bool check_pid)
111 {
112 	struct thread *td;
113 	db_expr_t decaddr;
114 
115 	/*
116 	 * If the parsed address was not a valid decimal expression,
117 	 * assume it is a thread pointer.
118 	 */
119 	decaddr = db_hex2dec(addr);
120 	if (decaddr == -1)
121 		return ((struct thread *)addr);
122 
123 	td = kdb_thr_lookup(decaddr);
124 	if (td != NULL)
125 		return (td);
126 	if (check_pid) {
127 		td = kdb_thr_from_pid(decaddr);
128 		if (td != NULL)
129 			return (td);
130 	}
131 	return ((struct thread *)addr);
132 }
133 
134 /*
135  * Lookup a process based on a db expression address.  We assume that the
136  * address was parsed in hexadecimal.  We reparse the address in decimal
137  * first and try to treat it as a PID to find an associated process.
138  * If that fails we treat the addr as a pointer to a process.
139  */
140 struct proc *
141 db_lookup_proc(db_expr_t addr)
142 {
143 	db_expr_t decaddr;
144 	struct proc *p;
145 
146 	decaddr = db_hex2dec(addr);
147 	if (decaddr != -1) {
148 		LIST_FOREACH(p, PIDHASH(decaddr), p_hash) {
149 			if (p->p_pid == decaddr)
150 				return (p);
151 		}
152 	}
153 	return ((struct proc *)addr);
154 }
155