[llvm] [llvm][IR] Add per-global code model attribute (PR #72077)

via llvm-commits llvm-commits at lists.llvm.org
Wed Nov 15 02:27:15 PST 2023


https://github.com/heiher updated https://github.com/llvm/llvm-project/pull/72077

>From b162e86cd5391d3fbf97ee0593bef01f6e91b286 Mon Sep 17 00:00:00 2001
From: WANG Rui <wangrui at loongson.cn>
Date: Fri, 10 Nov 2023 21:07:43 -0600
Subject: [PATCH] [llvm][IR] Add per-global code model attribute

This adds a per-global code model attribute, which can override
the target's code model to access global variables.

Link: https://discourse.llvm.org/t/how-to-best-implement-code-model-overriding-for-certain-values/71816

Suggested-by: Arthur Eubanks <aeubanks at google.com>
Signed-off-by: WANG Rui <wangrui at loongson.cn>
---
 llvm/docs/LangRef.rst                         |  11 +++++++
 llvm/include/llvm/AsmParser/LLParser.h        |   1 +
 llvm/include/llvm/AsmParser/LLToken.h         |   1 +
 llvm/include/llvm/IR/GlobalObject.h           |  27 ++++++++++++++++
 llvm/lib/AsmParser/LLLexer.cpp                |   1 +
 llvm/lib/AsmParser/LLParser.cpp               |  29 ++++++++++++++++++
 llvm/lib/Bitcode/Reader/BitcodeReader.cpp     |  25 +++++++++++++++
 llvm/lib/Bitcode/Writer/BitcodeWriter.cpp     |   5 +--
 llvm/lib/IR/AsmWriter.cpp                     |  21 +++++++++++++
 llvm/lib/IR/Globals.cpp                       |  11 +++++++
 .../Bitcode/global-variables-code-model.ll    |  17 ++++++++++
 .../Bitcode/global-variables-code-model.ll.bc | Bin 0 -> 1568 bytes
 12 files changed, 147 insertions(+), 2 deletions(-)
 create mode 100644 llvm/test/Bitcode/global-variables-code-model.ll
 create mode 100644 llvm/test/Bitcode/global-variables-code-model.ll.bc

diff --git a/llvm/docs/LangRef.rst b/llvm/docs/LangRef.rst
index ff4f769dcc0dbac..e61442f2fd9195b 100644
--- a/llvm/docs/LangRef.rst
+++ b/llvm/docs/LangRef.rst
@@ -701,6 +701,9 @@ information. Attaching section information to an external declaration is an
 assertion that its definition is located in the specified section. If the
 definition is located in a different section, the behavior is undefined.
 
+LLVM allows an explicit code model to be specified for globals. If the
+target supports it, it will emit globals in the code model specified.
+
 By default, global initializers are optimized by assuming that global
 variables defined within the module are not modified from their
 initial values before the start of the global initializer. This is
@@ -757,6 +760,7 @@ Syntax::
                          <global | constant> <Type> [<InitializerConstant>]
                          [, section "name"] [, partition "name"]
                          [, comdat [($name)]] [, align <Alignment>]
+                         [, code_model "model"]
                          [, no_sanitize_address] [, no_sanitize_hwaddress]
                          [, sanitize_address_dyninit] [, sanitize_memtag]
                          (, !name !N)*
@@ -774,6 +778,13 @@ The following example just declares a global variable
 
    @G = external global i32
 
+The following example defines a global variable with the
+``large`` code model:
+
+.. code-block:: llvm
+
+    @G = internal global i32 0, code_model "large"
+
 The following example defines a thread-local global with the
 ``initialexec`` TLS model:
 
diff --git a/llvm/include/llvm/AsmParser/LLParser.h b/llvm/include/llvm/AsmParser/LLParser.h
index eca908a24aac7b2..9e5968c5917f73f 100644
--- a/llvm/include/llvm/AsmParser/LLParser.h
+++ b/llvm/include/llvm/AsmParser/LLParser.h
@@ -290,6 +290,7 @@ namespace llvm {
     bool parseOptionalCallingConv(unsigned &CC);
     bool parseOptionalAlignment(MaybeAlign &Alignment,
                                 bool AllowParens = false);
+    bool parseOptionalCodeModel(CodeModel::Model &model);
     bool parseOptionalDerefAttrBytes(lltok::Kind AttrKind, uint64_t &Bytes);
     bool parseOptionalUWTableKind(UWTableKind &Kind);
     bool parseAllocKind(AllocFnKind &Kind);
diff --git a/llvm/include/llvm/AsmParser/LLToken.h b/llvm/include/llvm/AsmParser/LLToken.h
index c9dcd29b31955dc..56a8db2d68df238 100644
--- a/llvm/include/llvm/AsmParser/LLToken.h
+++ b/llvm/include/llvm/AsmParser/LLToken.h
@@ -115,6 +115,7 @@ enum Kind {
   kw_addrspace,
   kw_section,
   kw_partition,
+  kw_code_model,
   kw_alias,
   kw_ifunc,
   kw_module,
diff --git a/llvm/include/llvm/IR/GlobalObject.h b/llvm/include/llvm/IR/GlobalObject.h
index 889bd3a28e12b37..592b7e0cb33ab54 100644
--- a/llvm/include/llvm/IR/GlobalObject.h
+++ b/llvm/include/llvm/IR/GlobalObject.h
@@ -18,6 +18,7 @@
 #include "llvm/IR/GlobalValue.h"
 #include "llvm/IR/Value.h"
 #include "llvm/Support/Alignment.h"
+#include "llvm/Support/CodeGen.h"
 
 namespace llvm {
 
@@ -51,6 +52,7 @@ class GlobalObject : public GlobalValue {
   Comdat *ObjComdat = nullptr;
   enum {
     LastAlignmentBit = 5,
+    LastCodeModelBit = 8,
     HasSectionHashEntryBit,
 
     GlobalObjectBits,
@@ -61,6 +63,9 @@ class GlobalObject : public GlobalValue {
 private:
   static const unsigned AlignmentBits = LastAlignmentBit + 1;
   static const unsigned AlignmentMask = (1 << AlignmentBits) - 1;
+  static const unsigned CodeModelBits = LastCodeModelBit - LastAlignmentBit;
+  static const unsigned CodeModelMask = (1 << CodeModelBits) - 1;
+  static const unsigned CodeModelShift = AlignmentBits;
   static const unsigned GlobalObjectMask = (1 << GlobalObjectBits) - 1;
 
 public:
@@ -124,6 +129,28 @@ class GlobalObject : public GlobalValue {
   /// appropriate default object file section.
   void setSection(StringRef S);
 
+  /// Get the custom code model raw value of this global.
+  ///
+  unsigned getCodeModelRaw() const {
+    unsigned Data = getGlobalValueSubClassData();
+    return (Data >> CodeModelShift) & CodeModelMask;
+  }
+
+  /// Get the custom code model of this global if it has one.
+  ///
+  /// If this global does not have a custom code model, the empty instance
+  /// will be returned.
+  std::optional<CodeModel::Model> getCodeModel() const {
+    unsigned CodeModelData = getCodeModelRaw();
+    if (CodeModelData > 0)
+      return static_cast<CodeModel::Model>(CodeModelData - 1);
+    return {};
+  }
+
+  /// Change the code model for this global.
+  ///
+  void setCodeModel(CodeModel::Model CM);
+
   bool hasComdat() const { return getComdat() != nullptr; }
   const Comdat *getComdat() const { return ObjComdat; }
   Comdat *getComdat() { return ObjComdat; }
diff --git a/llvm/lib/AsmParser/LLLexer.cpp b/llvm/lib/AsmParser/LLLexer.cpp
index da9e9f4a3c9833b..3b96f0e4fe866bd 100644
--- a/llvm/lib/AsmParser/LLLexer.cpp
+++ b/llvm/lib/AsmParser/LLLexer.cpp
@@ -570,6 +570,7 @@ lltok::Kind LLLexer::LexIdentifier() {
   KEYWORD(addrspace);
   KEYWORD(section);
   KEYWORD(partition);
+  KEYWORD(code_model);
   KEYWORD(alias);
   KEYWORD(ifunc);
   KEYWORD(module);
diff --git a/llvm/lib/AsmParser/LLParser.cpp b/llvm/lib/AsmParser/LLParser.cpp
index 9940bfb15d1979e..784f2e71c726a67 100644
--- a/llvm/lib/AsmParser/LLParser.cpp
+++ b/llvm/lib/AsmParser/LLParser.cpp
@@ -1286,6 +1286,11 @@ bool LLParser::parseGlobal(const std::string &Name, LocTy NameLoc,
         return true;
       if (Alignment)
         GV->setAlignment(*Alignment);
+    } else if (Lex.getKind() == lltok::kw_code_model) {
+      CodeModel::Model CodeModel;
+      if (parseOptionalCodeModel(CodeModel))
+        return true;
+      GV->setCodeModel(CodeModel);
     } else if (Lex.getKind() == lltok::MetadataVar) {
       if (parseGlobalObjectMetadataAttachment(*GV))
         return true;
@@ -2166,6 +2171,30 @@ bool LLParser::parseOptionalAlignment(MaybeAlign &Alignment, bool AllowParens) {
   return false;
 }
 
+/// parseOptionalCodeModel
+///   ::= /* empty */
+///   ::= 'code_model' "large"
+bool LLParser::parseOptionalCodeModel(CodeModel::Model &model) {
+  Lex.Lex();
+  auto StrVal = Lex.getStrVal();
+  auto ErrMsg = "expected global code model string";
+  if (StrVal == "tiny")
+    model = CodeModel::Tiny;
+  else if (StrVal == "small")
+    model = CodeModel::Small;
+  else if (StrVal == "kernel")
+    model = CodeModel::Kernel;
+  else if (StrVal == "medium")
+    model = CodeModel::Medium;
+  else if (StrVal == "large")
+    model = CodeModel::Large;
+  else
+    return tokError(ErrMsg);
+  if (parseToken(lltok::StringConstant, ErrMsg))
+    return true;
+  return false;
+}
+
 /// parseOptionalDerefAttrBytes
 ///   ::= /* empty */
 ///   ::= AttrKind '(' 4 ')'
diff --git a/llvm/lib/Bitcode/Reader/BitcodeReader.cpp b/llvm/lib/Bitcode/Reader/BitcodeReader.cpp
index 76431e883b8d96d..9da27e00a8c0595 100644
--- a/llvm/lib/Bitcode/Reader/BitcodeReader.cpp
+++ b/llvm/lib/Bitcode/Reader/BitcodeReader.cpp
@@ -1144,6 +1144,23 @@ static bool getDecodedDSOLocal(unsigned Val) {
   }
 }
 
+static std::optional<CodeModel::Model> getDecodedCodeModel(unsigned Val) {
+  switch (Val) {
+  case 1:
+    return CodeModel::Tiny;
+  case 2:
+    return CodeModel::Small;
+  case 3:
+    return CodeModel::Kernel;
+  case 4:
+    return CodeModel::Medium;
+  case 5:
+    return CodeModel::Large;
+  }
+
+  return {};
+}
+
 static GlobalVariable::ThreadLocalMode getDecodedThreadLocalMode(unsigned Val) {
   switch (Val) {
     case 0: return GlobalVariable::NotThreadLocal;
@@ -3809,6 +3826,7 @@ Error BitcodeReader::parseGlobalVarRecord(ArrayRef<uint64_t> Record) {
   // dllstorageclass, comdat, attributes, preemption specifier,
   // partition strtab offset, partition strtab size] (name in VST)
   // v2: [strtab_offset, strtab_size, v1]
+  // v3: [v2, code_model]
   StringRef Name;
   std::tie(Name, Record) = readNameFromStrtab(Record);
 
@@ -3917,6 +3935,13 @@ Error BitcodeReader::parseGlobalVarRecord(ArrayRef<uint64_t> Record) {
     NewGV->setSanitizerMetadata(Meta);
   }
 
+  if (Record.size() > 17 && Record[17]) {
+    if (auto CM = getDecodedCodeModel(Record[17]))
+      NewGV->setCodeModel(*CM);
+    else
+      return error("Invalid global variable code model");
+  }
+
   return Error::success();
 }
 
diff --git a/llvm/lib/Bitcode/Writer/BitcodeWriter.cpp b/llvm/lib/Bitcode/Writer/BitcodeWriter.cpp
index d16b5c7781c2413..be6779a05aa3122 100644
--- a/llvm/lib/Bitcode/Writer/BitcodeWriter.cpp
+++ b/llvm/lib/Bitcode/Writer/BitcodeWriter.cpp
@@ -1404,7 +1404,7 @@ void ModuleBitcodeWriter::writeModuleInfo() {
     // GLOBALVAR: [strtab offset, strtab size, type, isconst, initid,
     //             linkage, alignment, section, visibility, threadlocal,
     //             unnamed_addr, externally_initialized, dllstorageclass,
-    //             comdat, attributes, DSO_Local, GlobalSanitizer]
+    //             comdat, attributes, DSO_Local, GlobalSanitizer, code_model]
     Vals.push_back(addToStrtab(GV.getName()));
     Vals.push_back(GV.getName().size());
     Vals.push_back(VE.getTypeID(GV.getValueType()));
@@ -1421,7 +1421,7 @@ void ModuleBitcodeWriter::writeModuleInfo() {
         GV.isExternallyInitialized() ||
         GV.getDLLStorageClass() != GlobalValue::DefaultStorageClass ||
         GV.hasComdat() || GV.hasAttributes() || GV.isDSOLocal() ||
-        GV.hasPartition() || GV.hasSanitizerMetadata()) {
+        GV.hasPartition() || GV.hasSanitizerMetadata() || GV.getCodeModel()) {
       Vals.push_back(getEncodedVisibility(GV));
       Vals.push_back(getEncodedThreadLocalMode(GV));
       Vals.push_back(getEncodedUnnamedAddr(GV));
@@ -1439,6 +1439,7 @@ void ModuleBitcodeWriter::writeModuleInfo() {
       Vals.push_back((GV.hasSanitizerMetadata() ? serializeSanitizerMetadata(
                                                       GV.getSanitizerMetadata())
                                                 : 0));
+      Vals.push_back(GV.getCodeModelRaw());
     } else {
       AbbrevToUse = SimpleGVarAbbrev;
     }
diff --git a/llvm/lib/IR/AsmWriter.cpp b/llvm/lib/IR/AsmWriter.cpp
index 6d66b34423949fb..85948bb63c8a007 100644
--- a/llvm/lib/IR/AsmWriter.cpp
+++ b/llvm/lib/IR/AsmWriter.cpp
@@ -3647,6 +3647,27 @@ void AssemblyWriter::printGlobal(const GlobalVariable *GV) {
     printEscapedString(GV->getPartition(), Out);
     Out << '"';
   }
+  if (auto CM = GV->getCodeModel()) {
+    Out << ", code_model \"";
+    switch (*CM) {
+    case CodeModel::Tiny:
+      printEscapedString("tiny", Out);
+      break;
+    case CodeModel::Small:
+      printEscapedString("small", Out);
+      break;
+    case CodeModel::Kernel:
+      printEscapedString("kernel", Out);
+      break;
+    case CodeModel::Medium:
+      printEscapedString("medium", Out);
+      break;
+    case CodeModel::Large:
+      printEscapedString("large", Out);
+      break;
+    }
+    Out << '"';
+  }
 
   using SanitizerMetadata = llvm::GlobalValue::SanitizerMetadata;
   if (GV->hasSanitizerMetadata()) {
diff --git a/llvm/lib/IR/Globals.cpp b/llvm/lib/IR/Globals.cpp
index 7bd4503a689e4ae..fb9d56598298791 100644
--- a/llvm/lib/IR/Globals.cpp
+++ b/llvm/lib/IR/Globals.cpp
@@ -139,6 +139,8 @@ void GlobalObject::copyAttributesFrom(const GlobalObject *Src) {
   GlobalValue::copyAttributesFrom(Src);
   setAlignment(Src->getAlign());
   setSection(Src->getSection());
+  if (auto CM = Src->getCodeModel())
+    setCodeModel(*CM);
 }
 
 std::string GlobalValue::getGlobalIdentifier(StringRef Name,
@@ -263,6 +265,15 @@ void GlobalObject::setSection(StringRef S) {
   setGlobalObjectFlag(HasSectionHashEntryBit, !S.empty());
 }
 
+void GlobalObject::setCodeModel(CodeModel::Model CM) {
+  unsigned CodeModelData = static_cast<unsigned>(CM) + 1;
+  unsigned OldData = getGlobalValueSubClassData();
+  unsigned NewData = (OldData & ~(CodeModelMask << CodeModelShift)) |
+                     (CodeModelData << CodeModelShift);
+  setGlobalValueSubClassData(NewData);
+  assert(getCodeModel() == CM && "Code model representation error!");
+}
+
 bool GlobalValue::isNobuiltinFnDef() const {
   const Function *F = dyn_cast<Function>(this);
   if (!F || F->empty())
diff --git a/llvm/test/Bitcode/global-variables-code-model.ll b/llvm/test/Bitcode/global-variables-code-model.ll
new file mode 100644
index 000000000000000..f8cae4475028510
--- /dev/null
+++ b/llvm/test/Bitcode/global-variables-code-model.ll
@@ -0,0 +1,17 @@
+; RUN:  llvm-dis < %s.bc| FileCheck %s
+; RUN:  verify-uselistorder < %s.bc
+
+ at tiny.var = global i32 1, code_model "tiny"
+; CHECK: @tiny.var = global i32 1, code_model "tiny"
+
+ at small.var = global i32 1, code_model "small"
+; CHECK: @small.var = global i32 1, code_model "small"
+
+ at kernel.var = global i32 1, code_model "kernel"
+; CHECK: @kernel.var = global i32 1, code_model "kernel"
+
+ at medium.var = global i32 1, code_model "medium"
+; CHECK: @medium.var = global i32 1, code_model "medium"
+
+ at large.var = global i32 1, code_model "large"
+; CHECK: @large.var = global i32 1, code_model "large"
diff --git a/llvm/test/Bitcode/global-variables-code-model.ll.bc b/llvm/test/Bitcode/global-variables-code-model.ll.bc
new file mode 100644
index 0000000000000000000000000000000000000000..c63ce041784a83952fb76450e43571c34a946da1
GIT binary patch
literal 1568
zcmXw3Z%i9y7{9jAD^TAn3v<-nop-<{9|Ue?xOQ!mwl}p-7Q6W;n7FK0Xc?|RDP8$9
zV_J at Rp#9L1#x#lvm?i%C#3m;DK-}76tYdZJG=@Y%T4@<G-5?H^na#xaKrXrG-sjDG
z&-45Jp67XO?6u{l3Ir)e5X7ZsYL318gXhO5({Joe)f|!OiV<3kAaBbMq)bjDa(HGB
ze9>_A1#7D4HKj&p7?TaF_Z6$OWYH(Ckm_Z*ZLG|8M5C+Ft14eF)m4qyeY14+kzGPW
zV;z&XrBs(HDE5^R>ZVLrHQWNC<@Ay0<j|LLt%%;*T~ZZMk5ULy0&`S(iZqvPL!+7#
z&_sKZ4tr_Ie%oBJt!lqY`B^o>hY{o`rYaw^d=!ZxvV*qxcvALxXZO{$yy4${&A;5}
z_WyI%bM-nGyhVQcmFNl%EI)VkX8xTg$Lha3>3sxBE%F3Rv;D|IPV{_D*tz3}kkAzW
zam>Q(Y*-NIqP6oVRk^c4A(q0#JXKPp*x4yUN=KiOpZ^|;blI}4r;d!PwdKvxNXh<J
z=Ze^Gi{RNyFocx2Q5C{xv$&^1W*%Yn!(zl1LI?WM-gu9C6~XRnz-9<Es%>O4LEN6i
zJxuY|F at A4aVNS8;h{Bxij|6<^ITbo!7koZ+(5DFY3qDHFrprMg3bG8=#b7HNV8a0#
zHM7JrjW5zfk|RCLsBwljF0h7ag=vO24J(Z4jf$WXJ$D*CbXxF38xnj`!RJJSwP^5h
zF$~)m5>Bavo=U+V7Y5?t7aweZ2O049HBev_uGA!+o5a&wc8SC1X?!+J%yY`$qO2js
z8sb~_il~pV`VoaOCN{vNPlt at ZDvVR2`bLM~YZ3fDK5!cCcM5?@Auu6mZ at -B>K(N0Y
zAQuHI7A#AF0%Sqe5=#j(X(jK__)?f$%HX*y at u!URR36t)v4_WbW7<*kKM|+U*N^tc
zk2h~dF-ZaPeR7_|*JxrnL3}79CBQVX!71N5&+F5oaf&rVL7pZ}Io3D=T`_XK6fzb1
zARZMuSd04O;rCWFpl}W39pE8Tow#EqbJ;zMSz;LiuxpJ|ym^}6J1puWtRXF$t|Sa8
z5pp!8?bAIf6r$>Z0=5X+-{(NViQUgAHz+L6V0j9A<N#e7u)+Z7KFlcZWkAjW9y8T{
z6gWH?CKj`M3N*1w6SFh{E4W5K at 1edh&amby3PX%Hq+4cS^&#0oh|@0g`2_8)yI`Hc
zvKesCg58^dSwxwl_iGe#ITeSkA}JhLfTau%TMZczN at s?ZN?T?pi1|q(V<ndpxTmI-
z0a>ZO7z~nUSeiduiT2usQxn1mA^7j5n9LLrO)*iwz#fL}l!l6_?euONM?$E#6U2#d
zg{Qfl0qYdDo>8tluuUlx$Y+$R6qa28c{l?X;4DaYN}1ZFkxwAVH_)$>{8E1{>^XF>
z#TSP>C5VOvacC8vn|x-?Dvbopv0ck&53V at DT?cFtEGIPzcGm$mr$S+LpmwW+`vs`J
zRKFJAxTv3&887nYm?%F3hXG&8;!6~s<0QKlCX*b#Fo~zOMduPSY!d>7xI>_9WSe~P
zPkKmo5jM04r8mM#!#PYTj1V&Nvj#zw at QbER7kT42Y;=Wrf;YjYkBad6M0%)gt~#Kp
zlI{WNISKF97vOi7BF0E(0v%lg^+C?x+sS#o(&CKU-{sy~b-LR+&UQ+BUe4d{mKF!}
z^-Mj}-VvbOx+c!e8FZZfCC<gT44nIb+u%9Wrsobewz?Xd4tNf=HZo1EUT?6oA>i%}
nG}t-<t=(<zhIVhai}TjOXdRr(>+Y?ScI!H!@z#6262|`k8uBb>

literal 0
HcmV?d00001




More information about the llvm-commits mailing list