Annotation of XNU/osfmk/mach/vm_prot.h, revision 1.1

1.1     ! root        1: /*
        !             2:  * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
        !             3:  *
        !             4:  * @APPLE_LICENSE_HEADER_START@
        !             5:  * 
        !             6:  * The contents of this file constitute Original Code as defined in and
        !             7:  * are subject to the Apple Public Source License Version 1.1 (the
        !             8:  * "License").  You may not use this file except in compliance with the
        !             9:  * License.  Please obtain a copy of the License at
        !            10:  * http://www.apple.com/publicsource and read it before using this file.
        !            11:  * 
        !            12:  * This Original Code and all software distributed under the License are
        !            13:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
        !            14:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
        !            15:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
        !            16:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
        !            17:  * License for the specific language governing rights and limitations
        !            18:  * under the License.
        !            19:  * 
        !            20:  * @APPLE_LICENSE_HEADER_END@
        !            21:  */
        !            22: /*
        !            23:  * @OSF_COPYRIGHT@
        !            24:  */
        !            25: /*
        !            26:  * HISTORY
        !            27:  * 
        !            28:  * Revision 1.1.1.1  1998/09/22 21:05:31  wsanchez
        !            29:  * Import of Mac OS X kernel (~semeria)
        !            30:  *
        !            31:  * Revision 1.1.1.1  1998/03/07 02:25:46  wsanchez
        !            32:  * Import of OSF Mach kernel (~mburg)
        !            33:  *
        !            34:  * Revision 1.3.8.1  1994/09/23  02:44:31  ezf
        !            35:  *     change marker to not FREE
        !            36:  *     [1994/09/22  21:43:46  ezf]
        !            37:  *
        !            38:  * Revision 1.3.2.2  1993/06/09  02:44:23  gm
        !            39:  *     Added to OSF/1 R1.3 from NMK15.0.
        !            40:  *     [1993/06/02  21:18:51  jeffc]
        !            41:  * 
        !            42:  * Revision 1.3  1993/04/19  16:40:48  devrcs
        !            43:  *     make endif tags ansi compliant/include files
        !            44:  *     [1993/02/20  21:45:25  david]
        !            45:  * 
        !            46:  * Revision 1.2  1992/12/07  21:29:28  robert
        !            47:  *     integrate any changes below for 14.0 (branch from 13.16 base)
        !            48:  * 
        !            49:  *     Joseph Barrera (jsb) at Carnegie-Mellon University 05-Aug-92
        !            50:  *     Added VM_PROT_WANTS_COPY to solve copy-call race condition.
        !            51:  *     [1992/12/06  20:25:47  robert]
        !            52:  * 
        !            53:  * Revision 1.1  1992/09/30  02:32:28  robert
        !            54:  *     Initial revision
        !            55:  * 
        !            56:  * $EndLog$
        !            57:  */
        !            58: /* CMU_HIST */
        !            59: /*
        !            60:  * Revision 2.4.3.1  92/03/03  16:22:41  jeffreyh
        !            61:  *     [David L. Black 92/02/22  17:03:43  [email protected]]
        !            62:  *        Add no change protection value for memory_object_lock_request.
        !            63:  * 
        !            64:  * Revision 2.4  91/05/14  17:03:00  mrt
        !            65:  *     Correcting copyright
        !            66:  * 
        !            67:  * Revision 2.3  91/02/05  17:37:38  mrt
        !            68:  *     Changed to new Mach copyright
        !            69:  *     [91/02/01  17:22:39  mrt]
        !            70:  * 
        !            71:  * Revision 2.2  90/01/22  23:05:57  af
        !            72:  *     Removed execute permission from default protection.
        !            73:  *     On the only machine that cares for execute permission (mips)
        !            74:  *     this is an expensive liability: it requires keeping
        !            75:  *     Icache consistent memory that never contains code.
        !            76:  *     [89/12/15            af]
        !            77:  * 
        !            78:  * Revision 2.1  89/08/03  16:06:47  rwd
        !            79:  * Created.
        !            80:  * 
        !            81:  * Revision 2.3  89/02/25  18:42:29  gm0w
        !            82:  *     Changes for cleanup.
        !            83:  * 
        !            84:  *  6-Jun-85  Avadis Tevanian (avie) at Carnegie-Mellon University
        !            85:  *     Created.
        !            86:  *
        !            87:  */
        !            88: /* CMU_ENDHIST */
        !            89: /* 
        !            90:  * Mach Operating System
        !            91:  * Copyright (c) 1991,1990,1989,1988,1987 Carnegie Mellon University
        !            92:  * All Rights Reserved.
        !            93:  * 
        !            94:  * Permission to use, copy, modify and distribute this software and its
        !            95:  * documentation is hereby granted, provided that both the copyright
        !            96:  * notice and this permission notice appear in all copies of the
        !            97:  * software, derivative works or modified versions, and any portions
        !            98:  * thereof, and that both notices appear in supporting documentation.
        !            99:  * 
        !           100:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
        !           101:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
        !           102:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
        !           103:  * 
        !           104:  * Carnegie Mellon requests users of this software to return to
        !           105:  * 
        !           106:  *  Software Distribution Coordinator  or  [email protected]
        !           107:  *  School of Computer Science
        !           108:  *  Carnegie Mellon University
        !           109:  *  Pittsburgh PA 15213-3890
        !           110:  * 
        !           111:  * any improvements or extensions that they make and grant Carnegie Mellon
        !           112:  * the rights to redistribute these changes.
        !           113:  */
        !           114: /*
        !           115:  */
        !           116: /*
        !           117:  *     File:   mach/vm_prot.h
        !           118:  *     Author: Avadis Tevanian, Jr., Michael Wayne Young
        !           119:  *
        !           120:  *     Virtual memory protection definitions.
        !           121:  *
        !           122:  */
        !           123: 
        !           124: #ifndef        VM_PROT_H_
        !           125: #define        VM_PROT_H_
        !           126: 
        !           127: /*
        !           128:  *     Types defined:
        !           129:  *
        !           130:  *     vm_prot_t               VM protection values.
        !           131:  */
        !           132: 
        !           133: typedef int            vm_prot_t;
        !           134: 
        !           135: /*
        !           136:  *     Protection values, defined as bits within the vm_prot_t type
        !           137:  */
        !           138: 
        !           139: #define        VM_PROT_NONE    ((vm_prot_t) 0x00)
        !           140: 
        !           141: #define VM_PROT_READ   ((vm_prot_t) 0x01)      /* read permission */
        !           142: #define VM_PROT_WRITE  ((vm_prot_t) 0x02)      /* write permission */
        !           143: #define VM_PROT_EXECUTE        ((vm_prot_t) 0x04)      /* execute permission */
        !           144: 
        !           145: /*
        !           146:  *     The default protection for newly-created virtual memory
        !           147:  */
        !           148: 
        !           149: #define VM_PROT_DEFAULT        (VM_PROT_READ|VM_PROT_WRITE)
        !           150: 
        !           151: /*
        !           152:  *     The maximum privileges possible, for parameter checking.
        !           153:  */
        !           154: 
        !           155: #define VM_PROT_ALL    (VM_PROT_READ|VM_PROT_WRITE|VM_PROT_EXECUTE)
        !           156: 
        !           157: /*
        !           158:  *     An invalid protection value.
        !           159:  *     Used only by memory_object_lock_request to indicate no change
        !           160:  *     to page locks.  Using -1 here is a bad idea because it
        !           161:  *     looks like VM_PROT_ALL and then some.
        !           162:  */
        !           163: #define VM_PROT_NO_CHANGE      ((vm_prot_t) 0x08)
        !           164: 
        !           165: /* 
        !           166:  *      When a caller finds that he cannot obtain write permission on a
        !           167:  *      mapped entry, the following flag can be used.  The entry will
        !           168:  *      be made "needs copy" effectively copying the object (using COW),
        !           169:  *      and write permission will be added to the maximum protections
        !           170:  *      for the associated entry. 
        !           171:  */        
        !           172: #define VM_PROT_COPY            ((vm_prot_t) 0x10)
        !           173: 
        !           174: 
        !           175: /*
        !           176:  *     Another invalid protection value.
        !           177:  *     Used only by memory_object_data_request upon an object
        !           178:  *     which has specified a copy_call copy strategy. It is used
        !           179:  *     when the kernel wants a page belonging to a copy of the
        !           180:  *     object, and is only asking the object as a result of
        !           181:  *     following a shadow chain. This solves the race between pages
        !           182:  *     being pushed up by the memory manager and the kernel
        !           183:  *     walking down the shadow chain.
        !           184:  */
        !           185: #define VM_PROT_WANTS_COPY     ((vm_prot_t) 0x10)
        !           186: 
        !           187: #endif /* VM_PROT_H_ */

unix.superglobalmegacorp.com

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