1 /* 2 * Copyright 2011-2012, The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef _FRAMEWORKS_COMPILE_SLANG_SLANG_VERSION_H_ // NOLINT 18 #define _FRAMEWORKS_COMPILE_SLANG_SLANG_VERSION_H_ 19 20 #include <climits> 21 22 #define RS_DEVELOPMENT_API UINT_MAX 23 24 // API levels used by the standard Android SDK. 25 // MR -> Maintenance Release 26 // HC -> Honeycomb 27 // ICS -> Ice Cream Sandwich 28 // JB -> Jelly Bean 29 // KK -> KitKat 30 // M -> Marshmallow 31 enum SlangTargetAPI { 32 SLANG_MINIMUM_TARGET_API = 11, 33 SLANG_HC_TARGET_API = 11, 34 SLANG_HC_MR1_TARGET_API = 12, 35 SLANG_HC_MR2_TARGET_API = 13, 36 SLANG_ICS_TARGET_API = 14, 37 SLANG_ICS_MR1_TARGET_API = 15, 38 SLANG_JB_TARGET_API = 16, 39 SLANG_JB_MR1_TARGET_API = 17, 40 SLANG_JB_MR2_TARGET_API = 18, 41 SLANG_KK_TARGET_API = 19, 42 SLANG_L_TARGET_API = 21, 43 SLANG_M_TARGET_API = 23, 44 SLANG_N_TARGET_API = 24, 45 SLANG_N_MR1_TARGET_API = 25, 46 SLANG_O_TARGET_API = 26, 47 SLANG_MAXIMUM_TARGET_API = RS_VERSION, 48 SLANG_DEVELOPMENT_TARGET_API = RS_DEVELOPMENT_API 49 }; 50 // Note that RS_VERSION is defined at build time (see Android.mk for details). 51 52 // API levels where particular features exist. 53 // . Open (feature appears at a particular level and continues to exist): 54 // SLANG_FEAT_FOO_API 55 // . Closed (feature exists only through a particular range of API levels): 56 // SLANG_FEAT_BAR_API_MIN, SLANG_FEAT_BAR_API_MAX 57 enum SlangFeatureAPI { 58 SLANG_FEATURE_GENERAL_REDUCTION_API = SLANG_N_TARGET_API, 59 SLANG_FEATURE_GENERAL_REDUCTION_HALTER_API = SLANG_DEVELOPMENT_TARGET_API, 60 SLANG_FEATURE_SINGLE_SOURCE_API = SLANG_N_TARGET_API, 61 }; 62 63 // SlangVersion refers to the released compiler version, for which 64 // certain behaviors could change. 65 // 66 // The SlangVersion is recorded in the generated bitcode. A bitcode 67 // consumer (for example: runtime, driver, bcc) is expected to use 68 // this version number as follows: 69 // 70 // If version number is at least $VERSION, then I can assume that 71 // $PROPERTY holds. 72 // 73 // However, a bitcode consumer is not obligated to act on this 74 // information (for example, the consumer may be too old to know about 75 // that version number). So slang must not change its behavior for 76 // $VERSION in such a way that a backend needs to know about $VERSION 77 // in order to behave properly. 78 // 79 // For example: 80 // 81 // If version number is at least N_STRUCT_EXPLICIT_PADDING, then I 82 // can assume that no field of any struct is followed by implicit 83 // padding. 84 // 85 // bcc can take advantage of this (by turning off analyses and 86 // transformations that are needed because of implicit padding), but 87 // slang must still generate code that works properly with a bcc 88 // that is too old to know about the N_STRUCT_EXPLICIT_PADDING 89 // guarantee. 90 // 91 // Note that we CANNOT say 92 // 93 // If version number is at least $VERSION_LO but lower than 94 // $VERSION_HI, then I can assume that $PROPERTY holds. 95 // 96 // because a bitcode consumer might know about $VERSION_LO (where it 97 // could start taking advantage of $PROPERTY) without knowing about 98 // $VERSION_HI (where it would have to stop taking advantage of 99 // $PROPERTY). 100 namespace SlangVersion { 101 enum { 102 LEGACY = 0, 103 ICS = 1400, 104 JB = 1600, 105 JB_MR1 = 1700, 106 JB_MR2 = 1800, 107 KK = 1900, 108 KK_P1 = 1901, 109 L = 2100, 110 M = 2300, 111 M_RS_OBJECT = 2310, 112 N = 2400, 113 N_STRUCT_EXPLICIT_PADDING = 2410, 114 CURRENT = N_STRUCT_EXPLICIT_PADDING 115 }; 116 } // namespace SlangVersion 117 118 #endif // _FRAMEWORKS_COMPILE_SLANG_SLANG_VERSION_H_ NOLINT 119