sys/kern/kern_fork.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_fork.c 8.6 (Berkeley) 4/8/94
  35  */
  36
  37 #include <sys/cdefs.h>
  38 __FBSDID("$FreeBSD$");
  39
  40 #include "opt_ktrace.h"
  41 #include "opt_mac.h"
  42
  43 #include <sys/param.h>
  44 #include <sys/systm.h>
  45 #include <sys/sysproto.h>
  46 #include <sys/eventhandler.h>
  47 #include <sys/filedesc.h>
  48 #include <sys/kernel.h>
  49 #include <sys/kthread.h>
  50 #include <sys/sysctl.h>
  51 #include <sys/lock.h>
  52 #include <sys/malloc.h>
  53 #include <sys/mutex.h>
  54 #include <sys/priv.h>
  55 #include <sys/proc.h>
  56 #include <sys/pioctl.h>
  57 #include <sys/resourcevar.h>
  58 #include <sys/sched.h>
  59 #include <sys/syscall.h>
  60 #include <sys/vmmeter.h>
  61 #include <sys/vnode.h>
  62 #include <sys/acct.h>
  63 #include <sys/ktr.h>
  64 #include <sys/ktrace.h>
  65 #include <sys/unistd.h>
  66 #include <sys/sx.h>
  67 #include <sys/signalvar.h>
  68
  69 #include <security/audit/audit.h>
  70 #include <security/mac/mac_framework.h>
  71
  72 #include <vm/vm.h>
  73 #include <vm/pmap.h>
  74 #include <vm/vm_map.h>
  75 #include <vm/vm_extern.h>
  76 #include <vm/uma.h>
  77
  78
  79 #ifndef _SYS_SYSPROTO_H_
  80 struct fork_args {
  81         int     dummy;
  82 };
  83 #endif
  84
  85 /* ARGSUSED */
  86 int
  87 fork(td, uap)
  88         struct thread *td;
  89         struct fork_args *uap;
  90 {
  91         int error;
  92         struct proc *p2;
  93
  94         error = fork1(td, RFFDG | RFPROC, 0, &p2);
  95         if (error == 0) {
  96                 td->td_retval[0] = p2->p_pid;
  97                 td->td_retval[1] = 0;
  98         }
  99         return (error);
 100 }
 101
 102 /* ARGSUSED */
 103 int
 104 vfork(td, uap)
 105         struct thread *td;
 106         struct vfork_args *uap;
 107 {
 108         int error;
 109         struct proc *p2;
 110
 111         error = fork1(td, RFFDG | RFPROC | RFPPWAIT | RFMEM, 0, &p2);
 112         if (error == 0) {
 113                 td->td_retval[0] = p2->p_pid;
 114                 td->td_retval[1] = 0;
 115         }
 116         return (error);
 117 }
 118
 119 int
 120 rfork(td, uap)
 121         struct thread *td;
 122         struct rfork_args *uap;
 123 {
 124         struct proc *p2;
 125         int error;
 126
 127         /* Don't allow kernel-only flags. */
 128         if ((uap->flags & RFKERNELONLY) != 0)
 129                 return (EINVAL);
 130
 131         AUDIT_ARG(fflags, uap->flags);
 132         error = fork1(td, uap->flags, 0, &p2);
 133         if (error == 0) {
 134                 td->td_retval[0] = p2 ? p2->p_pid : 0;
 135                 td->td_retval[1] = 0;
 136         }
 137         return (error);
 138 }
 139
 140 int     nprocs = 1;             /* process 0 */
 141 int     lastpid = 0;
 142 SYSCTL_INT(_kern, OID_AUTO, lastpid, CTLFLAG_RD, &lastpid, 0,
 143     "Last used PID");
 144
 145 /*
 146  * Random component to lastpid generation.  We mix in a random factor to make
 147  * it a little harder to predict.  We sanity check the modulus value to avoid
 148  * doing it in critical paths.  Don't let it be too small or we pointlessly
 149  * waste randomness entropy, and don't let it be impossibly large.  Using a
 150  * modulus that is too big causes a LOT more process table scans and slows
 151  * down fork processing as the pidchecked caching is defeated.
 152  */
 153 static int randompid = 0;
 154
 155 static int
 156 sysctl_kern_randompid(SYSCTL_HANDLER_ARGS)
 157 {
 158         int error, pid;
 159
 160         error = sysctl_wire_old_buffer(req, sizeof(int));
 161         if (error != 0)
 162                 return(error);
 163         sx_xlock(&allproc_lock);
 164         pid = randompid;
 165         error = sysctl_handle_int(oidp, &pid, 0, req);
 166         if (error == 0 && req->newptr != NULL) {
 167                 if (pid < 0 || pid > PID_MAX - 100)     /* out of range */
 168                         pid = PID_MAX - 100;
 169                 else if (pid < 2)                       /* NOP */
 170                         pid = 0;
 171                 else if (pid < 100)                     /* Make it reasonable */
 172                         pid = 100;
 173                 randompid = pid;
 174         }
 175         sx_xunlock(&allproc_lock);
 176         return (error);
 177 }
 178
 179 SYSCTL_PROC(_kern, OID_AUTO, randompid, CTLTYPE_INT|CTLFLAG_RW,
 180     0, 0, sysctl_kern_randompid, "I", "Random PID modulus");
 181
 182 int
 183 fork1(td, flags, pages, procp)
 184         struct thread *td;
 185         int flags;
 186         int pages;
 187         struct proc **procp;
 188 {
 189         struct proc *p1, *p2, *pptr;
 190         struct proc *newproc;
 191         int ok, trypid;
 192         static int curfail, pidchecked = 0;
 193         static struct timeval lastfail;
 194         struct filedesc *fd;
 195         struct filedesc_to_leader *fdtol;
 196         struct thread *td2;
 197         struct sigacts *newsigacts;
 198         int error;
 199
 200         /* Can't copy and clear. */
 201         if ((flags & (RFFDG|RFCFDG)) == (RFFDG|RFCFDG))
 202                 return (EINVAL);
 203
 204         p1 = td->td_proc;
 205
 206         /*
 207          * Here we don't create a new process, but we divorce
 208          * certain parts of a process from itself.
 209          */
 210         if ((flags & RFPROC) == 0) {
 211                 if ((p1->p_flag & P_HADTHREADS) &&
 212                     (flags & (RFCFDG | RFFDG))) {
 213                         PROC_LOCK(p1);
 214                         if (thread_single(SINGLE_BOUNDARY)) {
 215                                 PROC_UNLOCK(p1);
 216                                 return (ERESTART);
 217                         }
 218                         PROC_UNLOCK(p1);
 219                 }
 220
 221                 vm_forkproc(td, NULL, NULL, flags);
 222
 223                 /*
 224                  * Close all file descriptors.
 225                  */
 226                 if (flags & RFCFDG) {
 227                         struct filedesc *fdtmp;
 228                         fdtmp = fdinit(td->td_proc->p_fd);
 229                         fdfree(td);
 230                         p1->p_fd = fdtmp;
 231                 }
 232
 233                 /*
 234                  * Unshare file descriptors (from parent).
 235                  */
 236                 if (flags & RFFDG)
 237                         fdunshare(p1, td);
 238
 239                 if ((p1->p_flag & P_HADTHREADS) &&
 240                     (flags & (RFCFDG | RFFDG))) {
 241                         PROC_LOCK(p1);
 242                         thread_single_end();
 243                         PROC_UNLOCK(p1);
 244                 }
 245                 *procp = NULL;
 246                 return (0);
 247         }
 248
 249         /*
 250          * Note 1:1 allows for forking with one thread coming out on the
 251          * other side with the expectation that the process is about to
 252          * exec.
 253          */
 254         if (p1->p_flag & P_HADTHREADS) {
 255                 /*
 256                  * Idle the other threads for a second.
 257                  * Since the user space is copied, it must remain stable.
 258                  * In addition, all threads (from the user perspective)
 259                  * need to either be suspended or in the kernel,
 260                  * where they will try restart in the parent and will
 261                  * be aborted in the child.
 262                  */
 263                 PROC_LOCK(p1);
 264                 if (thread_single(SINGLE_NO_EXIT)) {
 265                         /* Abort. Someone else is single threading before us. */
 266                         PROC_UNLOCK(p1);
 267                         return (ERESTART);
 268                 }
 269                 PROC_UNLOCK(p1);
 270                 /*
 271                  * All other activity in this process
 272                  * is now suspended at the user boundary,
 273                  * (or other safe places if we think of any).
 274                  */
 275         }
 276
 277         /* Allocate new proc. */
 278         newproc = uma_zalloc(proc_zone, M_WAITOK);
 279 #ifdef MAC
 280         mac_init_proc(newproc);
 281 #endif
 282         knlist_init(&newproc->p_klist, &newproc->p_mtx, NULL, NULL, NULL);
 283         STAILQ_INIT(&newproc->p_ktr);
 284
 285         /* We have to lock the process tree while we look for a pid. */
 286         sx_slock(&proctree_lock);
 287
 288         /*
 289          * Although process entries are dynamically created, we still keep
 290          * a global limit on the maximum number we will create.  Don't allow
 291          * a nonprivileged user to use the last ten processes; don't let root
 292          * exceed the limit. The variable nprocs is the current number of
 293          * processes, maxproc is the limit.
 294          */
 295         sx_xlock(&allproc_lock);
 296         if ((nprocs >= maxproc - 10 &&
 297             priv_check_cred(td->td_ucred, PRIV_MAXPROC, SUSER_RUID) != 0) ||
 298             nprocs >= maxproc) {
 299                 error = EAGAIN;
 300                 goto fail;
 301         }
 302
 303         /*
 304          * Increment the count of procs running with this uid. Don't allow
 305          * a nonprivileged user to exceed their current limit.
 306          *
 307          * XXXRW: Can we avoid privilege here if it's not needed?
 308          */
 309         error = priv_check_cred(td->td_ucred, PRIV_PROC_LIMIT, SUSER_RUID);
 310         if (error == 0)
 311                 ok = chgproccnt(td->td_ucred->cr_ruidinfo, 1, 0);
 312         else {
 313                 PROC_LOCK(p1);
 314                 ok = chgproccnt(td->td_ucred->cr_ruidinfo, 1,
 315                     lim_cur(p1, RLIMIT_NPROC));
 316                 PROC_UNLOCK(p1);
 317         }
 318         if (!ok) {
 319                 error = EAGAIN;
 320                 goto fail;
 321         }
 322
 323         /*
 324          * Increment the nprocs resource before blocking can occur.  There
 325          * are hard-limits as to the number of processes that can run.
 326          */
 327         nprocs++;
 328
 329         /*
 330          * Find an unused process ID.  We remember a range of unused IDs
 331          * ready to use (from lastpid+1 through pidchecked-1).
 332          *
 333          * If RFHIGHPID is set (used during system boot), do not allocate
 334          * low-numbered pids.
 335          */
 336         trypid = lastpid + 1;
 337         if (flags & RFHIGHPID) {
 338                 if (trypid < 10)
 339                         trypid = 10;
 340         } else {
 341                 if (randompid)
 342                         trypid += arc4random() % randompid;
 343         }
 344 retry:
 345         /*
 346          * If the process ID prototype has wrapped around,
 347          * restart somewhat above 0, as the low-numbered procs
 348          * tend to include daemons that don't exit.
 349          */
 350         if (trypid >= PID_MAX) {
 351                 trypid = trypid % PID_MAX;
 352                 if (trypid < 100)
 353                         trypid += 100;
 354                 pidchecked = 0;
 355         }
 356         if (trypid >= pidchecked) {
 357                 int doingzomb = 0;
 358
 359                 pidchecked = PID_MAX;
 360                 /*
 361                  * Scan the active and zombie procs to check whether this pid
 362                  * is in use.  Remember the lowest pid that's greater
 363                  * than trypid, so we can avoid checking for a while.
 364                  */
 365                 p2 = LIST_FIRST(&allproc);
 366 again:
 367                 for (; p2 != NULL; p2 = LIST_NEXT(p2, p_list)) {
 368                         while (p2->p_pid == trypid ||
 369                             (p2->p_pgrp != NULL &&
 370                             (p2->p_pgrp->pg_id == trypid ||
 371                             (p2->p_session != NULL &&
 372                             p2->p_session->s_sid == trypid)))) {
 373                                 trypid++;
 374                                 if (trypid >= pidchecked)
 375                                         goto retry;
 376                         }
 377                         if (p2->p_pid > trypid && pidchecked > p2->p_pid)
 378                                 pidchecked = p2->p_pid;
 379                         if (p2->p_pgrp != NULL) {
 380                                 if (p2->p_pgrp->pg_id > trypid &&
 381                                     pidchecked > p2->p_pgrp->pg_id)
 382                                         pidchecked = p2->p_pgrp->pg_id;
 383                                 if (p2->p_session != NULL &&
 384                                     p2->p_session->s_sid > trypid &&
 385                                     pidchecked > p2->p_session->s_sid)
 386                                         pidchecked = p2->p_session->s_sid;
 387                         }
 388                 }
 389                 if (!doingzomb) {
 390                         doingzomb = 1;
 391                         p2 = LIST_FIRST(&zombproc);
 392                         goto again;
 393                 }
 394         }
 395         sx_sunlock(&proctree_lock);
 396
 397         /*
 398          * RFHIGHPID does not mess with the lastpid counter during boot.
 399          */
 400         if (flags & RFHIGHPID)
 401                 pidchecked = 0;
 402         else
 403                 lastpid = trypid;
 404
 405         p2 = newproc;
 406         td2 = FIRST_THREAD_IN_PROC(newproc);
 407         p2->p_state = PRS_NEW;          /* protect against others */
 408         p2->p_pid = trypid;
 409         /*
 410          * Allow the scheduler to initialize the child.
 411          */
 412         thread_lock(td);
 413         sched_fork(td, td2);
 414         thread_unlock(td);
 415         AUDIT_ARG(pid, p2->p_pid);
 416         LIST_INSERT_HEAD(&allproc, p2, p_list);
 417         LIST_INSERT_HEAD(PIDHASH(p2->p_pid), p2, p_hash);
 418
 419         PROC_LOCK(p2);
 420         PROC_LOCK(p1);
 421
 422         sx_xunlock(&allproc_lock);
 423
 424         bcopy(&p1->p_startcopy, &p2->p_startcopy,
 425             __rangeof(struct proc, p_startcopy, p_endcopy));
 426         PROC_UNLOCK(p1);
 427
 428         bzero(&p2->p_startzero,
 429             __rangeof(struct proc, p_startzero, p_endzero));
 430
 431         p2->p_ucred = crhold(td->td_ucred);
 432         PROC_UNLOCK(p2);
 433
 434         /*
 435          * Malloc things while we don't hold any locks.
 436          */
 437         if (flags & RFSIGSHARE)
 438                 newsigacts = NULL;
 439         else
 440                 newsigacts = sigacts_alloc();
 441
 442         /*
 443          * Copy filedesc.
 444          */
 445         if (flags & RFCFDG) {
 446                 fd = fdinit(p1->p_fd);
 447                 fdtol = NULL;
 448         } else if (flags & RFFDG) {
 449                 fd = fdcopy(p1->p_fd);
 450                 fdtol = NULL;
 451         } else {
 452                 fd = fdshare(p1->p_fd);
 453                 if (p1->p_fdtol == NULL)
 454                         p1->p_fdtol =
 455                                 filedesc_to_leader_alloc(NULL,
 456                                                          NULL,
 457                                                          p1->p_leader);
 458                 if ((flags & RFTHREAD) != 0) {
 459                         /*
 460                          * Shared file descriptor table and
 461                          * shared process leaders.
 462                          */
 463                         fdtol = p1->p_fdtol;
 464                         FILEDESC_XLOCK(p1->p_fd);
 465                         fdtol->fdl_refcount++;
 466                         FILEDESC_XUNLOCK(p1->p_fd);
 467                 } else {
 468                         /*
 469                          * Shared file descriptor table, and
 470                          * different process leaders
 471                          */
 472                         fdtol = filedesc_to_leader_alloc(p1->p_fdtol,
 473                                                          p1->p_fd,
 474                                                          p2);
 475                 }
 476         }
 477         /*
 478          * Make a proc table entry for the new process.
 479          * Start by zeroing the section of proc that is zero-initialized,
 480          * then copy the section that is copied directly from the parent.
 481          */
 482         /* Allocate and switch to an alternate kstack if specified. */
 483         if (pages != 0)
 484                 vm_thread_new_altkstack(td2, pages);
 485
 486         PROC_LOCK(p2);
 487         PROC_LOCK(p1);
 488
 489         bzero(&td2->td_startzero,
 490             __rangeof(struct thread, td_startzero, td_endzero));
 491
 492         bcopy(&td->td_startcopy, &td2->td_startcopy,
 493             __rangeof(struct thread, td_startcopy, td_endcopy));
 494
 495         td2->td_sigstk = td->td_sigstk;
 496         td2->td_sigmask = td->td_sigmask;
 497
 498         /*
 499          * Duplicate sub-structures as needed.
 500          * Increase reference counts on shared objects.
 501          */
 502         p2->p_flag = 0;
 503         if (p1->p_flag & P_PROFIL)
 504                 startprofclock(p2);
 505         PROC_SLOCK(p2);
 506         p2->p_sflag = PS_INMEM;
 507         PROC_SUNLOCK(p2);
 508         td2->td_ucred = crhold(p2->p_ucred);
 509         pargs_hold(p2->p_args);
 510
 511         if (flags & RFSIGSHARE) {
 512                 p2->p_sigacts = sigacts_hold(p1->p_sigacts);
 513         } else {
 514                 sigacts_copy(newsigacts, p1->p_sigacts);
 515                 p2->p_sigacts = newsigacts;
 516         }
 517         if (flags & RFLINUXTHPN)
 518                 p2->p_sigparent = SIGUSR1;
 519         else
 520                 p2->p_sigparent = SIGCHLD;
 521
 522         p2->p_textvp = p1->p_textvp;
 523         p2->p_fd = fd;
 524         p2->p_fdtol = fdtol;
 525
 526         /*
 527          * p_limit is copy-on-write.  Bump its refcount.
 528          */
 529         lim_fork(p1, p2);
 530
 531         pstats_fork(p1->p_stats, p2->p_stats);
 532
 533         PROC_UNLOCK(p1);
 534         PROC_UNLOCK(p2);
 535
 536         /* Bump references to the text vnode (for procfs) */
 537         if (p2->p_textvp)
 538                 vref(p2->p_textvp);
 539
 540         /*
 541          * Set up linkage for kernel based threading.
 542          */
 543         if ((flags & RFTHREAD) != 0) {
 544                 mtx_lock(&ppeers_lock);
 545                 p2->p_peers = p1->p_peers;
 546                 p1->p_peers = p2;
 547                 p2->p_leader = p1->p_leader;
 548                 mtx_unlock(&ppeers_lock);
 549                 PROC_LOCK(p1->p_leader);
 550                 if ((p1->p_leader->p_flag & P_WEXIT) != 0) {
 551                         PROC_UNLOCK(p1->p_leader);
 552                         /*
 553                          * The task leader is exiting, so process p1 is
 554                          * going to be killed shortly.  Since p1 obviously
 555                          * isn't dead yet, we know that the leader is either
 556                          * sending SIGKILL's to all the processes in this
 557                          * task or is sleeping waiting for all the peers to
 558                          * exit.  We let p1 complete the fork, but we need
 559                          * to go ahead and kill the new process p2 since
 560                          * the task leader may not get a chance to send
 561                          * SIGKILL to it.  We leave it on the list so that
 562                          * the task leader will wait for this new process
 563                          * to commit suicide.
 564                          */
 565                         PROC_LOCK(p2);
 566                         psignal(p2, SIGKILL);
 567                         PROC_UNLOCK(p2);
 568                 } else
 569                         PROC_UNLOCK(p1->p_leader);
 570         } else {
 571                 p2->p_peers = NULL;
 572                 p2->p_leader = p2;
 573         }
 574
 575         sx_xlock(&proctree_lock);
 576         PGRP_LOCK(p1->p_pgrp);
 577         PROC_LOCK(p2);
 578         PROC_LOCK(p1);
 579
 580         /*
 581          * Preserve some more flags in subprocess.  P_PROFIL has already
 582          * been preserved.
 583          */
 584         p2->p_flag |= p1->p_flag & P_SUGID;
 585         td2->td_pflags |= td->td_pflags & TDP_ALTSTACK;
 586         SESS_LOCK(p1->p_session);
 587         if (p1->p_session->s_ttyvp != NULL && p1->p_flag & P_CONTROLT)
 588                 p2->p_flag |= P_CONTROLT;
 589         SESS_UNLOCK(p1->p_session);
 590         if (flags & RFPPWAIT)
 591                 p2->p_flag |= P_PPWAIT;
 592
 593         p2->p_pgrp = p1->p_pgrp;
 594         LIST_INSERT_AFTER(p1, p2, p_pglist);
 595         PGRP_UNLOCK(p1->p_pgrp);
 596         LIST_INIT(&p2->p_children);
 597
 598         callout_init(&p2->p_itcallout, CALLOUT_MPSAFE);
 599
 600 #ifdef KTRACE
 601         /*
 602          * Copy traceflag and tracefile if enabled.
 603          */
 604         mtx_lock(&ktrace_mtx);
 605         KASSERT(p2->p_tracevp == NULL, ("new process has a ktrace vnode"));
 606         if (p1->p_traceflag & KTRFAC_INHERIT) {
 607                 p2->p_traceflag = p1->p_traceflag;
 608                 if ((p2->p_tracevp = p1->p_tracevp) != NULL) {
 609                         VREF(p2->p_tracevp);
 610                         KASSERT(p1->p_tracecred != NULL,
 611                             ("ktrace vnode with no cred"));
 612                         p2->p_tracecred = crhold(p1->p_tracecred);
 613                 }
 614         }
 615         mtx_unlock(&ktrace_mtx);
 616 #endif
 617
 618         /*
 619          * If PF_FORK is set, the child process inherits the
 620          * procfs ioctl flags from its parent.
 621          */
 622         if (p1->p_pfsflags & PF_FORK) {
 623                 p2->p_stops = p1->p_stops;
 624                 p2->p_pfsflags = p1->p_pfsflags;
 625         }
 626
 627         /*
 628          * This begins the section where we must prevent the parent
 629          * from being swapped.
 630          */
 631         _PHOLD(p1);
 632         PROC_UNLOCK(p1);
 633
 634         /*
 635          * Attach the new process to its parent.
 636          *
 637          * If RFNOWAIT is set, the newly created process becomes a child
 638          * of init.  This effectively disassociates the child from the
 639          * parent.
 640          */
 641         if (flags & RFNOWAIT)
 642                 pptr = initproc;
 643         else
 644                 pptr = p1;
 645         p2->p_pptr = pptr;
 646         LIST_INSERT_HEAD(&pptr->p_children, p2, p_sibling);
 647         sx_xunlock(&proctree_lock);
 648
 649         /* Inform accounting that we have forked. */
 650         p2->p_acflag = AFORK;
 651         PROC_UNLOCK(p2);
 652
 653         /*
 654          * Finish creating the child process.  It will return via a different
 655          * execution path later.  (ie: directly into user mode)
 656          */
 657         vm_forkproc(td, p2, td2, flags);
 658
 659         if (flags == (RFFDG | RFPROC)) {
 660                 PCPU_INC(cnt.v_forks);
 661                 PCPU_ADD(cnt.v_forkpages, p2->p_vmspace->vm_dsize +
 662                     p2->p_vmspace->vm_ssize);
 663         } else if (flags == (RFFDG | RFPROC | RFPPWAIT | RFMEM)) {
 664                 PCPU_INC(cnt.v_vforks);
 665                 PCPU_ADD(cnt.v_vforkpages, p2->p_vmspace->vm_dsize +
 666                     p2->p_vmspace->vm_ssize);
 667         } else if (p1 == &proc0) {
 668                 PCPU_INC(cnt.v_kthreads);
 669                 PCPU_ADD(cnt.v_kthreadpages, p2->p_vmspace->vm_dsize +
 670                     p2->p_vmspace->vm_ssize);
 671         } else {
 672                 PCPU_INC(cnt.v_rforks);
 673                 PCPU_ADD(cnt.v_rforkpages, p2->p_vmspace->vm_dsize +
 674                     p2->p_vmspace->vm_ssize);
 675         }
 676
 677         /*
 678          * Both processes are set up, now check if any loadable modules want
 679          * to adjust anything.
 680          *   What if they have an error? XXX
 681          */
 682         EVENTHANDLER_INVOKE(process_fork, p1, p2, flags);
 683
 684         /*
 685          * Set the child start time and mark the process as being complete.
 686          */
 687         microuptime(&p2->p_stats->p_start);
 688         PROC_SLOCK(p2);
 689         p2->p_state = PRS_NORMAL;
 690         PROC_SUNLOCK(p2);
 691
 692         /*
 693          * If RFSTOPPED not requested, make child runnable and add to
 694          * run queue.
 695          */
 696         if ((flags & RFSTOPPED) == 0) {
 697                 thread_lock(td2);
 698                 TD_SET_CAN_RUN(td2);
 699                 sched_add(td2, SRQ_BORING);
 700                 thread_unlock(td2);
 701         }
 702
 703         /*
 704          * Now can be swapped.
 705          */
 706         PROC_LOCK(p1);
 707         _PRELE(p1);
 708
 709         /*
 710          * Tell any interested parties about the new process.
 711          */
 712         KNOTE_LOCKED(&p1->p_klist, NOTE_FORK | p2->p_pid);
 713
 714         PROC_UNLOCK(p1);
 715
 716         /*
 717          * Preserve synchronization semantics of vfork.  If waiting for
 718          * child to exec or exit, set P_PPWAIT on child, and sleep on our
 719          * proc (in case of exit).
 720          */
 721         PROC_LOCK(p2);
 722         while (p2->p_flag & P_PPWAIT)
 723                 msleep(p1, &p2->p_mtx, PWAIT, "ppwait", 0);
 724         PROC_UNLOCK(p2);
 725
 726         /*
 727          * If other threads are waiting, let them continue now.
 728          */
 729         if (p1->p_flag & P_HADTHREADS) {
 730                 PROC_LOCK(p1);
 731                 thread_single_end();
 732                 PROC_UNLOCK(p1);
 733         }
 734
 735         /*
 736          * Return child proc pointer to parent.
 737          */
 738         *procp = p2;
 739         return (0);
 740 fail:
 741         sx_sunlock(&proctree_lock);
 742         if (ppsratecheck(&lastfail, &curfail, 1))
 743                 printf("maxproc limit exceeded by uid %i, please see tuning(7) and login.conf(5).\n",
 744                     td->td_ucred->cr_ruid);
 745         sx_xunlock(&allproc_lock);
 746 #ifdef MAC
 747         mac_destroy_proc(newproc);
 748 #endif
 749         uma_zfree(proc_zone, newproc);
 750         if (p1->p_flag & P_HADTHREADS) {
 751                 PROC_LOCK(p1);
 752                 thread_single_end();
 753                 PROC_UNLOCK(p1);
 754         }
 755         pause("fork", hz / 2);
 756         return (error);
 757 }
 758
 759 /*
 760  * Handle the return of a child process from fork1().  This function
 761  * is called from the MD fork_trampoline() entry point.
 762  */
 763 void
 764 fork_exit(callout, arg, frame)
 765         void (*callout)(void *, struct trapframe *);
 766         void *arg;
 767         struct trapframe *frame;
 768 {
 769         struct proc *p;
 770         struct thread *td;
 771         struct thread *dtd;
 772
 773         td = curthread;
 774         p = td->td_proc;
 775         KASSERT(p->p_state == PRS_NORMAL, ("executing process is still new"));
 776
 777         CTR4(KTR_PROC, "fork_exit: new thread %p (kse %p, pid %d, %s)",
 778                 td, td->td_sched, p->p_pid, p->p_comm);
 779
 780         sched_fork_exit(td);
 781         /*
 782         * Processes normally resume in mi_switch() after being
 783         * cpu_switch()'ed to, but when children start up they arrive here
 784         * instead, so we must do much the same things as mi_switch() would.
 785         */
 786         if ((dtd = PCPU_GET(deadthread))) {
 787                 PCPU_SET(deadthread, NULL);
 788                 thread_stash(dtd);
 789         }
 790         thread_unlock(td);
 791
 792         /*
 793          * cpu_set_fork_handler intercepts this function call to
 794          * have this call a non-return function to stay in kernel mode.
 795          * initproc has its own fork handler, but it does return.
 796          */
 797         KASSERT(callout != NULL, ("NULL callout in fork_exit"));
 798         callout(arg, frame);
 799
 800         /*
 801          * Check if a kernel thread misbehaved and returned from its main
 802          * function.
 803          */
 804         if (p->p_flag & P_KTHREAD) {
 805                 printf("Kernel thread \"%s\" (pid %d) exited prematurely.\n",
 806                     p->p_comm, p->p_pid);
 807                 kthread_exit(0);
 808         }
 809         mtx_assert(&Giant, MA_NOTOWNED);
 810
 811         EVENTHANDLER_INVOKE(schedtail, p);
 812 }
 813
 814 /*
 815  * Simplified back end of syscall(), used when returning from fork()
 816  * directly into user mode.  Giant is not held on entry, and must not
 817  * be held on return.  This function is passed in to fork_exit() as the
 818  * first parameter and is called when returning to a new userland process.
 819  */
 820 void
 821 fork_return(td, frame)
 822         struct thread *td;
 823         struct trapframe *frame;
 824 {
 825
 826         userret(td, frame);
 827 #ifdef KTRACE
 828         if (KTRPOINT(td, KTR_SYSRET))
 829                 ktrsysret(SYS_fork, 0, 0);
 830 #endif
 831         mtx_assert(&Giant, MA_NOTOWNED);
 832 }