Annotation of sys/miscfs/procfs/procfs_ctl.c, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: procfs_ctl.c,v 1.21 2007/06/18 08:30:07 jasper Exp $ */
2: /* $NetBSD: procfs_ctl.c,v 1.14 1996/02/09 22:40:48 christos Exp $ */
3:
4: /*
5: * Copyright (c) 1993 Jan-Simon Pendry
6: * Copyright (c) 1993
7: * The Regents of the University of California. All rights reserved.
8: *
9: * This code is derived from software contributed to Berkeley by
10: * Jan-Simon Pendry.
11: *
12: * Redistribution and use in source and binary forms, with or without
13: * modification, are permitted provided that the following conditions
14: * are met:
15: * 1. Redistributions of source code must retain the above copyright
16: * notice, this list of conditions and the following disclaimer.
17: * 2. Redistributions in binary form must reproduce the above copyright
18: * notice, this list of conditions and the following disclaimer in the
19: * documentation and/or other materials provided with the distribution.
20: * 3. Neither the name of the University nor the names of its contributors
21: * may be used to endorse or promote products derived from this software
22: * without specific prior written permission.
23: *
24: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34: * SUCH DAMAGE.
35: *
36: * @(#)procfs_ctl.c 8.4 (Berkeley) 6/15/94
37: */
38:
39: #include <sys/param.h>
40: #include <sys/systm.h>
41: #include <sys/time.h>
42: #include <sys/kernel.h>
43: #include <sys/proc.h>
44: #include <sys/vnode.h>
45: #include <sys/ioctl.h>
46: #include <sys/tty.h>
47: #include <sys/resource.h>
48: #include <sys/resourcevar.h>
49: #include <sys/signalvar.h>
50: #include <sys/ptrace.h>
51: #include <sys/sched.h>
52: #include <miscfs/procfs/procfs.h>
53:
54: /*
55: * True iff process (p) is in trace wait state
56: * relative to process (curp)
57: */
58: #define TRACE_WAIT_P(curp, p) \
59: ((p)->p_stat == SSTOP && \
60: (p)->p_pptr == (curp) && \
61: ISSET((p)->p_flag, P_TRACED))
62:
63: #ifdef PTRACE
64:
65: #define PROCFS_CTL_ATTACH 1
66: #define PROCFS_CTL_DETACH 2
67: #define PROCFS_CTL_STEP 3
68: #define PROCFS_CTL_RUN 4
69: #define PROCFS_CTL_WAIT 5
70:
71: static const vfs_namemap_t ctlnames[] = {
72: /* special /proc commands */
73: { "attach", PROCFS_CTL_ATTACH },
74: { "detach", PROCFS_CTL_DETACH },
75: { "step", PROCFS_CTL_STEP },
76: { "run", PROCFS_CTL_RUN },
77: { "wait", PROCFS_CTL_WAIT },
78: { 0 },
79: };
80:
81: #endif
82:
83: static const vfs_namemap_t signames[] = {
84: /* regular signal names */
85: { "hup", SIGHUP }, { "int", SIGINT },
86: { "quit", SIGQUIT }, { "ill", SIGILL },
87: { "trap", SIGTRAP }, { "abrt", SIGABRT },
88: { "iot", SIGIOT }, { "emt", SIGEMT },
89: { "fpe", SIGFPE }, { "kill", SIGKILL },
90: { "bus", SIGBUS }, { "segv", SIGSEGV },
91: { "sys", SIGSYS }, { "pipe", SIGPIPE },
92: { "alrm", SIGALRM }, { "term", SIGTERM },
93: { "urg", SIGURG }, { "stop", SIGSTOP },
94: { "tstp", SIGTSTP }, { "cont", SIGCONT },
95: { "chld", SIGCHLD }, { "ttin", SIGTTIN },
96: { "ttou", SIGTTOU }, { "io", SIGIO },
97: { "xcpu", SIGXCPU }, { "xfsz", SIGXFSZ },
98: { "vtalrm", SIGVTALRM }, { "prof", SIGPROF },
99: { "winch", SIGWINCH }, { "info", SIGINFO },
100: { "usr1", SIGUSR1 }, { "usr2", SIGUSR2 },
101: { 0 },
102: };
103:
104: #ifdef PTRACE
105: static int procfs_control(struct proc *, struct proc *, int);
106:
107: static int
108: procfs_control(struct proc *curp, struct proc *p, int op)
109: /* *curp being the tracer, and *p the traced */
110: {
111: int error;
112: int s;
113:
114: /*
115: * Attach - attaches the target process for debugging
116: * by the calling process.
117: */
118: if (op == PROCFS_CTL_ATTACH) {
119: /* Can't trace yourself! */
120: if (p->p_pid == curp->p_pid)
121: return (EINVAL);
122:
123: /* Check whether already being traced. */
124: if (ISSET(p->p_flag, P_TRACED))
125: return (EBUSY);
126:
127: if ((error = process_checkioperm(curp, p)) != 0)
128: return (error);
129:
130: /*
131: * Go ahead and set the trace flag.
132: * Save the old parent (it's reset in
133: * _DETACH, and also in kern_exit.c:wait4()
134: * Reparent the process so that the tracing
135: * proc gets to see all the action.
136: * Stop the target.
137: */
138: atomic_setbits_int(&p->p_flag, P_TRACED);
139: p->p_xstat = 0; /* XXX ? */
140: if (p->p_pptr != curp) {
141: p->p_oppid = p->p_pptr->p_pid;
142: proc_reparent(p, curp);
143: }
144: psignal(p, SIGSTOP);
145: return (0);
146: }
147:
148: /*
149: * Target process must be stopped, owned by (curp) and
150: * be set up for tracing (P_TRACED flag set).
151: * Allow DETACH to take place at any time for sanity.
152: * Allow WAIT any time, of course.
153: */
154: switch (op) {
155: case PROCFS_CTL_DETACH:
156: case PROCFS_CTL_WAIT:
157: break;
158:
159: default:
160: if (!TRACE_WAIT_P(curp, p))
161: return (EBUSY);
162: }
163:
164: /*
165: * do single-step fixup if needed
166: */
167: FIX_SSTEP(p);
168:
169: /*
170: * Don't deliver any signal by default.
171: * To continue with a signal, just send
172: * the signal name to the ctl file
173: */
174: p->p_xstat = 0;
175:
176: switch (op) {
177: /*
178: * Detach. Cleans up the target process, reparent it if possible
179: * and set it running once more.
180: */
181: case PROCFS_CTL_DETACH:
182: /* if not being traced, then this is a painless no-op */
183: if (!ISSET(p->p_flag, P_TRACED))
184: return (0);
185:
186: /* not being traced any more */
187: atomic_clearbits_int(&p->p_flag, P_TRACED);
188:
189: /* give process back to original parent */
190: if (p->p_oppid != p->p_pptr->p_pid) {
191: struct proc *pp;
192:
193: pp = pfind(p->p_oppid);
194: if (pp)
195: proc_reparent(p, pp);
196: }
197:
198: p->p_oppid = 0;
199: atomic_clearbits_int(&p->p_flag, P_WAITED);
200: wakeup(curp); /* XXX for CTL_WAIT below ? */
201:
202: break;
203:
204: /*
205: * Step. Let the target process execute a single instruction.
206: */
207: case PROCFS_CTL_STEP:
208: #ifdef PT_STEP
209: error = process_sstep(p, 1);
210: if (error)
211: return (error);
212: break;
213: #else
214: return (EOPNOTSUPP);
215: #endif
216:
217: /*
218: * Run. Let the target process continue running until a breakpoint
219: * or some other trap.
220: */
221: case PROCFS_CTL_RUN:
222: break;
223:
224: /*
225: * Wait for the target process to stop.
226: * If the target is not being traced then just wait
227: * to enter
228: */
229: case PROCFS_CTL_WAIT:
230: error = 0;
231: if (ISSET(p->p_flag, P_TRACED)) {
232: while (error == 0 &&
233: (p->p_stat != SSTOP) &&
234: ISSET(p->p_flag, P_TRACED) &&
235: (p->p_pptr == curp)) {
236: error = tsleep(p, PWAIT|PCATCH, "procfsx", 0);
237: }
238: if (error == 0 && !TRACE_WAIT_P(curp, p))
239: error = EBUSY;
240: } else {
241: while (error == 0 && p->p_stat != SSTOP) {
242: error = tsleep(p, PWAIT|PCATCH, "procfs", 0);
243: }
244: }
245: return (error);
246:
247: #ifdef DIAGNOSTIC
248: default:
249: panic("procfs_control");
250: #endif
251: }
252:
253: SCHED_LOCK(s);
254: if (p->p_stat == SSTOP)
255: setrunnable(p);
256: SCHED_UNLOCK(s);
257: return (0);
258: }
259: #endif
260:
261: int
262: procfs_doctl(struct proc *curp, struct proc *p, struct pfsnode *pfs, struct uio *uio)
263: {
264: int xlen;
265: int error;
266: char msg[PROCFS_CTLLEN+1];
267: const vfs_namemap_t *nm;
268: int s;
269:
270: if (uio->uio_rw != UIO_WRITE)
271: return (EOPNOTSUPP);
272:
273: xlen = PROCFS_CTLLEN;
274: error = vfs_getuserstr(uio, msg, &xlen);
275: if (error)
276: return (error);
277:
278: /*
279: * Map signal names into signal generation
280: * or debug control. Unknown commands and/or signals
281: * return EOPNOTSUPP.
282: *
283: * Sending a signal while the process is being debugged
284: * also has the side effect of letting the target continue
285: * to run. There is no way to single-step a signal delivery.
286: */
287: error = EOPNOTSUPP;
288:
289: #ifdef PTRACE
290: nm = vfs_findname(ctlnames, msg, xlen);
291: if (nm) {
292: error = procfs_control(curp, p, nm->nm_val);
293: } else
294: #endif
295: {
296: nm = vfs_findname(signames, msg, xlen);
297: if (nm) {
298: if (TRACE_WAIT_P(curp, p)) {
299: p->p_xstat = nm->nm_val;
300: FIX_SSTEP(p);
301: SCHED_LOCK(s);
302: setrunnable(p);
303: SCHED_UNLOCK(s);
304: } else {
305: psignal(p, nm->nm_val);
306: }
307: error = 0;
308: }
309: }
310:
311: return (error);
312: }
CVSweb