Annotation of OSKit-Mach/vm/vm_external.h, revision 1.1

1.1     ! root        1: /*
        !             2:  * Mach Operating System
        !             3:  * Copyright (c) 1991,1990,1989 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: #ifndef        _VM_VM_EXTERNAL_H_
        !            28: #define _VM_VM_EXTERNAL_H_
        !            29: 
        !            30: /*
        !            31:  *     External page management hint technology
        !            32:  *
        !            33:  *     The data structure exported by this module maintains
        !            34:  *     a (potentially incomplete) map of the pages written
        !            35:  *     to external storage for a range of virtual memory.
        !            36:  */
        !            37: 
        !            38: /*
        !            39:  *     The data structure representing the state of pages
        !            40:  *     on external storage.
        !            41:  */
        !            42: 
        !            43: typedef struct vm_external {
        !            44:        int             existence_size; /* Size of the following bitmap */
        !            45:        char            *existence_map; /* A bitmap of pages that have
        !            46:                                         * been written to backing
        !            47:                                         * storage.
        !            48:                                         */
        !            49:        int             existence_count;/* Number of bits turned on in
        !            50:                                         * existence_map.
        !            51:                                         */
        !            52: } *vm_external_t;
        !            53: 
        !            54: #define        VM_EXTERNAL_NULL        ((vm_external_t) 0)
        !            55: 
        !            56: #define VM_EXTERNAL_SMALL_SIZE 128
        !            57: #define VM_EXTERNAL_LARGE_SIZE 8192
        !            58: 
        !            59: /*
        !            60:  *     The states that may be recorded for a page of external storage.
        !            61:  */
        !            62: 
        !            63: typedef int    vm_external_state_t;
        !            64: #define        VM_EXTERNAL_STATE_EXISTS                1
        !            65: #define        VM_EXTERNAL_STATE_UNKNOWN               2
        !            66: #define        VM_EXTERNAL_STATE_ABSENT                3
        !            67: 
        !            68: 
        !            69: /*
        !            70:  *     Routines exported by this module.
        !            71:  */
        !            72: 
        !            73: extern void            vm_external_module_initialize();
        !            74:                                                /* Initialize the module */
        !            75: 
        !            76: extern vm_external_t   vm_external_create();   /* Create a vm_external_t */
        !            77: extern void vm_external_destroy();             /* Destroy one */
        !            78: 
        !            79: extern void            vm_external_state_set();/* Set state of a page. */
        !            80: #define        vm_external_state_get(e,offset) (((e) != VM_EXTERNAL_NULL) ? \
        !            81:                                          _vm_external_state_get(e, offset) : \
        !            82:                                          VM_EXTERNAL_STATE_UNKNOWN)
        !            83:                                                /* Retrieve the state
        !            84:                                                 * for a given page, if known.
        !            85:                                                 */
        !            86: extern vm_external_state_t _vm_external_state_get();
        !            87:                                                /* HIDDEN routine */
        !            88: 
        !            89: #endif /* _VM_VM_EXTERNAL_H_ */

unix.superglobalmegacorp.com

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