sys/sys/proc.h

   1 /*-
   2  * Copyright (c) 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  * 3. 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 #ifndef _SYS_PROC_H_
  35 #define _SYS_PROC_H_
  36
  37 #if !defined(_KERNEL) && !defined(_KERNEL_STRUCTURES)
  38
  39 #error "Userland must include sys/user.h instead of sys/proc.h"
  40
  41 #else
  42
  43 #include <sys/callout.h>                /* For struct callout. */
  44 #include <sys/cpumask.h>
  45 #include <sys/filedesc.h>
  46 #include <sys/queue.h>
  47 #include <sys/tree.h>
  48 #include <sys/rtprio.h>                 /* For struct rtprio. */
  49 #include <sys/signal.h>
  50 #include <sys/lock.h>
  51 #include <sys/upmap.h>
  52 #ifndef _KERNEL
  53 #include <sys/time.h>                   /* For structs itimerval, timeval. */
  54 #endif
  55 #include <sys/ucred.h>
  56 #include <sys/event.h>                  /* For struct klist */
  57 #include <sys/eventvar.h>
  58 #include <sys/sysent.h>                 /* For struct sysentvec */
  59 #include <sys/thread.h>
  60 #include <sys/varsym.h>
  61 #include <sys/resourcevar.h>
  62 #ifdef _KERNEL
  63 #include <sys/procctl.h>
  64 #include <sys/globaldata.h>
  65 #endif
  66 #include <sys/systimer.h>
  67 #include <sys/iosched.h>
  68 #include <sys/usched.h>
  69 #include <machine/proc.h>               /* Machine-dependent proc substruct. */
  70 #include <machine/atomic.h>             /* Machine-dependent proc substruct. */
  71 #include <sys/signalvar.h>
  72
  73 struct proc;
  74 struct pgrp;
  75 struct session;
  76 struct lwp;
  77 struct uidcount;
  78 struct procglob;
  79 struct vm_map_backing;
  80
  81 LIST_HEAD(proclist, proc);
  82 LIST_HEAD(pgrplist, pgrp);
  83 LIST_HEAD(sesslist, session);
  84 LIST_HEAD(lwplist, lwp);
  85
  86 struct lwp_rb_tree;
  87 RB_HEAD(lwp_rb_tree, lwp);
  88 RB_PROTOTYPE2(lwp_rb_tree, lwp, u.lwp_rbnode, rb_lwp_compare, lwpid_t);
  89
  90 /*
  91  * One structure allocated per session.
  92  */
  93 struct  session {
  94         LIST_ENTRY(session) s_list;     /* Hash chain. */
  95         int     s_count;                /* Ref cnt; pgrps in session. */
  96         struct  procglob *s_prg;
  97         struct  proc *s_leader;         /* Session leader. */
  98         struct  vnode *s_ttyvp;         /* Vnode of controlling terminal. */
  99         struct  tty *s_ttyp;            /* Controlling terminal. */
 100         pid_t   s_sid;                  /* Session ID */
 101         char    s_login[roundup(MAXLOGNAME, sizeof(long))];     /* Setlogin() name. */
 102 };
 103
 104 /*
 105  * One structure allocated per process group.
 106  */
 107 struct  pgrp {
 108         LIST_ENTRY(pgrp) pg_list;       /* Hash chain. */
 109         struct proclist pg_members;     /* Pointer to pgrp members. */
 110         struct  session *pg_session;    /* Pointer to session. */
 111         struct  sigiolst pg_sigiolst;   /* List of sigio sources. */
 112         pid_t   pg_id;                  /* Pgrp id. */
 113         int     pg_jobc;        /* # procs qualifying pgrp for job control */
 114         u_int   pg_refs;
 115         struct lwkt_token pg_token;
 116         struct lock pg_lock;
 117 };
 118
 119 #define PS_NOCLDWAIT    0x0001  /* No zombies if child dies */
 120 #define PS_NOCLDSTOP    0x0002  /* No SIGCHLD when children stop. */
 121 #define PS_CLDSIGIGN    0x0004  /* The SIGCHLD handler is SIG_IGN. */
 122
 123 /*
 124  * pargs, used to hold a copy of the command line, if it had a sane
 125  * length
 126  */
 127 struct  pargs {
 128         u_int   ar_ref;         /* Reference count */
 129         u_int   ar_length;      /* Length */
 130         u_char  ar_args[0];     /* Arguments */
 131 };
 132
 133 /*
 134  * Description of a process.
 135  *
 136  * This structure contains the information needed to manage a thread of
 137  * control, known in UN*X as a process; it has references to substructures
 138  * containing descriptions of things that the process uses, but may share
 139  * with related processes.  The process structure and the substructures
 140  * are always addressable except for those marked "(PROC ONLY)" below,
 141  * which might be addressable only on a processor on which the process
 142  * is running.
 143  *
 144  * NOTE!  The process start time is stored in the thread structure associated
 145  * with the process.  If the process is a Zombie, then this field will be
 146  * inaccessible due to the thread structure being free'd in kern_wait1().
 147  */
 148
 149 struct jail;
 150 struct vkernel_proc;
 151 struct vkernel_lwp;
 152 struct vmspace_entry;
 153 struct ktrace_node;
 154 struct sem_undo;
 155
 156 enum lwpstat {
 157         LSRUN = 1,
 158         LSSTOP = 2,
 159         LSSLEEP = 3,
 160 };
 161
 162 enum procstat {
 163         SIDL = 1,
 164         SACTIVE = 2,
 165         SSTOP = 3,
 166         SZOMB = 4,
 167         SCORE = 5,
 168 };
 169
 170 struct lwp {
 171         TAILQ_ENTRY(lwp) lwp_procq;     /* run/sleep queue. */
 172         union {
 173             RB_ENTRY(lwp)       lwp_rbnode;     /* RB tree node - lwp in proc */
 174             LIST_ENTRY(lwp)     lwp_reap_entry; /* reaper list */
 175         } u;
 176
 177         struct proc     *lwp_proc;      /* Link to our proc. */
 178         struct vmspace  *lwp_vmspace;   /* Inherited from p_vmspace */
 179         struct vkernel_lwp *lwp_vkernel;/* VKernel support, lwp part */
 180
 181         lwpid_t         lwp_tid;        /* Our thread id, >= 1 */
 182
 183         u_int           lwp_flags;      /* LWP_*    flags */
 184         u_int           lwp_mpflags;    /* LWP_MP_* flags */
 185         enum lwpstat    lwp_stat;       /* LS* lwp status */
 186         int             lwp_lock;       /* lwp lock (prevent destruct) count */
 187
 188         int             lwp_dupfd;      /* Sideways return value from fdopen */
 189
 190         /*
 191          * The following two fields are marked XXX since (at least) the
 192          * 4.4BSD-Lite2 import.  I can only guess the reason:  It is ugly.
 193          * These fields are used to pass the trap code from trapsignal() to
 194          * postsig(), which gets called later from userret().
 195          *
 196          * The correct "fix" for these XXX is to convert our signal system
 197          * to use signal queues, where each signal can carry its own meta
 198          * data.
 199          */
 200         int             lwp_sig;        /* for core dump/debugger XXX */
 201         u_long          lwp_code;       /* for core dump/debugger XXX */
 202
 203         /*
 204          * Scheduling.
 205          */
 206         sysclock_t      lwp_cpticks;    /* cpu used in sched clock ticks */
 207         sysclock_t      lwp_cpbase;     /* Measurement base */
 208         fixpt_t         lwp_pctcpu;     /* %cpu for this process */
 209         u_int           lwp_slptime;    /* Time since last blocked. */
 210         u_int           lwp_rebal_ticks; /* Timestamp sched on current cpu */
 211
 212         int             lwp_traceflag;  /* Kernel trace points. */
 213
 214         struct rusage   lwp_ru;         /* stats for this lwp */
 215
 216         union usched_data lwp_usdata;   /* User scheduler specific */
 217
 218 #define lwp_startcopy   lwp_cpumask
 219         cpumask_t       lwp_cpumask;
 220         sigset_t        lwp_siglist;    /* Signals arrived but not delivered. */
 221         sigset_t        lwp_oldsigmask; /* saved mask from before sigpause */
 222         sigset_t        lwp_sigmask;    /* Current signal mask. */
 223         stack_t         lwp_sigstk;     /* sp & on stack state variable */
 224
 225         struct rtprio   lwp_rtprio;     /* Realtime priority. */
 226 #define lwp_endcopy     lwp_md
 227
 228         struct mdproc   lwp_md;         /* Any machine-dependent fields. */
 229
 230         struct thread   *lwp_thread;    /* backpointer to proc's thread */
 231         struct sys_lpmap *lwp_lpmap;    /* user RW mappable per-thread page */
 232         struct kqueue   lwp_kqueue;     /* for select/poll */
 233         uint64_t        lwp_kqueue_serial; /* for select/poll */
 234         struct lwkt_token lwp_token;    /* per-lwp token for signal/state */
 235         struct spinlock lwp_spin;       /* spinlock for signal handling */
 236         TAILQ_HEAD(, vm_map_backing) lwp_lpmap_backing_list;
 237         void            *lwp_reserveds2; /* reserved for lwp_saveupc */
 238 };
 239
 240 struct  proc {
 241         LIST_ENTRY(proc) p_list;        /* List of all processes. */
 242
 243         /* substructures: */
 244         struct ucred    *p_ucred;       /* Process owner's identity. */
 245         struct filedesc *p_fd;          /* Ptr to open files structure. */
 246         struct filedesc_to_leader *p_fdtol; /* Ptr to tracking node XXX lwp */
 247         struct plimit   *p_limit;       /* Process limits. */
 248         struct pstats   *p_stats;
 249         u_int           p_mqueue_cnt;   /* Count of open mqueues. */
 250         long            p_waitgen;      /* wait interlock allows late signal */
 251         struct sigacts  *p_sigacts;
 252 #define p_sigignore     p_sigacts->ps_sigignore
 253 #define p_sigcatch      p_sigacts->ps_sigcatch
 254 #define p_rlimit        p_limit->pl_rlimit
 255
 256         int             p_flags;        /* P_* flags. */
 257         enum procstat   p_stat;         /* S* process status. */
 258         char            p_advlock_flag; /* replaces P_ADVLOCK */
 259         char            p_pad1[2];
 260
 261         pid_t           p_pid;          /* Process identifier. */
 262         pid_t           p_ppid;         /* Current parent pid */
 263         LIST_ENTRY(proc) p_pglist;      /* List of processes in pgrp. */
 264         struct proc     *p_pptr;        /* Pointer to parent process. */
 265         LIST_ENTRY(proc) p_sibling;     /* List of sibling processes. */
 266         struct proclist p_children;     /* Pointer to list of children. */
 267         struct callout  p_ithandle;     /* for scheduling p_realtimer */
 268         struct varsymset p_varsymset;
 269         struct iosched_data p_iosdata;  /* Dynamic I/O scheduling data */
 270
 271         pid_t           p_oppid;        /* Save parent pid during ptrace. XXX */
 272
 273         struct vmspace  *p_vmspace;     /* Current address space. */
 274
 275         unsigned int    p_swtime;       /* Time swapped in or out */
 276
 277         struct itimerval p_realtimer;   /* Alarm timer. */
 278         struct itimerval p_timer[3];    /* Virtual-time timers. */
 279
 280         int             p_traceflag;    /* Kernel trace points. */
 281         struct ktrace_node *p_tracenode; /* Trace to vnode. */
 282
 283         sigset_t        p_siglist;      /* Signals arrived but not delivered. */
 284
 285         struct vnode    *p_textvp;      /* Vnode of executable. */
 286         struct nchandle p_textnch;      /* namecache handle of executable. */
 287
 288         unsigned int    p_stops;        /* procfs event bitmask */
 289         unsigned int    p_stype;        /* procfs stop event type */
 290         char            p_step;         /* procfs stop *once* flag */
 291         unsigned char   p_pfsflags;     /* procfs flags */
 292         char            p_pad2[2];
 293         struct          sigiolst p_sigiolst;    /* list of sigio sources */
 294         int             p_sigparent;    /* signal to parent on exit */
 295         struct klist    p_klist;        /* knotes attached to this process */
 296
 297         struct timeval  p_start;        /* start time for a process */
 298
 299         struct rusage   p_ru;           /* stats for this proc */
 300         struct rusage   p_cru;          /* sum of stats for reaped children */
 301         void            *p_linux_mm;    /* helper for drm */
 302
 303 /* The following fields are all copied upon creation in fork. */
 304 #define p_startcopy     p_comm
 305
 306         char            p_comm[MAXCOMLEN+1]; /* typ 16+1 bytes */
 307         char            p_pad3;
 308         char            p_nice;         /* Process "nice" value. */
 309         char            p_pad4;
 310         int             p_osrel;        /* release date for binary ELF note */
 311
 312         struct pgrp     *p_pgrp;        /* Pointer to process group. */
 313
 314         struct sysentvec *p_sysent;     /* System call dispatch information. */
 315
 316         struct uprof    p_prof;         /* Profiling arguments. */
 317         struct rtprio   p_rtprio;       /* Realtime priority. */
 318         struct pargs    *p_args;
 319         u_short         p_xstat;        /* Exit status or last stop signal */
 320         u_short         p_depth;        /* Used to downscale resource limits */
 321
 322         int             p_ionice;
 323         void            *p_unused02;
 324 /* End area that is copied on creation. */
 325 #define p_endcopy       p_unused02
 326         u_short         p_acflag;       /* Accounting flags. */
 327
 328         int             p_lock;         /* Prevent proc destruction */
 329         int             p_nthreads;     /* Number of threads in this process. */
 330         int             p_nstopped;     /* Number of stopped threads. */
 331         int             p_lasttid;      /* Last tid used. */
 332         struct lwp_rb_tree p_lwp_tree;  /* RB tree of LWPs for this process */
 333         void            *p_aioinfo;     /* ASYNC I/O info */
 334         int             p_wakeup;       /* thread id XXX lwp */
 335         struct proc     *p_peers;       /* XXX lwp */
 336         struct proc     *p_leader;      /* XXX lwp */
 337         void            *p_emuldata;    /* process-specific emulator state */
 338         struct usched   *p_usched;      /* Userland scheduling control */
 339         struct vkernel_proc *p_vkernel; /* VKernel support, proc part */
 340         struct uidcount *p_uidpcpu;
 341         void            (*p_userret)(void);/* p: return-to-user hook */
 342
 343         struct spinlock p_spin;         /* Spinlock for LWP access to proc */
 344         struct lwkt_token p_token;      /* Token for LWP access to proc */
 345         struct sem_undo *p_sem_undo;    /* Fast semaphore tracking lookup */
 346         void            *p_drv_priv;    /* scp linkage (for syscons) */
 347         void            *p_vmm;
 348         cpulock_t       p_vmm_cpulock;  /* count cpus in and kickout lock */
 349         cpumask_t       p_vmm_cpumask;  /* cpus entering or in vmm */
 350         struct sys_upmap *p_upmap;      /* user RW mappable per-process page */
 351         forkid_t        p_forkid;       /* unique forkid */
 352         struct sysreaper *p_reaper;     /* reaper control */
 353         void            *p_reserveds[3]; /* reserved for future */
 354 };
 355
 356 #define lwp_wchan       lwp_thread->td_wchan
 357 #define lwp_wmesg       lwp_thread->td_wmesg
 358 #define p_session       p_pgrp->pg_session
 359 #define p_pgid          p_pgrp->pg_id
 360
 361 /* These flags are kept in p_flags. */
 362 #define P_UNUSED00      0x00001 /* was: Process may hold a POSIX advisory lock */
 363 #define P_CONTROLT      0x00002 /* Has a controlling terminal */
 364 #define P_SWAPPEDOUT    0x00004 /* Swapped out of memory */
 365 #define P_SYSVSEM       0x00008 /* Might have SysV semaphores */
 366 #define P_PPWAIT        0x00010 /* Parent is waiting for child to exec/exit */
 367 #define P_PROFIL        0x00020 /* Has started profiling */
 368 #define P_POSTEXIT      0x00040 /* Prevent procfs from stepping after this pt */
 369 #define P_SCMOUSE       0x00080 /* Process is held by syscons ioctl */
 370                                 /* was: Sleep is interruptible */
 371 #define P_SUGID         0x00100 /* Had set id privileges since last exec */
 372 #define P_SYSTEM        0x00200 /* System proc: no sigs, stats or swapping */
 373 #define P_MAYBETHREADED 0x00400 /* might be threaded optimization */
 374 #define P_TRACED        0x00800 /* Debugged process being traced */
 375 #define P_WAITED        0x01000 /* SIGSTOP status was returned by wait3/4 */
 376 #define P_WEXIT         0x02000 /* Working on exiting (master exit) */
 377 #define P_EXEC          0x04000 /* Process called exec */
 378 #define P_CONTINUED     0x08000 /* Proc has continued from a stopped state */
 379
 380 #define P_LOWMEMKILL    0x00010000 /* trying to kill due to low memory */
 381 #define P_UNUSED17      0x00020000
 382
 383 #define P_SWAPWAIT      0x00040000 /* Waiting for a swapin */
 384 #define P_UNUSED19      0x00080000 /* was: Now in a zombied state */
 385
 386 /* Marked a kernel thread */
 387 #define P_UNUSED20      0x00100000 /* was: on a user scheduling run queue */
 388 #define P_UNUSED21      0x00200000 /* was: Process is really a kernel thread */
 389 #define P_IDLESWAP      0x00400000 /* Swapout was due to idleswap, not load */
 390
 391 #define P_JAILED        0x01000000 /* Process is in jail */
 392 #define P_SIGVTALRM     0x02000000 /* signal SIGVTALRM pending due to itimer */
 393 #define P_SIGPROF       0x04000000 /* signal SIGPROF pending due to itimer */
 394 #define P_INEXEC        0x08000000 /* Process is in execve(). */
 395 #define P_DIDCHROOT     0x10000000 /* Did at least one chroot */
 396 #define P_UNUSED29      0x20000000
 397 #define P_XCPU          0x40000000 /* SIGXCPU */
 398
 399 #define LWP_ALTSTACK    0x0000001 /* have alternate signal stack */
 400 #define LWP_OLDMASK     0x0000002 /* need to restore mask before pause */
 401 #define LWP_SINTR       0x0000008 /* Sleep is interruptible. */
 402 #define LWP_SELECT      0x0000010 /* Selecting; wakeup/waiting danger. */
 403 #define LWP_UNUSED20    0x0000020
 404 #define LWP_UNUSED40    0x0000040
 405 #define LWP_UNUSED80    0x0000080
 406 #define LWP_PASSIVE_ACQ 0x0000100 /* Passive acquire cpu (see kern_switch) */
 407 #define LWP_PAGING      0x0000200 /* Currently in vm_fault */
 408
 409 /*
 410  * LWP_MP_WSTOP: When set the thread will stop prior to return to userland
 411  *            and has been counted in the process stop-threads-count, but
 412  *            may still be running in kernel-land.
 413  *
 414  * LWP_MP_WEXIT: When set the thread has been asked to exit and will not return
 415  *            to userland.  p_nthreads will not be decremented until the
 416  *            thread has actually exited.
 417  */
 418 #define LWP_MP_ONRUNQ   0x0000001 /* on a user scheduling run queue */
 419 #define LWP_MP_WEXIT    0x0000002 /* working on exiting (lwpuserret()) */
 420 #define LWP_MP_WSTOP    0x0000004 /* working on stopping */
 421 #define LWP_MP_ULOAD    0x0000008 /* uload accounting for current cpu */
 422 #define LWP_MP_RRFORCE  0x0000010 /* forced resched due to rrcount */
 423 #define LWP_MP_VNLRU    0x0000020 /* check excessive vnode allocations (lwpuserret()) */
 424
 425 #define LWP_MP_URETMASK (LWP_MP_WEXIT | LWP_MP_VNLRU)
 426
 427 #define FIRST_LWP_IN_PROC(p)            RB_FIRST(lwp_rb_tree, &(p)->p_lwp_tree)
 428 #define FOREACH_LWP_IN_PROC(lp, p)      \
 429         RB_FOREACH(lp, lwp_rb_tree, &(p)->p_lwp_tree)
 430 #define ONLY_LWP_IN_PROC(p)             _only_lwp_in_proc(p, __func__)
 431
 432 struct procglob {
 433         struct lwkt_token proc_token;
 434         struct proclist allproc;        /* locked by proc_token */
 435         struct pgrplist allpgrp;        /* locked by proc_token */
 436         struct sesslist allsess;        /* locked by proc_token */
 437         void    *pad01;                 /* pad for clarity */
 438 } __cachealign;
 439
 440 #ifdef _KERNEL
 441 static inline struct lwp *
 442 _only_lwp_in_proc(struct proc *p, const char *caller)
 443 {
 444         if (p->p_nthreads != 1) {
 445                 panic("%s: proc %p (pid %d cmd %s) has more than one thread",
 446                     caller, p, p->p_pid, p->p_comm);
 447         }
 448         return RB_ROOT(&p->p_lwp_tree);
 449 }
 450 #endif
 451
 452 /*
 453  * We use process IDs <= PID_MAX.  NO_PID must also fit in a pid_t and
 454  * is used to represent "no process group".
 455  */
 456 #define PID_MAX         999999
 457 #define NO_PID          0x7FFFFFFF
 458
 459 #define SESS_LEADER(p)  ((p)->p_session->s_leader == (p))
 460
 461 #ifdef _KERNEL
 462
 463 #ifdef MALLOC_DECLARE
 464 MALLOC_DECLARE(M_SESSION);
 465 MALLOC_DECLARE(M_PROC);
 466 MALLOC_DECLARE(M_LWP);
 467 MALLOC_DECLARE(M_SUBPROC);
 468 MALLOC_DECLARE(M_PARGS);
 469 #endif
 470
 471 /* for priv_check_cred() */
 472 #define NULL_CRED_OKAY  0x2
 473
 474 /*
 475  * Handy macro to determine if p1 can mangle p2.
 476  *
 477  * Must be spin-safe.
 478  */
 479 #define PRISON_CHECK(cr1, cr2) \
 480         ((!(cr1)->cr_prison) || (cr1)->cr_prison == (cr2)->cr_prison)
 481
 482 /*
 483  * STOPEVENT
 484  */
 485 extern void stopevent(struct proc*, unsigned int, unsigned int);
 486 #define STOPEVENT(p,e,v)                        \
 487         do {                                    \
 488                 if ((p)->p_stops & (e)) {       \
 489                         stopevent(p,e,v);       \
 490                 }                               \
 491         } while (0)
 492
 493 /*
 494  * Hold process in memory, don't destruct, used by ktrace, procfs, sigio,
 495  * and signaling code (e.g. ksignal()).
 496  *
 497  * MPSAFE
 498  */
 499 #define PHOLD(p)        phold((p))
 500 #define PRELE(p)        prele((p))
 501 #define PHOLDZOMB(p)    pholdzomb((p))
 502 #define PRELEZOMB(p)    prelezomb((p))
 503 #define PSTALL(p, msg, n) \
 504         do { if ((p)->p_lock > (n)) pstall((p), (msg), (n)); } while (0)
 505
 506 #define STOPLWP(p, lp)                                          \
 507         (((p)->p_stat == SSTOP || (p)->p_stat == SCORE) &&      \
 508          ((lp)->lwp_mpflags & LWP_MP_WEXIT) == 0)
 509
 510 /*
 511  * Hold lwp in memory, don't destruct, normally for ptrace/procfs work
 512  * atomic ops because they can occur from an IPI.
 513  * MPSAFE
 514  */
 515 #define LWPHOLD(lp)     atomic_add_int(&(lp)->lwp_lock, 1)
 516 #define LWPRELE(lp)     atomic_add_int(&(lp)->lwp_lock, -1)
 517
 518 extern struct proc proc0;               /* Process slot for swapper. */
 519 extern struct lwp lwp0;                 /* LWP slot for swapper. */
 520 extern struct thread thread0;           /* Thread slot for swapper. */
 521 extern int nprocs, maxproc;             /* Current and max number of procs. */
 522 extern int maxprocperuid;               /* Max procs per uid. */
 523
 524 extern struct proc *initproc;           /* Process slot for init */
 525 extern struct thread *pagethread;
 526 extern struct thread *emergpager;
 527 extern struct thread *updatethread;
 528
 529 /*
 530  * Scheduler independant variables.  The primary scheduler polling frequency,
 531  * the maximum ESTCPU value, and the weighting factor for nice values.  A
 532  * cpu bound program's estcpu will increase to ESTCPUMAX - 1.
 533  */
 534 #define ESTCPUFREQ      50
 535
 536 extern  u_long ps_arg_cache_limit;
 537 extern  int ps_argsopen;
 538 extern  int ps_showallprocs;
 539
 540 struct lwp *lwpfind (struct proc *, lwpid_t);   /* Find thread in process */
 541 struct proc *pfind (pid_t);     /* Find process by id w/ref */
 542 struct proc *pfindn (pid_t);    /* Find process by id wo/ref */
 543 struct pgrp *pgfind (pid_t);    /* Find process group by id w/ref */
 544 struct proc *zpfind (pid_t);    /* Find zombie process by id w/ref */
 545 void pgref (struct pgrp *);     /* Ref pgrp preventing disposal */
 546 void pgrel (struct pgrp *);     /* Deref pgrp & dispose on 1->0 trans */
 547
 548 struct globaldata;
 549 struct lwp_params;
 550
 551 int     enterpgrp (struct proc *p, pid_t pgid, int mksess);
 552 void    proc_add_allproc(struct proc *p);
 553 void    proc_move_allproc_zombie(struct proc *);
 554 void    proc_remove_zombie(struct proc *);
 555 void    allproc_scan(int (*callback)(struct proc *, void *), void *data,
 556                         int segmented);
 557 void    alllwp_scan(int (*callback)(struct lwp *, void *), void *data,
 558                         int segmented);
 559 void    zombproc_scan(int (*callback)(struct proc *, void *), void *data);
 560 void    fixjobc (struct proc *p, struct pgrp *pgrp, int entering);
 561 void    updatepcpu(struct lwp *, int, int);
 562 int     inferior (struct proc *p);
 563 int     leavepgrp (struct proc *p);
 564 void    sess_hold(struct session *sp);
 565 void    sess_rele(struct session *sp);
 566 void    procinit (void);
 567 void    procinsertinit(struct proc *p);
 568 void    sessinsertinit(struct session *sess);
 569 void    pgrpinsertinit(struct pgrp *pg);
 570 void    relscurproc(struct proc *curp);
 571 int     p_trespass (struct ucred *cr1, struct ucred *cr2);
 572 void    setrunnable (struct lwp *);
 573 void    proc_stop (struct proc *, int);
 574 void    proc_unstop (struct proc *, int);
 575 void    sleep_early_gdinit (struct globaldata *);
 576 void    sleep_gdinit (struct globaldata *);
 577 thread_t cpu_heavy_switch (struct thread *);
 578 thread_t cpu_lwkt_switch (struct thread *);
 579
 580 void    cpu_lwp_exit (void) __dead2;
 581 void    cpu_thread_exit (void) __dead2;
 582 void    lwp_exit (int masterexit, void *waddr) __dead2;
 583 void    lwp_dispose (struct lwp *);
 584 int     killalllwps (int);
 585 void    exit1 (int) __dead2;
 586 void    cpu_fork (struct lwp *, struct lwp *, int);
 587 int     cpu_prepare_lwp(struct lwp *, struct lwp_params *);
 588 void    cpu_set_fork_handler (struct lwp *, void (*)(void *, struct trapframe *), void *);
 589 void    cpu_set_thread_handler(struct thread *td, void (*retfunc)(void), void *func, void *arg);
 590 int     fork1 (struct lwp *, int, struct proc **);
 591 void    start_forked_proc (struct lwp *, struct proc *);
 592 int     trace_req (struct proc *);
 593 void    cpu_thread_wait (struct thread *);
 594 void    setsugid (void);
 595 void    faultin (struct proc *p);
 596 void    swapin_request (void);
 597 void    phold (struct proc *);
 598 void    prele (struct proc *);
 599 int     pholdzomb (struct proc *);
 600 void    prelezomb (struct proc *);
 601 void    pstall (struct proc *, const char *, int);
 602 void    lwpuserret(struct lwp *);
 603 void    lwpkthreaddeferred(void);
 604 void    lwp_usermap(struct lwp *lp, int invfork);
 605 void    lwp_userunmap(struct lwp *lp);
 606 void    proc_usermap(struct proc *p, int invfork);
 607 void    proc_userunmap(struct proc *p);
 608 void    reaper_hold(struct sysreaper *reap);
 609 void    reaper_drop(struct sysreaper *reap);
 610 int     reaper_sigtest(struct proc *sender, struct proc *target, int reaper_ok);
 611 struct sysreaper *reaper_exit(struct proc *p);
 612 void    reaper_init(struct proc *p, struct sysreaper *reap);
 613 struct proc *reaper_get(struct sysreaper *reap);
 614
 615 u_int32_t       procrunnable (void);
 616
 617 #endif  /* _KERNEL */
 618
 619 #endif  /* _KERNEL || _KERNEL_STRUCTURES */
 620 #endif  /* !_SYS_PROC_H_ */