Annotation of OSKit-Mach/i386/intel/pmap.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Mach Operating System
                      3:  * Copyright (c) 1991,1990,1989,1988 Carnegie Mellon University
                      4:  * All Rights Reserved.
                      5:  *
                      6:  * Permission to use, copy, modify and distribute this software and its
                      7:  * documentation is hereby granted, provided that both the copyright
                      8:  * notice and this permission notice appear in all copies of the
                      9:  * software, derivative works or modified versions, and any portions
                     10:  * thereof, and that both notices appear in supporting documentation.
                     11:  *
                     12:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
                     13:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
                     14:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
                     15:  *
                     16:  * Carnegie Mellon requests users of this software to return to
                     17:  *
                     18:  *  Software Distribution Coordinator  or  [email protected]
                     19:  *  School of Computer Science
                     20:  *  Carnegie Mellon University
                     21:  *  Pittsburgh PA 15213-3890
                     22:  *
                     23:  * any improvements or extensions that they make and grant Carnegie Mellon
                     24:  * the rights to redistribute these changes.
                     25:  */
                     26: /*
                     27:  *     File:   pmap.h
                     28:  *
                     29:  *     Authors:  Avadis Tevanian, Jr., Michael Wayne Young
                     30:  *     Date:   1985
                     31:  *
                     32:  *     Machine-dependent structures for the physical map module.
                     33:  */
                     34: 
                     35: #ifndef        _PMAP_MACHINE_
                     36: #define _PMAP_MACHINE_ 1
                     37: 
                     38: #include <oskit/x86/paging.h>
                     39: #define        INTEL_PGBYTES           I386_PGBYTES
                     40: #define INTEL_PTE_WIRED                0x00000200
                     41: #define ptenum(a)      lin2ptenum(a)
                     42: #define        intel_btop(x)           atop(x)
                     43: #define        intel_ptob(x)           ptoa(x)
                     44: 
                     45: #ifndef        ASSEMBLER
                     46: 
                     47: #include <kern/zalloc.h>
                     48: #include <kern/lock.h>
                     49: #include <mach/machine/vm_param.h>
                     50: #include <mach/vm_statistics.h>
                     51: #include <mach/kern_return.h>
                     52: 
                     53: #include <oskit/x86/base_vm.h>
                     54: #include <oskit/x86/proc_reg.h>
                     55: 
                     56: /*
                     57:  *     Convert page table entry to kernel virtual address
                     58:  */
                     59: #define ptetokv(a)     (phystokv(pte_to_pa(a)))
                     60: 
                     61: typedef        volatile long   cpu_set;        /* set of CPUs - must be <= 32 */
                     62:                                        /* changed by other processors */
                     63: 
                     64: struct pmap {
                     65:        pt_entry_t      *dirbase;       /* page directory pointer register */
                     66:        int             ref_count;      /* reference count */
                     67:        decl_simple_lock_data(,lock)
                     68:                                        /* lock on map */
                     69:        struct pmap_statistics  stats;  /* map statistics */
                     70:        cpu_set         cpus_using;     /* bitmap of cpus using pmap */
                     71: };
                     72: 
                     73: typedef struct pmap    *pmap_t;
                     74: 
                     75: #define PMAP_NULL      ((pmap_t) 0)
                     76: 
                     77: #if    i860
                     78: /*#define      set_dirbase(dirbase)    flush_and_ctxsw(dirbase)*//*akp*/
                     79: #else
                     80: #define        set_dirbase(dirbase)    set_cr3(dirbase)
                     81: #endif
                     82: 
                     83: #if    NCPUS > 1
                     84: /*
                     85:  *     List of cpus that are actively using mapped memory.  Any
                     86:  *     pmap update operation must wait for all cpus in this list.
                     87:  *     Update operations must still be queued to cpus not in this
                     88:  *     list.
                     89:  */
                     90: cpu_set                cpus_active;
                     91: 
                     92: /*
                     93:  *     List of cpus that are idle, but still operating, and will want
                     94:  *     to see any kernel pmap updates when they become active.
                     95:  */
                     96: cpu_set                cpus_idle;
                     97: 
                     98: /*
                     99:  *     Quick test for pmap update requests.
                    100:  */
                    101: volatile
                    102: boolean_t      cpu_update_needed[NCPUS];
                    103: 
                    104: /*
                    105:  *     External declarations for PMAP_ACTIVATE.
                    106:  */
                    107: 
                    108: void           process_pmap_updates();
                    109: void           pmap_update_interrupt();
                    110: extern pmap_t  kernel_pmap;
                    111: 
                    112: #endif /* NCPUS > 1 */
                    113: 
                    114: /*
                    115:  *     Machine dependent routines that are used only for i386/i486/i860.
                    116:  */
                    117: 
                    118: pt_entry_t *pmap_pte(pmap_t pmap, vm_offset_t addr);
                    119: 
                    120: /*
                    121:  *     Macros for speed.
                    122:  */
                    123: 
                    124: #if    NCPUS > 1
                    125: 
                    126: /*
                    127:  *     For multiple CPUS, PMAP_ACTIVATE and PMAP_DEACTIVATE must manage
                    128:  *     fields to control TLB invalidation on other CPUS.
                    129:  */
                    130: 
                    131: #define        PMAP_ACTIVATE_KERNEL(my_cpu)    {                               \
                    132:                                                                        \
                    133:        /*                                                              \
                    134:         *      Let pmap updates proceed while we wait for this pmap.   \
                    135:         */                                                             \
                    136:        i_bit_clear((my_cpu), &cpus_active);                            \
                    137:                                                                        \
                    138:        /*                                                              \
                    139:         *      Lock the pmap to put this cpu in its active set.        \
                    140:         *      Wait for updates here.                                  \
                    141:         */                                                             \
                    142:        simple_lock(&kernel_pmap->lock);                                \
                    143:                                                                        \
                    144:        /*                                                              \
                    145:         *      Process invalidate requests for the kernel pmap.        \
                    146:         */                                                             \
                    147:        if (cpu_update_needed[(my_cpu)])                                \
                    148:            process_pmap_updates(kernel_pmap);                          \
                    149:                                                                        \
                    150:        /*                                                              \
                    151:         *      Mark that this cpu is using the pmap.                   \
                    152:         */                                                             \
                    153:        i_bit_set((my_cpu), &kernel_pmap->cpus_using);                  \
                    154:                                                                        \
                    155:        /*                                                              \
                    156:         *      Mark this cpu active - IPL will be lowered by           \
                    157:         *      load_context().                                         \
                    158:         */                                                             \
                    159:        i_bit_set((my_cpu), &cpus_active);                              \
                    160:                                                                        \
                    161:        simple_unlock(&kernel_pmap->lock);                              \
                    162: }
                    163: 
                    164: #define        PMAP_DEACTIVATE_KERNEL(my_cpu)  {                               \
                    165:        /*                                                              \
                    166:         *      Mark pmap no longer in use by this cpu even if          \
                    167:         *      pmap is locked against updates.                         \
                    168:         */                                                             \
                    169:        i_bit_clear((my_cpu), &kernel_pmap->cpus_using);                \
                    170: }
                    171: 
                    172: #define PMAP_ACTIVATE_USER(pmap, th, my_cpu)   {                       \
                    173:        register pmap_t         tpmap = (pmap);                         \
                    174:                                                                        \
                    175:        if (tpmap == kernel_pmap) {                                     \
                    176:            /*                                                          \
                    177:             *  If this is the kernel pmap, switch to its page tables.  \
                    178:             */                                                         \
                    179:            set_dirbase(kvtophys(tpmap->dirbase));                      \
                    180:        }                                                               \
                    181:        else {                                                          \
                    182:            /*                                                          \
                    183:             *  Let pmap updates proceed while we wait for this pmap.   \
                    184:             */                                                         \
                    185:            i_bit_clear((my_cpu), &cpus_active);                        \
                    186:                                                                        \
                    187:            /*                                                          \
                    188:             *  Lock the pmap to put this cpu in its active set.        \
                    189:             *  Wait for updates here.                                  \
                    190:             */                                                         \
                    191:            simple_lock(&tpmap->lock);                                  \
                    192:                                                                        \
                    193:            /*                                                          \
                    194:             *  No need to invalidate the TLB - the entire user pmap    \
                    195:             *  will be invalidated by reloading dirbase.               \
                    196:             */                                                         \
                    197:            set_dirbase(kvtophys(tpmap->dirbase));                      \
                    198:                                                                        \
                    199:            /*                                                          \
                    200:             *  Mark that this cpu is using the pmap.                   \
                    201:             */                                                         \
                    202:            i_bit_set((my_cpu), &tpmap->cpus_using);                    \
                    203:                                                                        \
                    204:            /*                                                          \
                    205:             *  Mark this cpu active - IPL will be lowered by           \
                    206:             *  load_context().                                         \
                    207:             */                                                         \
                    208:            i_bit_set((my_cpu), &cpus_active);                          \
                    209:                                                                        \
                    210:            simple_unlock(&tpmap->lock);                                \
                    211:        }                                                               \
                    212: }
                    213: 
                    214: #define PMAP_DEACTIVATE_USER(pmap, thread, my_cpu)     {               \
                    215:        register pmap_t         tpmap = (pmap);                         \
                    216:                                                                        \
                    217:        /*                                                              \
                    218:         *      Do nothing if this is the kernel pmap.                  \
                    219:         */                                                             \
                    220:        if (tpmap != kernel_pmap) {                                     \
                    221:            /*                                                          \
                    222:             *  Mark pmap no longer in use by this cpu even if          \
                    223:             *  pmap is locked against updates.                         \
                    224:             */                                                         \
                    225:            i_bit_clear((my_cpu), &(pmap)->cpus_using);                 \
                    226:        }                                                               \
                    227: }
                    228: 
                    229: #define MARK_CPU_IDLE(my_cpu)  {                                       \
                    230:        /*                                                              \
                    231:         *      Mark this cpu idle, and remove it from the active set,  \
                    232:         *      since it is not actively using any pmap.  Signal_cpus   \
                    233:         *      will notice that it is idle, and avoid signaling it,    \
                    234:         *      but will queue the update request for when the cpu      \
                    235:         *      becomes active.                                         \
                    236:         */                                                             \
                    237:        int     s = splvm();                                            \
                    238:        i_bit_set((my_cpu), &cpus_idle);                                \
                    239:        i_bit_clear((my_cpu), &cpus_active);                            \
                    240:        splx(s);                                                        \
                    241: }
                    242: 
                    243: #define MARK_CPU_ACTIVE(my_cpu)        {                                       \
                    244:                                                                        \
                    245:        int     s = splvm();                                            \
                    246:        /*                                                              \
                    247:         *      If a kernel_pmap update was requested while this cpu    \
                    248:         *      was idle, process it as if we got the interrupt.        \
                    249:         *      Before doing so, remove this cpu from the idle set.     \
                    250:         *      Since we do not grab any pmap locks while we flush      \
                    251:         *      our TLB, another cpu may start an update operation      \
                    252:         *      before we finish.  Removing this cpu from the idle      \
                    253:         *      set assures that we will receive another update         \
                    254:         *      interrupt if this happens.                              \
                    255:         */                                                             \
                    256:        i_bit_clear((my_cpu), &cpus_idle);                              \
                    257:                                                                        \
                    258:        if (cpu_update_needed[(my_cpu)])                                \
                    259:            pmap_update_interrupt();                                    \
                    260:                                                                        \
                    261:        /*                                                              \
                    262:         *      Mark that this cpu is now active.                       \
                    263:         */                                                             \
                    264:        i_bit_set((my_cpu), &cpus_active);                              \
                    265:        splx(s);                                                        \
                    266: }
                    267: 
                    268: #else  /* NCPUS > 1 */
                    269: 
                    270: /*
                    271:  *     With only one CPU, we just have to indicate whether the pmap is
                    272:  *     in use.
                    273:  */
                    274: 
                    275: #define        PMAP_ACTIVATE_KERNEL(my_cpu)    {                               \
                    276:        kernel_pmap->cpus_using = TRUE;                                 \
                    277: }
                    278: 
                    279: #define        PMAP_DEACTIVATE_KERNEL(my_cpu)  {                               \
                    280:        kernel_pmap->cpus_using = FALSE;                                \
                    281: }
                    282: 
                    283: #define        PMAP_ACTIVATE_USER(pmap, th, my_cpu)    {                       \
                    284:        register pmap_t         tpmap = (pmap);                         \
                    285:                                                                        \
                    286:        set_dirbase(kvtophys(tpmap->dirbase));                          \
                    287:        if (tpmap != kernel_pmap) {                                     \
                    288:            tpmap->cpus_using = TRUE;                                   \
                    289:        }                                                               \
                    290: }
                    291: 
                    292: #define PMAP_DEACTIVATE_USER(pmap, thread, cpu)        {                       \
                    293:        if ((pmap) != kernel_pmap)                                      \
                    294:            (pmap)->cpus_using = FALSE;                                 \
                    295: }
                    296: 
                    297: #endif /* NCPUS > 1 */
                    298: 
                    299: #define PMAP_CONTEXT(pmap, thread)
                    300: 
                    301: #define        pmap_kernel()                   (kernel_pmap)
                    302: #define pmap_resident_count(pmap)      ((pmap)->stats.resident_count)
                    303: #define pmap_phys_address(frame)       ((vm_offset_t) (intel_ptob(frame)))
                    304: #define pmap_phys_to_frame(phys)       ((int) (intel_btop(phys)))
                    305: #define        pmap_copy(dst_pmap,src_pmap,dst_addr,len,src_addr)
                    306: #define        pmap_attribute(pmap,addr,size,attr,value) \
                    307:                                        (KERN_INVALID_ADDRESS)
                    308: 
                    309: #endif /* ASSEMBLER */
                    310: 
                    311: #endif /* _PMAP_MACHINE_ */

unix.superglobalmegacorp.com

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