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_O_MR1_TARGET_API = 27, 48 SLANG_P_TARGET_API = 28, 49 SLANG_Q_TARGET_API = 29, 50 SLANG_R_TARGET_API = 30, 51 SLANG_S_TARGET_API = 31, 52 SLANG_MAXIMUM_TARGET_API = RS_VERSION, 53 // The maximum API level that is acceptable for the "-target-api" commandline option. 54 SLANG_MAXIMUM_CMDLINE_TARGET_API = SLANG_S_TARGET_API, 55 SLANG_DEVELOPMENT_TARGET_API = RS_DEVELOPMENT_API 56 }; 57 // Note that RS_VERSION is defined at build time (see Android.mk for details). 58 59 // API levels where particular features exist. 60 // . Open (feature appears at a particular level and continues to exist): 61 // SLANG_FEAT_FOO_API 62 // . Closed (feature exists only through a particular range of API levels): 63 // SLANG_FEAT_BAR_API_MIN, SLANG_FEAT_BAR_API_MAX 64 enum SlangFeatureAPI { 65 SLANG_FEATURE_GENERAL_REDUCTION_API = SLANG_N_TARGET_API, 66 SLANG_FEATURE_GENERAL_REDUCTION_HALTER_API = SLANG_DEVELOPMENT_TARGET_API, 67 SLANG_FEATURE_SINGLE_SOURCE_API = SLANG_N_TARGET_API, 68 }; 69 70 // SlangVersion refers to the released compiler version, for which 71 // certain behaviors could change. 72 // 73 // The SlangVersion is recorded in the generated bitcode. A bitcode 74 // consumer (for example: runtime, driver, bcc) is expected to use 75 // this version number as follows: 76 // 77 // If version number is at least $VERSION, then I can assume that 78 // $PROPERTY holds. 79 // 80 // However, a bitcode consumer is not obligated to act on this 81 // information (for example, the consumer may be too old to know about 82 // that version number). So slang must not change its behavior for 83 // $VERSION in such a way that a backend needs to know about $VERSION 84 // in order to behave properly. 85 // 86 // For example: 87 // 88 // If version number is at least N_STRUCT_EXPLICIT_PADDING, then I 89 // can assume that no field of any struct is followed by implicit 90 // padding. 91 // 92 // bcc can take advantage of this (by turning off analyses and 93 // transformations that are needed because of implicit padding), but 94 // slang must still generate code that works properly with a bcc 95 // that is too old to know about the N_STRUCT_EXPLICIT_PADDING 96 // guarantee. 97 // 98 // Note that we CANNOT say 99 // 100 // If version number is at least $VERSION_LO but lower than 101 // $VERSION_HI, then I can assume that $PROPERTY holds. 102 // 103 // because a bitcode consumer might know about $VERSION_LO (where it 104 // could start taking advantage of $PROPERTY) without knowing about 105 // $VERSION_HI (where it would have to stop taking advantage of 106 // $PROPERTY). 107 namespace SlangVersion { 108 enum { 109 LEGACY = 0, 110 ICS = 1400, 111 JB = 1600, 112 JB_MR1 = 1700, 113 JB_MR2 = 1800, 114 KK = 1900, 115 KK_P1 = 1901, 116 L = 2100, 117 M = 2300, 118 M_RS_OBJECT = 2310, 119 N = 2400, 120 N_STRUCT_EXPLICIT_PADDING = 2410, 121 CURRENT = N_STRUCT_EXPLICIT_PADDING 122 }; 123 } // namespace SlangVersion 124 125 #endif // _FRAMEWORKS_COMPILE_SLANG_SLANG_VERSION_H_ NOLINT 126