Annotation of Net2/sys/param.h, revision 1.1.1.1

1.1       root        1: /*-
                      2:  * Copyright (c) 1982, 1986, 1989 The Regents of the University of California.
                      3:  * All rights reserved.
                      4:  *
                      5:  * Redistribution and use in source and binary forms, with or without
                      6:  * modification, are permitted provided that the following conditions
                      7:  * are met:
                      8:  * 1. Redistributions of source code must retain the above copyright
                      9:  *    notice, this list of conditions and the following disclaimer.
                     10:  * 2. Redistributions in binary form must reproduce the above copyright
                     11:  *    notice, this list of conditions and the following disclaimer in the
                     12:  *    documentation and/or other materials provided with the distribution.
                     13:  * 3. All advertising materials mentioning features or use of this software
                     14:  *    must display the following acknowledgement:
                     15:  *     This product includes software developed by the University of
                     16:  *     California, Berkeley and its contributors.
                     17:  * 4. Neither the name of the University nor the names of its contributors
                     18:  *    may be used to endorse or promote products derived from this software
                     19:  *    without specific prior written permission.
                     20:  *
                     21:  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     22:  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     23:  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     24:  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     25:  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     26:  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     27:  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     28:  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     29:  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     30:  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     31:  * SUCH DAMAGE.
                     32:  *
                     33:  *     @(#)param.h     7.23 (Berkeley) 5/6/91
                     34:  */
                     35: 
                     36: #define        BSD     199103          /* March, 1991 system version (year & month) */
                     37: #define BSD4_3 1
                     38: #define BSD4_4 0.5
                     39: 
                     40: #ifndef NULL
                     41: #define        NULL    0
                     42: #endif
                     43: 
                     44: #ifndef LOCORE
                     45: #include <sys/types.h>
                     46: #endif
                     47: 
                     48: /*
                     49:  * Machine-independent constants (some used in following include files).
                     50:  * Redefined constants are from POSIX 1003.1 limits file.
                     51:  *
                     52:  * MAXCOMLEN should be >= sizeof(ac_comm) (see <acct.h>)
                     53:  * MAXLOGNAME should be >= UT_NAMESIZE (see <utmp.h>)
                     54:  */
                     55: #include <sys/syslimits.h>
                     56: 
                     57: #define        MAXCOMLEN       16              /* max command name remembered */
                     58: #define        MAXINTERP       32              /* max interpreter file name length */
                     59: #define        MAXLOGNAME      12              /* max login name length */
                     60: #define        MAXUPRC         CHILD_MAX       /* max simultaneous processes */
                     61: #define        NCARGS          ARG_MAX         /* max bytes for an exec function */
                     62: #define        NGROUPS         NGROUPS_MAX     /* max number groups */
                     63: #define        NOFILE          OPEN_MAX        /* max open files per process */
                     64: #define        NOGROUP         65535           /* marker for empty group set member */
                     65: #define MAXHOSTNAMELEN 256             /* max hostname size */
                     66: 
                     67: /* More types and definitions used throughout the kernel. */
                     68: #ifdef KERNEL
                     69: #include <sys/cdefs.h>
                     70: #include <sys/errno.h>
                     71: #include <sys/time.h>
                     72: #include <sys/resource.h>
                     73: #include <sys/ucred.h>
                     74: #include <sys/uio.h>
                     75: #endif
                     76: 
                     77: /* Signals. */
                     78: #include <sys/signal.h>
                     79: 
                     80: /* Machine type dependent parameters. */
                     81: #include <machine/param.h>
                     82: #include <machine/endian.h>
                     83: #include <machine/limits.h>
                     84: 
                     85: /*
                     86:  * Priorities.  Note that with 32 run queues, differences less than 4 are
                     87:  * insignificant.
                     88:  */
                     89: #define        PSWP    0
                     90: #define        PVM     4
                     91: #define        PINOD   8
                     92: #define        PRIBIO  16
                     93: #define        PVFS    20
                     94: #define        PZERO   22              /* No longer magic, shouldn't be here.  XXX */
                     95: #define        PSOCK   24
                     96: #define        PWAIT   32
                     97: #define        PLOCK   36
                     98: #define        PPAUSE  40
                     99: #define        PUSER   50
                    100: #define        MAXPRI  127             /* Priorities range from 0 through MAXPRI. */
                    101: 
                    102: #define        PRIMASK 0x0ff
                    103: #define        PCATCH  0x100           /* OR'd with pri for tsleep to check signals */
                    104: 
                    105: #define        NZERO   0               /* default "nice" */
                    106: 
                    107: #define        NBPW    sizeof(int)     /* number of bytes per word (integer) */
                    108: 
                    109: #define        CMASK   022             /* default file mask: S_IWGRP|S_IWOTH */
                    110: #define        NODEV   (dev_t)(-1)     /* non-existent device */
                    111: 
                    112: /*
                    113:  * Clustering of hardware pages on machines with ridiculously small
                    114:  * page sizes is done here.  The paging subsystem deals with units of
                    115:  * CLSIZE pte's describing NBPG (from machine/machparam.h) pages each.
                    116:  */
                    117: #define        CLBYTES         (CLSIZE*NBPG)
                    118: #define        CLOFSET         (CLSIZE*NBPG-1) /* for clusters, like PGOFSET */
                    119: #define        claligned(x)    ((((int)(x))&CLOFSET)==0)
                    120: #define        CLOFF           CLOFSET
                    121: #define        CLSHIFT         (PGSHIFT+CLSIZELOG2)
                    122: 
                    123: #if CLSIZE==1
                    124: #define        clbase(i)       (i)
                    125: #define        clrnd(i)        (i)
                    126: #else
                    127: /* Give the base virtual address (first of CLSIZE). */
                    128: #define        clbase(i)       ((i) &~ (CLSIZE-1))
                    129: /* Round a number of clicks up to a whole cluster. */
                    130: #define        clrnd(i)        (((i) + (CLSIZE-1)) &~ (CLSIZE-1))
                    131: #endif
                    132: 
                    133: #define        CBLOCK  64              /* Clist block size, must be a power of 2. */
                    134: #define CBQSIZE        (CBLOCK/NBBY)   /* Quote bytes/cblock - can do better. */
                    135:                                /* Data chars/clist. */
                    136: #define        CBSIZE  (CBLOCK - sizeof(struct cblock *) - CBQSIZE)
                    137: #define        CROUND  (CBLOCK - 1)    /* Clist rounding. */
                    138: 
                    139: /*
                    140:  * File system parameters and macros.
                    141:  *
                    142:  * The file system is made out of blocks of at most MAXBSIZE units, with
                    143:  * smaller units (fragments) only in the last direct block.  MAXBSIZE
                    144:  * primarily determines the size of buffers in the buffer pool.  It may be
                    145:  * made larger without any effect on existing file systems; however making
                    146:  * it smaller make make some file systems unmountable.
                    147:  */
                    148: #define        MAXBSIZE        8192
                    149: #define MAXFRAG        8
                    150: 
                    151: /*
                    152:  * MAXPATHLEN defines the longest permissable path length after expanding
                    153:  * symbolic links. It is used to allocate a temporary buffer from the buffer
                    154:  * pool in which to do the name expansion, hence should be a power of two,
                    155:  * and must be less than or equal to MAXBSIZE.  MAXSYMLINKS defines the
                    156:  * maximum number of symbolic links that may be expanded in a path name.
                    157:  * It should be set high enough to allow all legitimate uses, but halt
                    158:  * infinite loops reasonably quickly.
                    159:  */
                    160: #define        MAXPATHLEN      PATH_MAX
                    161: #define MAXSYMLINKS    8
                    162: 
                    163: /* Bit map related macros. */
                    164: #define        setbit(a,i)     ((a)[(i)/NBBY] |= 1<<((i)%NBBY))
                    165: #define        clrbit(a,i)     ((a)[(i)/NBBY] &= ~(1<<((i)%NBBY)))
                    166: #define        isset(a,i)      ((a)[(i)/NBBY] & (1<<((i)%NBBY)))
                    167: #define        isclr(a,i)      (((a)[(i)/NBBY] & (1<<((i)%NBBY))) == 0)
                    168: 
                    169: /* Macros for counting and rounding. */
                    170: #ifndef howmany
                    171: #define        howmany(x, y)   (((x)+((y)-1))/(y))
                    172: #endif
                    173: #define        roundup(x, y)   ((((x)+((y)-1))/(y))*(y))
                    174: #define powerof2(x)    ((((x)-1)&(x))==0)
                    175: 
                    176: /* Macros for fast min/max: with inline expansion, the "function" is faster. */
                    177: #ifdef KERNEL
                    178: #define        MIN(a,b) min((a), (b))
                    179: #define        MAX(a,b) max((a), (b))
                    180: #else
                    181: #define        MIN(a,b) (((a)<(b))?(a):(b))
                    182: #define        MAX(a,b) (((a)>(b))?(a):(b))
                    183: #endif
                    184: 
                    185: /*
                    186:  * Constants for setting the parameters of the kernel memory allocator.
                    187:  *
                    188:  * 2 ** MINBUCKET is the smallest unit of memory that will be
                    189:  * allocated. It must be at least large enough to hold a pointer.
                    190:  *
                    191:  * Units of memory less or equal to MAXALLOCSAVE will permanently
                    192:  * allocate physical memory; requests for these size pieces of
                    193:  * memory are quite fast. Allocations greater than MAXALLOCSAVE must
                    194:  * always allocate and free physical memory; requests for these
                    195:  * size allocations should be done infrequently as they will be slow.
                    196:  *
                    197:  * Constraints: CLBYTES <= MAXALLOCSAVE <= 2 ** (MINBUCKET + 14), and
                    198:  * MAXALLOCSIZE must be a power of two.
                    199:  */
                    200: #define MINBUCKET      4               /* 4 => min allocation of 16 bytes */
                    201: #define MAXALLOCSAVE   (2 * CLBYTES)
                    202: 
                    203: /*
                    204:  * Scale factor for scaled integers used to count %cpu time and load avgs.
                    205:  *
                    206:  * The number of CPU `tick's that map to a unique `%age' can be expressed
                    207:  * by the formula (1 / (2 ^ (FSHIFT - 11))).  The maximum load average that
                    208:  * can be calculated (assuming 32 bits) can be closely approximated using
                    209:  * the formula (2 ^ (2 * (16 - FSHIFT))) for (FSHIFT < 15).
                    210:  *
                    211:  * For the scheduler to maintain a 1:1 mapping of CPU `tick' to `%age',
                    212:  * FSHIFT must be at least 11; this gives us a maximum load avg of ~1024.
                    213:  */
                    214: #define        FSHIFT  11              /* bits to right of fixed binary point */
                    215: #define FSCALE (1<<FSHIFT)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.