1 //===- LLVMBitCodes.h - Enum values for the LLVM bitcode format -*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This header defines Bitcode enum values for LLVM IR bitcode files.
12 // The enum values defined in this file should be considered permanent. If
13 // new features are added, they should have values added at the end of the
16 //===----------------------------------------------------------------------===//
18 #ifndef LLVM_BITCODE_LLVMBITCODES_H
19 #define LLVM_BITCODE_LLVMBITCODES_H
21 #include "llvm/Bitcode/BitCodes.h"
25 // The only top-level block type defined is for a module.
28 MODULE_BLOCK_ID = FIRST_APPLICATION_BLOCKID,
30 // Module sub-block id's.
32 PARAMATTR_GROUP_BLOCK_ID,
37 // Block intended to contains information on the bitcode versioning.
38 // Can be used to provide better error messages when we fail to parse a
40 IDENTIFICATION_BLOCK_ID,
42 VALUE_SYMTAB_BLOCK_ID,
44 METADATA_ATTACHMENT_ID,
50 MODULE_STRTAB_BLOCK_ID,
51 FUNCTION_SUMMARY_BLOCK_ID,
53 OPERAND_BUNDLE_TAGS_BLOCK_ID,
55 METADATA_KIND_BLOCK_ID
58 /// Identification block contains a string that describes the producer details,
59 /// and an epoch that defines the auto-upgrade capability.
60 enum IdentificationCodes {
61 IDENTIFICATION_CODE_STRING = 1, // IDENTIFICATION: [strchr x N]
62 IDENTIFICATION_CODE_EPOCH = 2, // EPOCH: [epoch#]
65 /// The epoch that defines the auto-upgrade compatibility for the bitcode.
67 /// LLVM guarantees in a major release that a minor release can read bitcode
68 /// generated by previous minor releases. We translate this by making the reader
69 /// accepting only bitcode with the same epoch, except for the X.0 release which
71 enum { BITCODE_CURRENT_EPOCH = 0 };
73 /// MODULE blocks have a number of optional fields and subblocks.
75 MODULE_CODE_VERSION = 1, // VERSION: [version#]
76 MODULE_CODE_TRIPLE = 2, // TRIPLE: [strchr x N]
77 MODULE_CODE_DATALAYOUT = 3, // DATALAYOUT: [strchr x N]
78 MODULE_CODE_ASM = 4, // ASM: [strchr x N]
79 MODULE_CODE_SECTIONNAME = 5, // SECTIONNAME: [strchr x N]
81 // FIXME: Remove DEPLIB in 4.0.
82 MODULE_CODE_DEPLIB = 6, // DEPLIB: [strchr x N]
84 // GLOBALVAR: [pointer type, isconst, initid,
85 // linkage, alignment, section, visibility, threadlocal]
86 MODULE_CODE_GLOBALVAR = 7,
88 // FUNCTION: [type, callingconv, isproto, linkage, paramattrs, alignment,
89 // section, visibility, gc, unnamed_addr]
90 MODULE_CODE_FUNCTION = 8,
92 // ALIAS: [alias type, aliasee val#, linkage, visibility]
93 MODULE_CODE_ALIAS_OLD = 9,
95 // MODULE_CODE_PURGEVALS: [numvals]
96 MODULE_CODE_PURGEVALS = 10,
98 MODULE_CODE_GCNAME = 11, // GCNAME: [strchr x N]
99 MODULE_CODE_COMDAT = 12, // COMDAT: [selection_kind, name]
101 MODULE_CODE_VSTOFFSET = 13, // VSTOFFSET: [offset]
103 // ALIAS: [alias value type, addrspace, aliasee val#, linkage, visibility]
104 MODULE_CODE_ALIAS = 14,
106 // METADATA_VALUES: [numvals]
107 MODULE_CODE_METADATA_VALUES = 15,
110 /// PARAMATTR blocks have code for defining a parameter attribute set.
111 enum AttributeCodes {
112 // FIXME: Remove `PARAMATTR_CODE_ENTRY_OLD' in 4.0
113 PARAMATTR_CODE_ENTRY_OLD = 1, // ENTRY: [paramidx0, attr0,
114 // paramidx1, attr1...]
115 PARAMATTR_CODE_ENTRY = 2, // ENTRY: [paramidx0, attrgrp0,
116 // paramidx1, attrgrp1, ...]
117 PARAMATTR_GRP_CODE_ENTRY = 3 // ENTRY: [id, attr0, att1, ...]
120 /// TYPE blocks have codes for each type primitive they use.
122 TYPE_CODE_NUMENTRY = 1, // NUMENTRY: [numentries]
125 TYPE_CODE_VOID = 2, // VOID
126 TYPE_CODE_FLOAT = 3, // FLOAT
127 TYPE_CODE_DOUBLE = 4, // DOUBLE
128 TYPE_CODE_LABEL = 5, // LABEL
129 TYPE_CODE_OPAQUE = 6, // OPAQUE
130 TYPE_CODE_INTEGER = 7, // INTEGER: [width]
131 TYPE_CODE_POINTER = 8, // POINTER: [pointee type]
133 TYPE_CODE_FUNCTION_OLD = 9, // FUNCTION: [vararg, attrid, retty,
136 TYPE_CODE_HALF = 10, // HALF
138 TYPE_CODE_ARRAY = 11, // ARRAY: [numelts, eltty]
139 TYPE_CODE_VECTOR = 12, // VECTOR: [numelts, eltty]
141 // These are not with the other floating point types because they're
142 // a late addition, and putting them in the right place breaks
143 // binary compatibility.
144 TYPE_CODE_X86_FP80 = 13, // X86 LONG DOUBLE
145 TYPE_CODE_FP128 = 14, // LONG DOUBLE (112 bit mantissa)
146 TYPE_CODE_PPC_FP128= 15, // PPC LONG DOUBLE (2 doubles)
148 TYPE_CODE_METADATA = 16, // METADATA
150 TYPE_CODE_X86_MMX = 17, // X86 MMX
152 TYPE_CODE_STRUCT_ANON = 18, // STRUCT_ANON: [ispacked, eltty x N]
153 TYPE_CODE_STRUCT_NAME = 19, // STRUCT_NAME: [strchr x N]
154 TYPE_CODE_STRUCT_NAMED = 20,// STRUCT_NAMED: [ispacked, eltty x N]
156 TYPE_CODE_FUNCTION = 21, // FUNCTION: [vararg, retty, paramty x N]
158 TYPE_CODE_TOKEN = 22 // TOKEN
161 enum OperandBundleTagCode {
162 OPERAND_BUNDLE_TAG = 1, // TAG: [strchr x N]
165 // The type symbol table only has one code (TST_ENTRY_CODE).
166 enum TypeSymtabCodes {
167 TST_CODE_ENTRY = 1 // TST_ENTRY: [typeid, namechar x N]
170 // Value symbol table codes.
171 enum ValueSymtabCodes {
172 VST_CODE_ENTRY = 1, // VST_ENTRY: [valueid, namechar x N]
173 VST_CODE_BBENTRY = 2, // VST_BBENTRY: [bbid, namechar x N]
174 VST_CODE_FNENTRY = 3, // VST_FNENTRY: [valueid, offset, namechar x N]
175 // VST_COMBINED_FNENTRY: [offset, namechar x N]
176 VST_CODE_COMBINED_FNENTRY = 4
179 // The module path symbol table only has one code (MST_CODE_ENTRY).
180 enum ModulePathSymtabCodes {
181 MST_CODE_ENTRY = 1, // MST_ENTRY: [modid, namechar x N]
184 // The function summary section uses different codes in the per-module
185 // and combined index cases.
186 enum FunctionSummarySymtabCodes {
187 FS_CODE_PERMODULE_ENTRY = 1, // FS_ENTRY: [valueid, islocal, instcount]
188 FS_CODE_COMBINED_ENTRY = 2, // FS_ENTRY: [modid, instcount]
192 METADATA_STRING = 1, // MDSTRING: [values]
193 METADATA_VALUE = 2, // VALUE: [type num, value num]
194 METADATA_NODE = 3, // NODE: [n x md num]
195 METADATA_NAME = 4, // STRING: [values]
196 METADATA_DISTINCT_NODE = 5, // DISTINCT_NODE: [n x md num]
197 METADATA_KIND = 6, // [n x [id, name]]
198 METADATA_LOCATION = 7, // [distinct, line, col, scope, inlined-at?]
199 METADATA_OLD_NODE = 8, // OLD_NODE: [n x (type num, value num)]
200 METADATA_OLD_FN_NODE = 9, // OLD_FN_NODE: [n x (type num, value num)]
201 METADATA_NAMED_NODE = 10, // NAMED_NODE: [n x mdnodes]
202 METADATA_ATTACHMENT = 11, // [m x [value, [n x [id, mdnode]]]
203 METADATA_GENERIC_DEBUG = 12, // [distinct, tag, vers, header, n x md num]
204 METADATA_SUBRANGE = 13, // [distinct, count, lo]
205 METADATA_ENUMERATOR = 14, // [distinct, value, name]
206 METADATA_BASIC_TYPE = 15, // [distinct, tag, name, size, align, enc]
207 METADATA_FILE = 16, // [distinct, filename, directory]
208 METADATA_DERIVED_TYPE = 17, // [distinct, ...]
209 METADATA_COMPOSITE_TYPE= 18, // [distinct, ...]
210 METADATA_SUBROUTINE_TYPE=19, // [distinct, flags, types]
211 METADATA_COMPILE_UNIT = 20, // [distinct, ...]
212 METADATA_SUBPROGRAM = 21, // [distinct, ...]
213 METADATA_LEXICAL_BLOCK = 22, // [distinct, scope, file, line, column]
214 METADATA_LEXICAL_BLOCK_FILE=23,//[distinct, scope, file, discriminator]
215 METADATA_NAMESPACE = 24, // [distinct, scope, file, name, line]
216 METADATA_TEMPLATE_TYPE = 25, // [distinct, scope, name, type, ...]
217 METADATA_TEMPLATE_VALUE= 26, // [distinct, scope, name, type, value, ...]
218 METADATA_GLOBAL_VAR = 27, // [distinct, ...]
219 METADATA_LOCAL_VAR = 28, // [distinct, ...]
220 METADATA_EXPRESSION = 29, // [distinct, n x element]
221 METADATA_OBJC_PROPERTY = 30, // [distinct, name, file, line, ...]
222 METADATA_IMPORTED_ENTITY=31, // [distinct, tag, scope, entity, line, name]
223 METADATA_MODULE = 32, // [distinct, scope, name, ...]
224 METADATA_MACRO = 33, // [distinct, macinfo, line, name, value]
225 METADATA_MACRO_FILE = 34, // [distinct, macinfo, line, file, ...]
228 // The constants block (CONSTANTS_BLOCK_ID) describes emission for each
229 // constant and maintains an implicit current type value.
230 enum ConstantsCodes {
231 CST_CODE_SETTYPE = 1, // SETTYPE: [typeid]
232 CST_CODE_NULL = 2, // NULL
233 CST_CODE_UNDEF = 3, // UNDEF
234 CST_CODE_INTEGER = 4, // INTEGER: [intval]
235 CST_CODE_WIDE_INTEGER = 5, // WIDE_INTEGER: [n x intval]
236 CST_CODE_FLOAT = 6, // FLOAT: [fpval]
237 CST_CODE_AGGREGATE = 7, // AGGREGATE: [n x value number]
238 CST_CODE_STRING = 8, // STRING: [values]
239 CST_CODE_CSTRING = 9, // CSTRING: [values]
240 CST_CODE_CE_BINOP = 10, // CE_BINOP: [opcode, opval, opval]
241 CST_CODE_CE_CAST = 11, // CE_CAST: [opcode, opty, opval]
242 CST_CODE_CE_GEP = 12, // CE_GEP: [n x operands]
243 CST_CODE_CE_SELECT = 13, // CE_SELECT: [opval, opval, opval]
244 CST_CODE_CE_EXTRACTELT = 14, // CE_EXTRACTELT: [opty, opval, opval]
245 CST_CODE_CE_INSERTELT = 15, // CE_INSERTELT: [opval, opval, opval]
246 CST_CODE_CE_SHUFFLEVEC = 16, // CE_SHUFFLEVEC: [opval, opval, opval]
247 CST_CODE_CE_CMP = 17, // CE_CMP: [opty, opval, opval, pred]
248 CST_CODE_INLINEASM_OLD = 18, // INLINEASM: [sideeffect|alignstack,
250 CST_CODE_CE_SHUFVEC_EX = 19, // SHUFVEC_EX: [opty, opval, opval, opval]
251 CST_CODE_CE_INBOUNDS_GEP = 20,// INBOUNDS_GEP: [n x operands]
252 CST_CODE_BLOCKADDRESS = 21, // CST_CODE_BLOCKADDRESS [fnty, fnval, bb#]
253 CST_CODE_DATA = 22, // DATA: [n x elements]
254 CST_CODE_INLINEASM = 23 // INLINEASM: [sideeffect|alignstack|
255 // asmdialect,asmstr,conststr]
258 /// CastOpcodes - These are values used in the bitcode files to encode which
259 /// cast a CST_CODE_CE_CAST or a XXX refers to. The values of these enums
260 /// have no fixed relation to the LLVM IR enum values. Changing these will
261 /// break compatibility with old files.
275 CAST_ADDRSPACECAST = 12
278 /// BinaryOpcodes - These are values used in the bitcode files to encode which
279 /// binop a CST_CODE_CE_BINOP or a XXX refers to. The values of these enums
280 /// have no fixed relation to the LLVM IR enum values. Changing these will
281 /// break compatibility with old files.
287 BINOP_SDIV = 4, // overloaded for FP
289 BINOP_SREM = 6, // overloaded for FP
298 /// These are values used in the bitcode files to encode AtomicRMW operations.
299 /// The values of these enums have no fixed relation to the LLVM IR enum
300 /// values. Changing these will break compatibility with old files.
315 /// OverflowingBinaryOperatorOptionalFlags - Flags for serializing
316 /// OverflowingBinaryOperator's SubclassOptionalData contents.
317 enum OverflowingBinaryOperatorOptionalFlags {
318 OBO_NO_UNSIGNED_WRAP = 0,
319 OBO_NO_SIGNED_WRAP = 1
322 /// PossiblyExactOperatorOptionalFlags - Flags for serializing
323 /// PossiblyExactOperator's SubclassOptionalData contents.
324 enum PossiblyExactOperatorOptionalFlags {
328 /// Encoded AtomicOrdering values.
329 enum AtomicOrderingCodes {
330 ORDERING_NOTATOMIC = 0,
331 ORDERING_UNORDERED = 1,
332 ORDERING_MONOTONIC = 2,
333 ORDERING_ACQUIRE = 3,
334 ORDERING_RELEASE = 4,
339 /// Encoded SynchronizationScope values.
340 enum AtomicSynchScopeCodes {
341 SYNCHSCOPE_SINGLETHREAD = 0,
342 SYNCHSCOPE_CROSSTHREAD = 1
345 /// Markers and flags for call instruction.
346 enum CallMarkersFlags {
350 CALL_EXPLICIT_TYPE = 15,
352 CALL_FMF = 17 // Call has optional fast-math-flags.
355 // The function body block (FUNCTION_BLOCK_ID) describes function bodies. It
356 // can contain a constant block (CONSTANTS_BLOCK_ID).
358 FUNC_CODE_DECLAREBLOCKS = 1, // DECLAREBLOCKS: [n]
360 FUNC_CODE_INST_BINOP = 2, // BINOP: [opcode, ty, opval, opval]
361 FUNC_CODE_INST_CAST = 3, // CAST: [opcode, ty, opty, opval]
362 FUNC_CODE_INST_GEP_OLD = 4, // GEP: [n x operands]
363 FUNC_CODE_INST_SELECT = 5, // SELECT: [ty, opval, opval, opval]
364 FUNC_CODE_INST_EXTRACTELT = 6, // EXTRACTELT: [opty, opval, opval]
365 FUNC_CODE_INST_INSERTELT = 7, // INSERTELT: [ty, opval, opval, opval]
366 FUNC_CODE_INST_SHUFFLEVEC = 8, // SHUFFLEVEC: [ty, opval, opval, opval]
367 FUNC_CODE_INST_CMP = 9, // CMP: [opty, opval, opval, pred]
369 FUNC_CODE_INST_RET = 10, // RET: [opty,opval<both optional>]
370 FUNC_CODE_INST_BR = 11, // BR: [bb#, bb#, cond] or [bb#]
371 FUNC_CODE_INST_SWITCH = 12, // SWITCH: [opty, op0, op1, ...]
372 FUNC_CODE_INST_INVOKE = 13, // INVOKE: [attr, fnty, op0,op1, ...]
374 FUNC_CODE_INST_UNREACHABLE = 15, // UNREACHABLE
376 FUNC_CODE_INST_PHI = 16, // PHI: [ty, val0,bb0, ...]
379 FUNC_CODE_INST_ALLOCA = 19, // ALLOCA: [instty, opty, op, align]
380 FUNC_CODE_INST_LOAD = 20, // LOAD: [opty, op, align, vol]
383 FUNC_CODE_INST_VAARG = 23, // VAARG: [valistty, valist, instty]
384 // This store code encodes the pointer type, rather than the value type
385 // this is so information only available in the pointer type (e.g. address
386 // spaces) is retained.
387 FUNC_CODE_INST_STORE_OLD = 24, // STORE: [ptrty,ptr,val, align, vol]
389 FUNC_CODE_INST_EXTRACTVAL = 26, // EXTRACTVAL: [n x operands]
390 FUNC_CODE_INST_INSERTVAL = 27, // INSERTVAL: [n x operands]
391 // fcmp/icmp returning Int1TY or vector of Int1Ty. Same as CMP, exists to
392 // support legacy vicmp/vfcmp instructions.
393 FUNC_CODE_INST_CMP2 = 28, // CMP2: [opty, opval, opval, pred]
394 // new select on i1 or [N x i1]
395 FUNC_CODE_INST_VSELECT = 29, // VSELECT: [ty,opval,opval,predty,pred]
396 FUNC_CODE_INST_INBOUNDS_GEP_OLD = 30, // INBOUNDS_GEP: [n x operands]
397 FUNC_CODE_INST_INDIRECTBR = 31, // INDIRECTBR: [opty, op0, op1, ...]
399 FUNC_CODE_DEBUG_LOC_AGAIN = 33, // DEBUG_LOC_AGAIN
401 FUNC_CODE_INST_CALL = 34, // CALL: [attr, cc, fnty, fnid, args...]
403 FUNC_CODE_DEBUG_LOC = 35, // DEBUG_LOC: [Line,Col,ScopeVal, IAVal]
404 FUNC_CODE_INST_FENCE = 36, // FENCE: [ordering, synchscope]
405 FUNC_CODE_INST_CMPXCHG_OLD = 37, // CMPXCHG: [ptrty,ptr,cmp,new, align, vol,
406 // ordering, synchscope]
407 FUNC_CODE_INST_ATOMICRMW = 38, // ATOMICRMW: [ptrty,ptr,val, operation,
409 // ordering, synchscope]
410 FUNC_CODE_INST_RESUME = 39, // RESUME: [opval]
411 FUNC_CODE_INST_LANDINGPAD_OLD = 40, // LANDINGPAD: [ty,val,val,num,id0,val0...]
412 FUNC_CODE_INST_LOADATOMIC = 41, // LOAD: [opty, op, align, vol,
413 // ordering, synchscope]
414 FUNC_CODE_INST_STOREATOMIC_OLD = 42, // STORE: [ptrty,ptr,val, align, vol
415 // ordering, synchscope]
416 FUNC_CODE_INST_GEP = 43, // GEP: [inbounds, n x operands]
417 FUNC_CODE_INST_STORE = 44, // STORE: [ptrty,ptr,valty,val, align, vol]
418 FUNC_CODE_INST_STOREATOMIC = 45, // STORE: [ptrty,ptr,val, align, vol
419 FUNC_CODE_INST_CMPXCHG = 46, // CMPXCHG: [ptrty,ptr,valty,cmp,new, align,
420 // vol,ordering,synchscope]
421 FUNC_CODE_INST_LANDINGPAD = 47, // LANDINGPAD: [ty,val,num,id0,val0...]
422 FUNC_CODE_INST_CLEANUPRET = 48, // CLEANUPRET: [val] or [val,bb#]
423 FUNC_CODE_INST_CATCHRET = 49, // CATCHRET: [val,bb#]
424 FUNC_CODE_INST_CATCHPAD = 50, // CATCHPAD: [bb#,bb#,num,args...]
425 FUNC_CODE_INST_CLEANUPPAD = 51, // CLEANUPPAD: [num,args...]
426 FUNC_CODE_INST_CATCHSWITCH = 52, // CATCHSWITCH: [num,args...] or [num,args...,bb]
429 FUNC_CODE_OPERAND_BUNDLE = 55, // OPERAND_BUNDLE: [tag#, value...]
433 USELIST_CODE_DEFAULT = 1, // DEFAULT: [index..., value-id]
434 USELIST_CODE_BB = 2 // BB: [index..., bb-id]
437 enum AttributeKindCodes {
439 ATTR_KIND_ALIGNMENT = 1,
440 ATTR_KIND_ALWAYS_INLINE = 2,
441 ATTR_KIND_BY_VAL = 3,
442 ATTR_KIND_INLINE_HINT = 4,
443 ATTR_KIND_IN_REG = 5,
444 ATTR_KIND_MIN_SIZE = 6,
447 ATTR_KIND_NO_ALIAS = 9,
448 ATTR_KIND_NO_BUILTIN = 10,
449 ATTR_KIND_NO_CAPTURE = 11,
450 ATTR_KIND_NO_DUPLICATE = 12,
451 ATTR_KIND_NO_IMPLICIT_FLOAT = 13,
452 ATTR_KIND_NO_INLINE = 14,
453 ATTR_KIND_NON_LAZY_BIND = 15,
454 ATTR_KIND_NO_RED_ZONE = 16,
455 ATTR_KIND_NO_RETURN = 17,
456 ATTR_KIND_NO_UNWIND = 18,
457 ATTR_KIND_OPTIMIZE_FOR_SIZE = 19,
458 ATTR_KIND_READ_NONE = 20,
459 ATTR_KIND_READ_ONLY = 21,
460 ATTR_KIND_RETURNED = 22,
461 ATTR_KIND_RETURNS_TWICE = 23,
462 ATTR_KIND_S_EXT = 24,
463 ATTR_KIND_STACK_ALIGNMENT = 25,
464 ATTR_KIND_STACK_PROTECT = 26,
465 ATTR_KIND_STACK_PROTECT_REQ = 27,
466 ATTR_KIND_STACK_PROTECT_STRONG = 28,
467 ATTR_KIND_STRUCT_RET = 29,
468 ATTR_KIND_SANITIZE_ADDRESS = 30,
469 ATTR_KIND_SANITIZE_THREAD = 31,
470 ATTR_KIND_SANITIZE_MEMORY = 32,
471 ATTR_KIND_UW_TABLE = 33,
472 ATTR_KIND_Z_EXT = 34,
473 ATTR_KIND_BUILTIN = 35,
475 ATTR_KIND_OPTIMIZE_NONE = 37,
476 ATTR_KIND_IN_ALLOCA = 38,
477 ATTR_KIND_NON_NULL = 39,
478 ATTR_KIND_JUMP_TABLE = 40,
479 ATTR_KIND_DEREFERENCEABLE = 41,
480 ATTR_KIND_DEREFERENCEABLE_OR_NULL = 42,
481 ATTR_KIND_CONVERGENT = 43,
482 ATTR_KIND_SAFESTACK = 44,
483 ATTR_KIND_ARGMEMONLY = 45,
484 ATTR_KIND_SWIFT_SELF = 46,
485 ATTR_KIND_SWIFT_ERROR = 47,
486 ATTR_KIND_NO_RECURSE = 48
489 enum ComdatSelectionKindCodes {
490 COMDAT_SELECTION_KIND_ANY = 1,
491 COMDAT_SELECTION_KIND_EXACT_MATCH = 2,
492 COMDAT_SELECTION_KIND_LARGEST = 3,
493 COMDAT_SELECTION_KIND_NO_DUPLICATES = 4,
494 COMDAT_SELECTION_KIND_SAME_SIZE = 5,
497 } // End bitc namespace
498 } // End llvm namespace