]> CyberLeo.Net >> Repos - FreeBSD/stable/10.git/blob - sys/kern/kern_exit.c
MFC r288336: save some bytes by using more concise SDT_PROBE<n>
[FreeBSD/stable/10.git] / sys / kern / kern_exit.c
1 /*-
2  * Copyright (c) 1982, 1986, 1989, 1991, 1993
3  *      The Regents of the University of California.  All rights reserved.
4  * (c) UNIX System Laboratories, Inc.
5  * All or some portions of this file are derived from material licensed
6  * to the University of California by American Telephone and Telegraph
7  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8  * the permission of UNIX System Laboratories, Inc.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 4. Neither the name of the University nor the names of its contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  *      @(#)kern_exit.c 8.7 (Berkeley) 2/12/94
35  */
36
37 #include <sys/cdefs.h>
38 __FBSDID("$FreeBSD$");
39
40 #include "opt_compat.h"
41 #include "opt_kdtrace.h"
42 #include "opt_ktrace.h"
43 #include "opt_procdesc.h"
44
45 #include <sys/param.h>
46 #include <sys/systm.h>
47 #include <sys/sysproto.h>
48 #include <sys/capsicum.h>
49 #include <sys/eventhandler.h>
50 #include <sys/kernel.h>
51 #include <sys/malloc.h>
52 #include <sys/lock.h>
53 #include <sys/mutex.h>
54 #include <sys/proc.h>
55 #include <sys/procdesc.h>
56 #include <sys/pioctl.h>
57 #include <sys/jail.h>
58 #include <sys/tty.h>
59 #include <sys/wait.h>
60 #include <sys/vmmeter.h>
61 #include <sys/vnode.h>
62 #include <sys/racct.h>
63 #include <sys/resourcevar.h>
64 #include <sys/sbuf.h>
65 #include <sys/signalvar.h>
66 #include <sys/sched.h>
67 #include <sys/sx.h>
68 #include <sys/syscallsubr.h>
69 #include <sys/syslog.h>
70 #include <sys/ptrace.h>
71 #include <sys/acct.h>           /* for acct_process() function prototype */
72 #include <sys/filedesc.h>
73 #include <sys/sdt.h>
74 #include <sys/shm.h>
75 #include <sys/sem.h>
76 #include <sys/umtx.h>
77 #ifdef KTRACE
78 #include <sys/ktrace.h>
79 #endif
80
81 #include <security/audit/audit.h>
82 #include <security/mac/mac_framework.h>
83
84 #include <vm/vm.h>
85 #include <vm/vm_extern.h>
86 #include <vm/vm_param.h>
87 #include <vm/pmap.h>
88 #include <vm/vm_map.h>
89 #include <vm/vm_page.h>
90 #include <vm/uma.h>
91
92 #ifdef KDTRACE_HOOKS
93 #include <sys/dtrace_bsd.h>
94 dtrace_execexit_func_t  dtrace_fasttrap_exit;
95 #endif
96
97 SDT_PROVIDER_DECLARE(proc);
98 SDT_PROBE_DEFINE1(proc, kernel, , exit, "int");
99
100 /* Hook for NFS teardown procedure. */
101 void (*nlminfo_release_p)(struct proc *p);
102
103 struct proc *
104 proc_realparent(struct proc *child)
105 {
106         struct proc *p, *parent;
107
108         sx_assert(&proctree_lock, SX_LOCKED);
109         if ((child->p_treeflag & P_TREE_ORPHANED) == 0) {
110                 if (child->p_oppid == 0 ||
111                     child->p_pptr->p_pid == child->p_oppid)
112                         parent = child->p_pptr;
113                 else
114                         parent = initproc;
115                 return (parent);
116         }
117         for (p = child; (p->p_treeflag & P_TREE_FIRST_ORPHAN) == 0;) {
118                 /* Cannot use LIST_PREV(), since the list head is not known. */
119                 p = __containerof(p->p_orphan.le_prev, struct proc,
120                     p_orphan.le_next);
121                 KASSERT((p->p_treeflag & P_TREE_ORPHANED) != 0,
122                     ("missing P_ORPHAN %p", p));
123         }
124         parent = __containerof(p->p_orphan.le_prev, struct proc,
125             p_orphans.lh_first);
126         return (parent);
127 }
128
129 void
130 reaper_abandon_children(struct proc *p, bool exiting)
131 {
132         struct proc *p1, *p2, *ptmp;
133
134         sx_assert(&proctree_lock, SX_LOCKED);
135         KASSERT(p != initproc, ("reaper_abandon_children for initproc"));
136         if ((p->p_treeflag & P_TREE_REAPER) == 0)
137                 return;
138         p1 = p->p_reaper;
139         LIST_FOREACH_SAFE(p2, &p->p_reaplist, p_reapsibling, ptmp) {
140                 LIST_REMOVE(p2, p_reapsibling);
141                 p2->p_reaper = p1;
142                 p2->p_reapsubtree = p->p_reapsubtree;
143                 LIST_INSERT_HEAD(&p1->p_reaplist, p2, p_reapsibling);
144                 if (exiting && p2->p_pptr == p) {
145                         PROC_LOCK(p2);
146                         proc_reparent(p2, p1);
147                         PROC_UNLOCK(p2);
148                 }
149         }
150         KASSERT(LIST_EMPTY(&p->p_reaplist), ("p_reaplist not empty"));
151         p->p_treeflag &= ~P_TREE_REAPER;
152 }
153
154 static void
155 clear_orphan(struct proc *p)
156 {
157         struct proc *p1;
158
159         sx_assert(&proctree_lock, SA_XLOCKED);
160         if ((p->p_treeflag & P_TREE_ORPHANED) == 0)
161                 return;
162         if ((p->p_treeflag & P_TREE_FIRST_ORPHAN) != 0) {
163                 p1 = LIST_NEXT(p, p_orphan);
164                 if (p1 != NULL)
165                         p1->p_treeflag |= P_TREE_FIRST_ORPHAN;
166                 p->p_treeflag &= ~P_TREE_FIRST_ORPHAN;
167         }
168         LIST_REMOVE(p, p_orphan);
169         p->p_treeflag &= ~P_TREE_ORPHANED;
170 }
171
172 /*
173  * exit -- death of process.
174  */
175 void
176 sys_sys_exit(struct thread *td, struct sys_exit_args *uap)
177 {
178
179         exit1(td, W_EXITCODE(uap->rval, 0));
180         /* NOTREACHED */
181 }
182
183 /*
184  * Exit: deallocate address space and other resources, change proc state to
185  * zombie, and unlink proc from allproc and parent's lists.  Save exit status
186  * and rusage for wait().  Check for child processes and orphan them.
187  */
188 void
189 exit1(struct thread *td, int rv)
190 {
191         struct proc *p, *nq, *q, *t;
192         struct thread *tdt;
193         struct vnode *ttyvp = NULL;
194
195         mtx_assert(&Giant, MA_NOTOWNED);
196
197         p = td->td_proc;
198         /*
199          * XXX in case we're rebooting we just let init die in order to
200          * work around an unsolved stack overflow seen very late during
201          * shutdown on sparc64 when the gmirror worker process exists.
202          */
203         if (p == initproc && rebooting == 0) {
204                 printf("init died (signal %d, exit %d)\n",
205                     WTERMSIG(rv), WEXITSTATUS(rv));
206                 panic("Going nowhere without my init!");
207         }
208
209         /*
210          * Deref SU mp, since the thread does not return to userspace.
211          */
212         if (softdep_ast_cleanup != NULL)
213                 softdep_ast_cleanup();
214
215         /*
216          * MUST abort all other threads before proceeding past here.
217          */
218         PROC_LOCK(p);
219         /*
220          * First check if some other thread or external request got
221          * here before us.  If so, act appropriately: exit or suspend.
222          * We must ensure that stop requests are handled before we set
223          * P_WEXIT.
224          */
225         thread_suspend_check(0);
226         while (p->p_flag & P_HADTHREADS) {
227                 /*
228                  * Kill off the other threads. This requires
229                  * some co-operation from other parts of the kernel
230                  * so it may not be instantaneous.  With this state set
231                  * any thread entering the kernel from userspace will
232                  * thread_exit() in trap().  Any thread attempting to
233                  * sleep will return immediately with EINTR or EWOULDBLOCK
234                  * which will hopefully force them to back out to userland
235                  * freeing resources as they go.  Any thread attempting
236                  * to return to userland will thread_exit() from userret().
237                  * thread_exit() will unsuspend us when the last of the
238                  * other threads exits.
239                  * If there is already a thread singler after resumption,
240                  * calling thread_single will fail; in that case, we just
241                  * re-check all suspension request, the thread should
242                  * either be suspended there or exit.
243                  */
244                 if (!thread_single(p, SINGLE_EXIT))
245                         /*
246                          * All other activity in this process is now
247                          * stopped.  Threading support has been turned
248                          * off.
249                          */
250                         break;
251                 /*
252                  * Recheck for new stop or suspend requests which
253                  * might appear while process lock was dropped in
254                  * thread_single().
255                  */
256                 thread_suspend_check(0);
257         }
258         KASSERT(p->p_numthreads == 1,
259             ("exit1: proc %p exiting with %d threads", p, p->p_numthreads));
260         racct_sub(p, RACCT_NTHR, 1);
261         /*
262          * Wakeup anyone in procfs' PIOCWAIT.  They should have a hold
263          * on our vmspace, so we should block below until they have
264          * released their reference to us.  Note that if they have
265          * requested S_EXIT stops we will block here until they ack
266          * via PIOCCONT.
267          */
268         _STOPEVENT(p, S_EXIT, rv);
269
270         /*
271          * Ignore any pending request to stop due to a stop signal.
272          * Once P_WEXIT is set, future requests will be ignored as
273          * well.
274          */
275         p->p_flag &= ~P_STOPPED_SIG;
276         KASSERT(!P_SHOULDSTOP(p), ("exiting process is stopped"));
277
278         /*
279          * Note that we are exiting and do another wakeup of anyone in
280          * PIOCWAIT in case they aren't listening for S_EXIT stops or
281          * decided to wait again after we told them we are exiting.
282          */
283         p->p_flag |= P_WEXIT;
284         wakeup(&p->p_stype);
285
286         /*
287          * Wait for any processes that have a hold on our vmspace to
288          * release their reference.
289          */
290         while (p->p_lock > 0)
291                 msleep(&p->p_lock, &p->p_mtx, PWAIT, "exithold", 0);
292
293         p->p_xstat = rv;        /* Let event handler change exit status */
294         PROC_UNLOCK(p);
295         /* Drain the limit callout while we don't have the proc locked */
296         callout_drain(&p->p_limco);
297
298 #ifdef AUDIT
299         /*
300          * The Sun BSM exit token contains two components: an exit status as
301          * passed to exit(), and a return value to indicate what sort of exit
302          * it was.  The exit status is WEXITSTATUS(rv), but it's not clear
303          * what the return value is.
304          */
305         AUDIT_ARG_EXIT(WEXITSTATUS(rv), 0);
306         AUDIT_SYSCALL_EXIT(0, td);
307 #endif
308
309         /* Are we a task leader? */
310         if (p == p->p_leader) {
311                 mtx_lock(&ppeers_lock);
312                 q = p->p_peers;
313                 while (q != NULL) {
314                         PROC_LOCK(q);
315                         kern_psignal(q, SIGKILL);
316                         PROC_UNLOCK(q);
317                         q = q->p_peers;
318                 }
319                 while (p->p_peers != NULL)
320                         msleep(p, &ppeers_lock, PWAIT, "exit1", 0);
321                 mtx_unlock(&ppeers_lock);
322         }
323
324         /*
325          * Check if any loadable modules need anything done at process exit.
326          * E.g. SYSV IPC stuff
327          * XXX what if one of these generates an error?
328          */
329         EVENTHANDLER_INVOKE(process_exit, p);
330
331         /*
332          * If parent is waiting for us to exit or exec,
333          * P_PPWAIT is set; we will wakeup the parent below.
334          */
335         PROC_LOCK(p);
336         rv = p->p_xstat;        /* Event handler could change exit status */
337         stopprofclock(p);
338         p->p_flag &= ~(P_TRACED | P_PPWAIT | P_PPTRACE);
339
340         /*
341          * Stop the real interval timer.  If the handler is currently
342          * executing, prevent it from rearming itself and let it finish.
343          */
344         if (timevalisset(&p->p_realtimer.it_value) &&
345             callout_stop(&p->p_itcallout) == 0) {
346                 timevalclear(&p->p_realtimer.it_interval);
347                 msleep(&p->p_itcallout, &p->p_mtx, PWAIT, "ritwait", 0);
348                 KASSERT(!timevalisset(&p->p_realtimer.it_value),
349                     ("realtime timer is still armed"));
350         }
351         PROC_UNLOCK(p);
352
353         /*
354          * Reset any sigio structures pointing to us as a result of
355          * F_SETOWN with our pid.
356          */
357         funsetownlst(&p->p_sigiolst);
358
359         /*
360          * If this process has an nlminfo data area (for lockd), release it
361          */
362         if (nlminfo_release_p != NULL && p->p_nlminfo != NULL)
363                 (*nlminfo_release_p)(p);
364
365         /*
366          * Close open files and release open-file table.
367          * This may block!
368          */
369         fdescfree(td);
370
371         /*
372          * If this thread tickled GEOM, we need to wait for the giggling to
373          * stop before we return to userland
374          */
375         if (td->td_pflags & TDP_GEOM)
376                 g_waitidle();
377
378         /*
379          * Remove ourself from our leader's peer list and wake our leader.
380          */
381         mtx_lock(&ppeers_lock);
382         if (p->p_leader->p_peers) {
383                 q = p->p_leader;
384                 while (q->p_peers != p)
385                         q = q->p_peers;
386                 q->p_peers = p->p_peers;
387                 wakeup(p->p_leader);
388         }
389         mtx_unlock(&ppeers_lock);
390
391         vmspace_exit(td);
392
393         sx_xlock(&proctree_lock);
394         if (SESS_LEADER(p)) {
395                 struct session *sp = p->p_session;
396                 struct tty *tp;
397
398                 /*
399                  * s_ttyp is not zero'd; we use this to indicate that
400                  * the session once had a controlling terminal. (for
401                  * logging and informational purposes)
402                  */
403                 SESS_LOCK(sp);
404                 ttyvp = sp->s_ttyvp;
405                 tp = sp->s_ttyp;
406                 sp->s_ttyvp = NULL;
407                 sp->s_ttydp = NULL;
408                 sp->s_leader = NULL;
409                 SESS_UNLOCK(sp);
410
411                 /*
412                  * Signal foreground pgrp and revoke access to
413                  * controlling terminal if it has not been revoked
414                  * already.
415                  *
416                  * Because the TTY may have been revoked in the mean
417                  * time and could already have a new session associated
418                  * with it, make sure we don't send a SIGHUP to a
419                  * foreground process group that does not belong to this
420                  * session.
421                  */
422
423                 if (tp != NULL) {
424                         tty_lock(tp);
425                         if (tp->t_session == sp)
426                                 tty_signal_pgrp(tp, SIGHUP);
427                         tty_unlock(tp);
428                 }
429
430                 if (ttyvp != NULL) {
431                         sx_xunlock(&proctree_lock);
432                         if (vn_lock(ttyvp, LK_EXCLUSIVE) == 0) {
433                                 VOP_REVOKE(ttyvp, REVOKEALL);
434                                 VOP_UNLOCK(ttyvp, 0);
435                         }
436                         sx_xlock(&proctree_lock);
437                 }
438         }
439         fixjobc(p, p->p_pgrp, 0);
440         sx_xunlock(&proctree_lock);
441         (void)acct_process(td);
442
443         /* Release the TTY now we've unlocked everything. */
444         if (ttyvp != NULL)
445                 vrele(ttyvp);
446 #ifdef KTRACE
447         ktrprocexit(td);
448 #endif
449         /*
450          * Release reference to text vnode
451          */
452         if (p->p_textvp != NULL) {
453                 vrele(p->p_textvp);
454                 p->p_textvp = NULL;
455         }
456
457         /*
458          * Release our limits structure.
459          */
460         lim_free(p->p_limit);
461         p->p_limit = NULL;
462
463         tidhash_remove(td);
464
465         /*
466          * Remove proc from allproc queue and pidhash chain.
467          * Place onto zombproc.  Unlink from parent's child list.
468          */
469         sx_xlock(&allproc_lock);
470         LIST_REMOVE(p, p_list);
471         LIST_INSERT_HEAD(&zombproc, p, p_list);
472         LIST_REMOVE(p, p_hash);
473         sx_xunlock(&allproc_lock);
474
475         /*
476          * Call machine-dependent code to release any
477          * machine-dependent resources other than the address space.
478          * The address space is released by "vmspace_exitfree(p)" in
479          * vm_waitproc().
480          */
481         cpu_exit(td);
482
483         WITNESS_WARN(WARN_PANIC, NULL, "process (pid %d) exiting", p->p_pid);
484
485         /*
486          * Reparent all children processes:
487          * - traced ones to the original parent (or init if we are that parent)
488          * - the rest to init
489          */
490         sx_xlock(&proctree_lock);
491         q = LIST_FIRST(&p->p_children);
492         if (q != NULL)          /* only need this if any child is S_ZOMB */
493                 wakeup(q->p_reaper);
494         for (; q != NULL; q = nq) {
495                 nq = LIST_NEXT(q, p_sibling);
496                 PROC_LOCK(q);
497                 q->p_sigparent = SIGCHLD;
498
499                 if (!(q->p_flag & P_TRACED)) {
500                         proc_reparent(q, q->p_reaper);
501                 } else {
502                         /*
503                          * Traced processes are killed since their existence
504                          * means someone is screwing up.
505                          */
506                         t = proc_realparent(q);
507                         if (t == p) {
508                                 proc_reparent(q, q->p_reaper);
509                         } else {
510                                 PROC_LOCK(t);
511                                 proc_reparent(q, t);
512                                 PROC_UNLOCK(t);
513                         }
514                         /*
515                          * Since q was found on our children list, the
516                          * proc_reparent() call moved q to the orphan
517                          * list due to present P_TRACED flag. Clear
518                          * orphan link for q now while q is locked.
519                          */
520                         clear_orphan(q);
521                         q->p_flag &= ~(P_TRACED | P_STOPPED_TRACE);
522                         FOREACH_THREAD_IN_PROC(q, tdt)
523                                 tdt->td_dbgflags &= ~TDB_SUSPEND;
524                         kern_psignal(q, SIGKILL);
525                 }
526                 PROC_UNLOCK(q);
527         }
528
529         /*
530          * Also get rid of our orphans.
531          */
532         while ((q = LIST_FIRST(&p->p_orphans)) != NULL) {
533                 PROC_LOCK(q);
534                 CTR2(KTR_PTRACE, "exit: pid %d, clearing orphan %d", p->p_pid,
535                     q->p_pid);
536                 clear_orphan(q);
537                 PROC_UNLOCK(q);
538         }
539
540         /* Save exit status. */
541         PROC_LOCK(p);
542         p->p_xthread = td;
543
544         /* Tell the prison that we are gone. */
545         prison_proc_free(p->p_ucred->cr_prison);
546
547 #ifdef KDTRACE_HOOKS
548         /*
549          * Tell the DTrace fasttrap provider about the exit if it
550          * has declared an interest.
551          */
552         if (dtrace_fasttrap_exit)
553                 dtrace_fasttrap_exit(p);
554 #endif
555
556         /*
557          * Notify interested parties of our demise.
558          */
559         KNOTE_LOCKED(&p->p_klist, NOTE_EXIT);
560
561 #ifdef KDTRACE_HOOKS
562         int reason = CLD_EXITED;
563         if (WCOREDUMP(rv))
564                 reason = CLD_DUMPED;
565         else if (WIFSIGNALED(rv))
566                 reason = CLD_KILLED;
567         SDT_PROBE1(proc, kernel, , exit, reason);
568 #endif
569
570         /*
571          * Just delete all entries in the p_klist. At this point we won't
572          * report any more events, and there are nasty race conditions that
573          * can beat us if we don't.
574          */
575         knlist_clear(&p->p_klist, 1);
576
577         /*
578          * If this is a process with a descriptor, we may not need to deliver
579          * a signal to the parent.  proctree_lock is held over
580          * procdesc_exit() to serialize concurrent calls to close() and
581          * exit().
582          */
583 #ifdef PROCDESC
584         if (p->p_procdesc == NULL || procdesc_exit(p)) {
585 #endif
586                 /*
587                  * Notify parent that we're gone.  If parent has the
588                  * PS_NOCLDWAIT flag set, or if the handler is set to SIG_IGN,
589                  * notify process 1 instead (and hope it will handle this
590                  * situation).
591                  */
592                 PROC_LOCK(p->p_pptr);
593                 mtx_lock(&p->p_pptr->p_sigacts->ps_mtx);
594                 if (p->p_pptr->p_sigacts->ps_flag &
595                     (PS_NOCLDWAIT | PS_CLDSIGIGN)) {
596                         struct proc *pp;
597
598                         mtx_unlock(&p->p_pptr->p_sigacts->ps_mtx);
599                         pp = p->p_pptr;
600                         PROC_UNLOCK(pp);
601                         proc_reparent(p, p->p_reaper);
602                         p->p_sigparent = SIGCHLD;
603                         PROC_LOCK(p->p_pptr);
604
605                         /*
606                          * Notify parent, so in case he was wait(2)ing or
607                          * executing waitpid(2) with our pid, he will
608                          * continue.
609                          */
610                         wakeup(pp);
611                 } else
612                         mtx_unlock(&p->p_pptr->p_sigacts->ps_mtx);
613
614                 if (p->p_pptr == p->p_reaper || p->p_pptr == initproc)
615                         childproc_exited(p);
616                 else if (p->p_sigparent != 0) {
617                         if (p->p_sigparent == SIGCHLD)
618                                 childproc_exited(p);
619                         else    /* LINUX thread */
620                                 kern_psignal(p->p_pptr, p->p_sigparent);
621                 }
622 #ifdef PROCDESC
623         } else
624                 PROC_LOCK(p->p_pptr);
625 #endif
626         sx_xunlock(&proctree_lock);
627
628         /*
629          * The state PRS_ZOMBIE prevents other proesses from sending
630          * signal to the process, to avoid memory leak, we free memory
631          * for signal queue at the time when the state is set.
632          */
633         sigqueue_flush(&p->p_sigqueue);
634         sigqueue_flush(&td->td_sigqueue);
635
636         /*
637          * We have to wait until after acquiring all locks before
638          * changing p_state.  We need to avoid all possible context
639          * switches (including ones from blocking on a mutex) while
640          * marked as a zombie.  We also have to set the zombie state
641          * before we release the parent process' proc lock to avoid
642          * a lost wakeup.  So, we first call wakeup, then we grab the
643          * sched lock, update the state, and release the parent process'
644          * proc lock.
645          */
646         wakeup(p->p_pptr);
647         cv_broadcast(&p->p_pwait);
648         sched_exit(p->p_pptr, td);
649         umtx_thread_exit(td);
650         PROC_SLOCK(p);
651         p->p_state = PRS_ZOMBIE;
652         PROC_UNLOCK(p->p_pptr);
653
654         /*
655          * Hopefully no one will try to deliver a signal to the process this
656          * late in the game.
657          */
658         knlist_destroy(&p->p_klist);
659
660         /*
661          * Save our children's rusage information in our exit rusage.
662          */
663         ruadd(&p->p_ru, &p->p_rux, &p->p_stats->p_cru, &p->p_crux);
664
665         /*
666          * Make sure the scheduler takes this thread out of its tables etc.
667          * This will also release this thread's reference to the ucred.
668          * Other thread parts to release include pcb bits and such.
669          */
670         thread_exit();
671 }
672
673
674 #ifndef _SYS_SYSPROTO_H_
675 struct abort2_args {
676         char *why;
677         int nargs;
678         void **args;
679 };
680 #endif
681
682 int
683 sys_abort2(struct thread *td, struct abort2_args *uap)
684 {
685         struct proc *p = td->td_proc;
686         struct sbuf *sb;
687         void *uargs[16];
688         int error, i, sig;
689
690         /*
691          * Do it right now so we can log either proper call of abort2(), or
692          * note, that invalid argument was passed. 512 is big enough to
693          * handle 16 arguments' descriptions with additional comments.
694          */
695         sb = sbuf_new(NULL, NULL, 512, SBUF_FIXEDLEN);
696         sbuf_clear(sb);
697         sbuf_printf(sb, "%s(pid %d uid %d) aborted: ",
698             p->p_comm, p->p_pid, td->td_ucred->cr_uid);
699         /*
700          * Since we can't return from abort2(), send SIGKILL in cases, where
701          * abort2() was called improperly
702          */
703         sig = SIGKILL;
704         /* Prevent from DoSes from user-space. */
705         if (uap->nargs < 0 || uap->nargs > 16)
706                 goto out;
707         if (uap->nargs > 0) {
708                 if (uap->args == NULL)
709                         goto out;
710                 error = copyin(uap->args, uargs, uap->nargs * sizeof(void *));
711                 if (error != 0)
712                         goto out;
713         }
714         /*
715          * Limit size of 'reason' string to 128. Will fit even when
716          * maximal number of arguments was chosen to be logged.
717          */
718         if (uap->why != NULL) {
719                 error = sbuf_copyin(sb, uap->why, 128);
720                 if (error < 0)
721                         goto out;
722         } else {
723                 sbuf_printf(sb, "(null)");
724         }
725         if (uap->nargs > 0) {
726                 sbuf_printf(sb, "(");
727                 for (i = 0;i < uap->nargs; i++)
728                         sbuf_printf(sb, "%s%p", i == 0 ? "" : ", ", uargs[i]);
729                 sbuf_printf(sb, ")");
730         }
731         /*
732          * Final stage: arguments were proper, string has been
733          * successfully copied from userspace, and copying pointers
734          * from user-space succeed.
735          */
736         sig = SIGABRT;
737 out:
738         if (sig == SIGKILL) {
739                 sbuf_trim(sb);
740                 sbuf_printf(sb, " (Reason text inaccessible)");
741         }
742         sbuf_cat(sb, "\n");
743         sbuf_finish(sb);
744         log(LOG_INFO, "%s", sbuf_data(sb));
745         sbuf_delete(sb);
746         exit1(td, W_EXITCODE(0, sig));
747         return (0);
748 }
749
750
751 #ifdef COMPAT_43
752 /*
753  * The dirty work is handled by kern_wait().
754  */
755 int
756 owait(struct thread *td, struct owait_args *uap __unused)
757 {
758         int error, status;
759
760         error = kern_wait(td, WAIT_ANY, &status, 0, NULL);
761         if (error == 0)
762                 td->td_retval[1] = status;
763         return (error);
764 }
765 #endif /* COMPAT_43 */
766
767 /*
768  * The dirty work is handled by kern_wait().
769  */
770 int
771 sys_wait4(struct thread *td, struct wait4_args *uap)
772 {
773         struct rusage ru, *rup;
774         int error, status;
775
776         if (uap->rusage != NULL)
777                 rup = &ru;
778         else
779                 rup = NULL;
780         error = kern_wait(td, uap->pid, &status, uap->options, rup);
781         if (uap->status != NULL && error == 0)
782                 error = copyout(&status, uap->status, sizeof(status));
783         if (uap->rusage != NULL && error == 0)
784                 error = copyout(&ru, uap->rusage, sizeof(struct rusage));
785         return (error);
786 }
787
788 int
789 sys_wait6(struct thread *td, struct wait6_args *uap)
790 {
791         struct __wrusage wru, *wrup;
792         siginfo_t si, *sip;
793         idtype_t idtype;
794         id_t id;
795         int error, status;
796
797         idtype = uap->idtype;
798         id = uap->id;
799
800         if (uap->wrusage != NULL)
801                 wrup = &wru;
802         else
803                 wrup = NULL;
804
805         if (uap->info != NULL) {
806                 sip = &si;
807                 bzero(sip, sizeof(*sip));
808         } else
809                 sip = NULL;
810
811         /*
812          *  We expect all callers of wait6() to know about WEXITED and
813          *  WTRAPPED.
814          */
815         error = kern_wait6(td, idtype, id, &status, uap->options, wrup, sip);
816
817         if (uap->status != NULL && error == 0)
818                 error = copyout(&status, uap->status, sizeof(status));
819         if (uap->wrusage != NULL && error == 0)
820                 error = copyout(&wru, uap->wrusage, sizeof(wru));
821         if (uap->info != NULL && error == 0)
822                 error = copyout(&si, uap->info, sizeof(si));
823         return (error);
824 }
825
826 /*
827  * Reap the remains of a zombie process and optionally return status and
828  * rusage.  Asserts and will release both the proctree_lock and the process
829  * lock as part of its work.
830  */
831 void
832 proc_reap(struct thread *td, struct proc *p, int *status, int options)
833 {
834         struct proc *q, *t;
835
836         sx_assert(&proctree_lock, SA_XLOCKED);
837         PROC_LOCK_ASSERT(p, MA_OWNED);
838         PROC_SLOCK_ASSERT(p, MA_OWNED);
839         KASSERT(p->p_state == PRS_ZOMBIE, ("proc_reap: !PRS_ZOMBIE"));
840
841         q = td->td_proc;
842
843         PROC_SUNLOCK(p);
844         td->td_retval[0] = p->p_pid;
845         if (status)
846                 *status = p->p_xstat;   /* convert to int */
847         if (options & WNOWAIT) {
848                 /*
849                  *  Only poll, returning the status.  Caller does not wish to
850                  * release the proc struct just yet.
851                  */
852                 PROC_UNLOCK(p);
853                 sx_xunlock(&proctree_lock);
854                 return;
855         }
856
857         PROC_LOCK(q);
858         sigqueue_take(p->p_ksi);
859         PROC_UNLOCK(q);
860
861         /*
862          * If we got the child via a ptrace 'attach', we need to give it back
863          * to the old parent.
864          */
865         if (p->p_oppid != 0 && p->p_oppid != p->p_pptr->p_pid) {
866                 PROC_UNLOCK(p);
867                 t = proc_realparent(p);
868                 PROC_LOCK(t);
869                 PROC_LOCK(p);
870                 CTR2(KTR_PTRACE,
871                     "wait: traced child %d moved back to parent %d", p->p_pid,
872                     t->p_pid);
873                 proc_reparent(p, t);
874                 p->p_oppid = 0;
875                 PROC_UNLOCK(p);
876                 pksignal(t, SIGCHLD, p->p_ksi);
877                 wakeup(t);
878                 cv_broadcast(&p->p_pwait);
879                 PROC_UNLOCK(t);
880                 sx_xunlock(&proctree_lock);
881                 return;
882         }
883         p->p_oppid = 0;
884         PROC_UNLOCK(p);
885
886         /*
887          * Remove other references to this process to ensure we have an
888          * exclusive reference.
889          */
890         sx_xlock(&allproc_lock);
891         LIST_REMOVE(p, p_list); /* off zombproc */
892         sx_xunlock(&allproc_lock);
893         LIST_REMOVE(p, p_sibling);
894         reaper_abandon_children(p, true);
895         LIST_REMOVE(p, p_reapsibling);
896         PROC_LOCK(p);
897         clear_orphan(p);
898         PROC_UNLOCK(p);
899         leavepgrp(p);
900 #ifdef PROCDESC
901         if (p->p_procdesc != NULL)
902                 procdesc_reap(p);
903 #endif
904         sx_xunlock(&proctree_lock);
905
906         /*
907          * As a side effect of this lock, we know that all other writes to
908          * this proc are visible now, so no more locking is needed for p.
909          */
910         PROC_LOCK(p);
911         p->p_xstat = 0;         /* XXX: why? */
912         PROC_UNLOCK(p);
913         PROC_LOCK(q);
914         ruadd(&q->p_stats->p_cru, &q->p_crux, &p->p_ru, &p->p_rux);
915         PROC_UNLOCK(q);
916
917         /*
918          * Decrement the count of procs running with this uid.
919          */
920         (void)chgproccnt(p->p_ucred->cr_ruidinfo, -1, 0);
921
922         /*
923          * Destroy resource accounting information associated with the process.
924          */
925 #ifdef RACCT
926         if (racct_enable) {
927                 PROC_LOCK(p);
928                 racct_sub(p, RACCT_NPROC, 1);
929                 PROC_UNLOCK(p);
930         }
931 #endif
932         racct_proc_exit(p);
933
934         /*
935          * Free credentials, arguments, and sigacts.
936          */
937         crfree(p->p_ucred);
938         p->p_ucred = NULL;
939         pargs_drop(p->p_args);
940         p->p_args = NULL;
941         sigacts_free(p->p_sigacts);
942         p->p_sigacts = NULL;
943
944         /*
945          * Do any thread-system specific cleanups.
946          */
947         thread_wait(p);
948
949         /*
950          * Give vm and machine-dependent layer a chance to free anything that
951          * cpu_exit couldn't release while still running in process context.
952          */
953         vm_waitproc(p);
954 #ifdef MAC
955         mac_proc_destroy(p);
956 #endif
957         KASSERT(FIRST_THREAD_IN_PROC(p),
958             ("proc_reap: no residual thread!"));
959         uma_zfree(proc_zone, p);
960         atomic_add_int(&nprocs, -1);
961 }
962
963 static int
964 proc_to_reap(struct thread *td, struct proc *p, idtype_t idtype, id_t id,
965     int *status, int options, struct __wrusage *wrusage, siginfo_t *siginfo,
966     int check_only)
967 {
968         struct rusage *rup;
969
970         sx_assert(&proctree_lock, SA_XLOCKED);
971
972         PROC_LOCK(p);
973
974         switch (idtype) {
975         case P_ALL:
976                 break;
977         case P_PID:
978                 if (p->p_pid != (pid_t)id) {
979                         PROC_UNLOCK(p);
980                         return (0);
981                 }
982                 break;
983         case P_PGID:
984                 if (p->p_pgid != (pid_t)id) {
985                         PROC_UNLOCK(p);
986                         return (0);
987                 }
988                 break;
989         case P_SID:
990                 if (p->p_session->s_sid != (pid_t)id) {
991                         PROC_UNLOCK(p);
992                         return (0);
993                 }
994                 break;
995         case P_UID:
996                 if (p->p_ucred->cr_uid != (uid_t)id) {
997                         PROC_UNLOCK(p);
998                         return (0);
999                 }
1000                 break;
1001         case P_GID:
1002                 if (p->p_ucred->cr_gid != (gid_t)id) {
1003                         PROC_UNLOCK(p);
1004                         return (0);
1005                 }
1006                 break;
1007         case P_JAILID:
1008                 if (p->p_ucred->cr_prison->pr_id != (int)id) {
1009                         PROC_UNLOCK(p);
1010                         return (0);
1011                 }
1012                 break;
1013         /*
1014          * It seems that the thread structures get zeroed out
1015          * at process exit.  This makes it impossible to
1016          * support P_SETID, P_CID or P_CPUID.
1017          */
1018         default:
1019                 PROC_UNLOCK(p);
1020                 return (0);
1021         }
1022
1023         if (p_canwait(td, p)) {
1024                 PROC_UNLOCK(p);
1025                 return (0);
1026         }
1027
1028         if (((options & WEXITED) == 0) && (p->p_state == PRS_ZOMBIE)) {
1029                 PROC_UNLOCK(p);
1030                 return (0);
1031         }
1032
1033         /*
1034          * This special case handles a kthread spawned by linux_clone
1035          * (see linux_misc.c).  The linux_wait4 and linux_waitpid
1036          * functions need to be able to distinguish between waiting
1037          * on a process and waiting on a thread.  It is a thread if
1038          * p_sigparent is not SIGCHLD, and the WLINUXCLONE option
1039          * signifies we want to wait for threads and not processes.
1040          */
1041         if ((p->p_sigparent != SIGCHLD) ^
1042             ((options & WLINUXCLONE) != 0)) {
1043                 PROC_UNLOCK(p);
1044                 return (0);
1045         }
1046
1047         PROC_SLOCK(p);
1048
1049         if (siginfo != NULL) {
1050                 bzero(siginfo, sizeof(*siginfo));
1051                 siginfo->si_errno = 0;
1052
1053                 /*
1054                  * SUSv4 requires that the si_signo value is always
1055                  * SIGCHLD. Obey it despite the rfork(2) interface
1056                  * allows to request other signal for child exit
1057                  * notification.
1058                  */
1059                 siginfo->si_signo = SIGCHLD;
1060
1061                 /*
1062                  *  This is still a rough estimate.  We will fix the
1063                  *  cases TRAPPED, STOPPED, and CONTINUED later.
1064                  */
1065                 if (WCOREDUMP(p->p_xstat)) {
1066                         siginfo->si_code = CLD_DUMPED;
1067                         siginfo->si_status = WTERMSIG(p->p_xstat);
1068                 } else if (WIFSIGNALED(p->p_xstat)) {
1069                         siginfo->si_code = CLD_KILLED;
1070                         siginfo->si_status = WTERMSIG(p->p_xstat);
1071                 } else {
1072                         siginfo->si_code = CLD_EXITED;
1073                         siginfo->si_status = WEXITSTATUS(p->p_xstat);
1074                 }
1075
1076                 siginfo->si_pid = p->p_pid;
1077                 siginfo->si_uid = p->p_ucred->cr_uid;
1078
1079                 /*
1080                  * The si_addr field would be useful additional
1081                  * detail, but apparently the PC value may be lost
1082                  * when we reach this point.  bzero() above sets
1083                  * siginfo->si_addr to NULL.
1084                  */
1085         }
1086
1087         /*
1088          * There should be no reason to limit resources usage info to
1089          * exited processes only.  A snapshot about any resources used
1090          * by a stopped process may be exactly what is needed.
1091          */
1092         if (wrusage != NULL) {
1093                 rup = &wrusage->wru_self;
1094                 *rup = p->p_ru;
1095                 calcru(p, &rup->ru_utime, &rup->ru_stime);
1096
1097                 rup = &wrusage->wru_children;
1098                 *rup = p->p_stats->p_cru;
1099                 calccru(p, &rup->ru_utime, &rup->ru_stime);
1100         }
1101
1102         if (p->p_state == PRS_ZOMBIE && !check_only) {
1103                 proc_reap(td, p, status, options);
1104                 return (-1);
1105         }
1106         PROC_SUNLOCK(p);
1107         PROC_UNLOCK(p);
1108         return (1);
1109 }
1110
1111 int
1112 kern_wait(struct thread *td, pid_t pid, int *status, int options,
1113     struct rusage *rusage)
1114 {
1115         struct __wrusage wru, *wrup;
1116         idtype_t idtype;
1117         id_t id;
1118         int ret;
1119
1120         /*
1121          * Translate the special pid values into the (idtype, pid)
1122          * pair for kern_wait6.  The WAIT_MYPGRP case is handled by
1123          * kern_wait6() on its own.
1124          */
1125         if (pid == WAIT_ANY) {
1126                 idtype = P_ALL;
1127                 id = 0;
1128         } else if (pid < 0) {
1129                 idtype = P_PGID;
1130                 id = (id_t)-pid;
1131         } else {
1132                 idtype = P_PID;
1133                 id = (id_t)pid;
1134         }
1135
1136         if (rusage != NULL)
1137                 wrup = &wru;
1138         else
1139                 wrup = NULL;
1140
1141         /*
1142          * For backward compatibility we implicitly add flags WEXITED
1143          * and WTRAPPED here.
1144          */
1145         options |= WEXITED | WTRAPPED;
1146         ret = kern_wait6(td, idtype, id, status, options, wrup, NULL);
1147         if (rusage != NULL)
1148                 *rusage = wru.wru_self;
1149         return (ret);
1150 }
1151
1152 int
1153 kern_wait6(struct thread *td, idtype_t idtype, id_t id, int *status,
1154     int options, struct __wrusage *wrusage, siginfo_t *siginfo)
1155 {
1156         struct proc *p, *q;
1157         int error, nfound, ret;
1158
1159         AUDIT_ARG_VALUE((int)idtype);   /* XXX - This is likely wrong! */
1160         AUDIT_ARG_PID((pid_t)id);       /* XXX - This may be wrong! */
1161         AUDIT_ARG_VALUE(options);
1162
1163         q = td->td_proc;
1164
1165         if ((pid_t)id == WAIT_MYPGRP && (idtype == P_PID || idtype == P_PGID)) {
1166                 PROC_LOCK(q);
1167                 id = (id_t)q->p_pgid;
1168                 PROC_UNLOCK(q);
1169                 idtype = P_PGID;
1170         }
1171
1172         /* If we don't know the option, just return. */
1173         if ((options & ~(WUNTRACED | WNOHANG | WCONTINUED | WNOWAIT |
1174             WEXITED | WTRAPPED | WLINUXCLONE)) != 0)
1175                 return (EINVAL);
1176         if ((options & (WEXITED | WUNTRACED | WCONTINUED | WTRAPPED)) == 0) {
1177                 /*
1178                  * We will be unable to find any matching processes,
1179                  * because there are no known events to look for.
1180                  * Prefer to return error instead of blocking
1181                  * indefinitely.
1182                  */
1183                 return (EINVAL);
1184         }
1185
1186 loop:
1187         if (q->p_flag & P_STATCHILD) {
1188                 PROC_LOCK(q);
1189                 q->p_flag &= ~P_STATCHILD;
1190                 PROC_UNLOCK(q);
1191         }
1192         nfound = 0;
1193         sx_xlock(&proctree_lock);
1194         LIST_FOREACH(p, &q->p_children, p_sibling) {
1195                 ret = proc_to_reap(td, p, idtype, id, status, options,
1196                     wrusage, siginfo, 0);
1197                 if (ret == 0)
1198                         continue;
1199                 else if (ret == 1)
1200                         nfound++;
1201                 else
1202                         return (0);
1203
1204                 PROC_LOCK(p);
1205                 PROC_SLOCK(p);
1206
1207                 if ((options & WTRAPPED) != 0 &&
1208                     (p->p_flag & P_TRACED) != 0 &&
1209                     (p->p_flag & (P_STOPPED_TRACE | P_STOPPED_SIG)) != 0 &&
1210                     (p->p_suspcount == p->p_numthreads) &&
1211                     ((p->p_flag & P_WAITED) == 0)) {
1212                         PROC_SUNLOCK(p);
1213                         if ((options & WNOWAIT) == 0)
1214                                 p->p_flag |= P_WAITED;
1215                         sx_xunlock(&proctree_lock);
1216                         td->td_retval[0] = p->p_pid;
1217
1218                         if (status != NULL)
1219                                 *status = W_STOPCODE(p->p_xstat);
1220                         if (siginfo != NULL) {
1221                                 siginfo->si_status = p->p_xstat;
1222                                 siginfo->si_code = CLD_TRAPPED;
1223                         }
1224                         if ((options & WNOWAIT) == 0) {
1225                                 PROC_LOCK(q);
1226                                 sigqueue_take(p->p_ksi);
1227                                 PROC_UNLOCK(q);
1228                         }
1229
1230                         CTR4(KTR_PTRACE,
1231             "wait: returning trapped pid %d status %#x (xstat %d) xthread %d",
1232                             p->p_pid, W_STOPCODE(p->p_xstat), p->p_xstat,
1233                             p->p_xthread != NULL ? p->p_xthread->td_tid : -1);
1234                         PROC_UNLOCK(p);
1235                         return (0);
1236                 }
1237                 if ((options & WUNTRACED) != 0 &&
1238                     (p->p_flag & P_STOPPED_SIG) != 0 &&
1239                     (p->p_suspcount == p->p_numthreads) &&
1240                     ((p->p_flag & P_WAITED) == 0)) {
1241                         PROC_SUNLOCK(p);
1242                         if ((options & WNOWAIT) == 0)
1243                                 p->p_flag |= P_WAITED;
1244                         sx_xunlock(&proctree_lock);
1245                         td->td_retval[0] = p->p_pid;
1246
1247                         if (status != NULL)
1248                                 *status = W_STOPCODE(p->p_xstat);
1249                         if (siginfo != NULL) {
1250                                 siginfo->si_status = p->p_xstat;
1251                                 siginfo->si_code = CLD_STOPPED;
1252                         }
1253                         if ((options & WNOWAIT) == 0) {
1254                                 PROC_LOCK(q);
1255                                 sigqueue_take(p->p_ksi);
1256                                 PROC_UNLOCK(q);
1257                         }
1258
1259                         PROC_UNLOCK(p);
1260                         return (0);
1261                 }
1262                 PROC_SUNLOCK(p);
1263                 if ((options & WCONTINUED) != 0 &&
1264                     (p->p_flag & P_CONTINUED) != 0) {
1265                         sx_xunlock(&proctree_lock);
1266                         td->td_retval[0] = p->p_pid;
1267                         if ((options & WNOWAIT) == 0) {
1268                                 p->p_flag &= ~P_CONTINUED;
1269                                 PROC_LOCK(q);
1270                                 sigqueue_take(p->p_ksi);
1271                                 PROC_UNLOCK(q);
1272                         }
1273                         PROC_UNLOCK(p);
1274
1275                         if (status != NULL)
1276                                 *status = SIGCONT;
1277                         if (siginfo != NULL) {
1278                                 siginfo->si_status = SIGCONT;
1279                                 siginfo->si_code = CLD_CONTINUED;
1280                         }
1281                         return (0);
1282                 }
1283                 PROC_UNLOCK(p);
1284         }
1285
1286         /*
1287          * Look in the orphans list too, to allow the parent to
1288          * collect it's child exit status even if child is being
1289          * debugged.
1290          *
1291          * Debugger detaches from the parent upon successful
1292          * switch-over from parent to child.  At this point due to
1293          * re-parenting the parent loses the child to debugger and a
1294          * wait4(2) call would report that it has no children to wait
1295          * for.  By maintaining a list of orphans we allow the parent
1296          * to successfully wait until the child becomes a zombie.
1297          */
1298         if (nfound == 0) {
1299                 LIST_FOREACH(p, &q->p_orphans, p_orphan) {
1300                         ret = proc_to_reap(td, p, idtype, id, NULL, options,
1301                             NULL, NULL, 1);
1302                         if (ret != 0) {
1303                                 KASSERT(ret != -1, ("reaped an orphan (pid %d)",
1304                                     (int)td->td_retval[0]));
1305                                 nfound++;
1306                                 break;
1307                         }
1308                 }
1309         }
1310         if (nfound == 0) {
1311                 sx_xunlock(&proctree_lock);
1312                 return (ECHILD);
1313         }
1314         if (options & WNOHANG) {
1315                 sx_xunlock(&proctree_lock);
1316                 td->td_retval[0] = 0;
1317                 return (0);
1318         }
1319         PROC_LOCK(q);
1320         sx_xunlock(&proctree_lock);
1321         if (q->p_flag & P_STATCHILD) {
1322                 q->p_flag &= ~P_STATCHILD;
1323                 error = 0;
1324         } else
1325                 error = msleep(q, &q->p_mtx, PWAIT | PCATCH, "wait", 0);
1326         PROC_UNLOCK(q);
1327         if (error)
1328                 return (error);
1329         goto loop;
1330 }
1331
1332 /*
1333  * Make process 'parent' the new parent of process 'child'.
1334  * Must be called with an exclusive hold of proctree lock.
1335  */
1336 void
1337 proc_reparent(struct proc *child, struct proc *parent)
1338 {
1339
1340         sx_assert(&proctree_lock, SX_XLOCKED);
1341         PROC_LOCK_ASSERT(child, MA_OWNED);
1342         if (child->p_pptr == parent)
1343                 return;
1344
1345         PROC_LOCK(child->p_pptr);
1346         sigqueue_take(child->p_ksi);
1347         PROC_UNLOCK(child->p_pptr);
1348         LIST_REMOVE(child, p_sibling);
1349         LIST_INSERT_HEAD(&parent->p_children, child, p_sibling);
1350
1351         clear_orphan(child);
1352         if (child->p_flag & P_TRACED) {
1353                 if (LIST_EMPTY(&child->p_pptr->p_orphans)) {
1354                         child->p_treeflag |= P_TREE_FIRST_ORPHAN;
1355                         LIST_INSERT_HEAD(&child->p_pptr->p_orphans, child,
1356                             p_orphan);
1357                 } else {
1358                         LIST_INSERT_AFTER(LIST_FIRST(&child->p_pptr->p_orphans),
1359                             child, p_orphan);
1360                 }
1361                 child->p_treeflag |= P_TREE_ORPHANED;
1362         }
1363
1364         child->p_pptr = parent;
1365 }