This is an archive of the discontinued LLVM Phabricator instance.

Place the BlockAddress type in the address space of the containing function
ClosedPublic

Authored by arichardson on Jun 30 2018, 6:26 AM.

Details

Summary

While this should not matter for most architectures (where the program
address space is 0), it is important for CHERI. We use address space 200
for all of our code pointers and without this change we assert in
SelectionDAG handling of BlockAddress nodes.

It is also useful for AVR: previously programs targeting
AVR that attempt to read their own machine code
via a pointer to a label would instead read from RAM
using a pointer relative to the the start of program flash.

Diff Detail

Event Timeline

arichardson created this revision.Jun 30 2018, 6:26 AM
bjope added a comment.Jul 2 2018, 5:43 AM

I don't know much about the BlockAddress concept. The LangRef says things like "always has an i8* type" and "this may be passed around as an opaque pointer sized value". But I guess it would be weird if the size doesn't match the size of pointers in the program address space, so the patch makes sense to me.

I assume that this can't be reproduced for any in-tree target?
If you can't find an in-tree reproducer, then maybe you can describe the problem a little bit more instead. Such as which assert you hit, and maybe a small stack trace. That might help when trying to motivate this patch in the future.

I don't know much about the BlockAddress concept. The LangRef says things like "always has an i8* type" and "this may be passed around as an opaque pointer sized value". But I guess it would be weird if the size doesn't match the size of pointers in the program address space, so the patch makes sense to me.

I assume that this can't be reproduced for any in-tree target?
If you can't find an in-tree reproducer, then maybe you can describe the problem a little bit more instead. Such as which assert you hit, and maybe a small stack trace. That might help when trying to motivate this patch in the future.

Yes I'm not sure I can make a test for this with any of the existing targets. I'll see if I can get something with AVR since that sets program address space to 1.

Nice patch, this looks useful!

Yes I'm not sure I can make a test for this with any of the existing targets. I'll see if I can get something with AVR since that sets program address space to 1.

Here's a test for you that does it.

There's another bug in LLParser that stops nonzero program address spaces from working; if the function referenced in a block address is not known in the first pass of the LLParser (for example, when the blockaddress exists earlier in the IR file than the function definition, the LLParser must insert a forward reference for the function. It does this by creating a new global variable, but it unconditionally left the global variable in the default address space of zero.

The diff I have included has a fix for this.

I've also amended the LangRef docs so that they would be accurate under the new patch.

diff --git a/docs/LangRef.rst b/docs/LangRef.rst
index 06e092fb9fc..deac223d1a1 100644
--- a/docs/LangRef.rst
+++ b/docs/LangRef.rst
@@ -3275,7 +3275,16 @@ Addresses of Basic Blocks
 ``blockaddress(@function, %block)``
 
 The '``blockaddress``' constant computes the address of the specified
-basic block in the specified function, and always has an ``i8*`` type.
+basic block in the specified function.
+
+It always has an ``i8 addrspace(P)*`` type, where ``P`` is the program
+memory address space specified in the data layout. For targets that place
+code and data in the same address space (Von-Neumann architectures) a block
+address will have the same address space as data pointers, usually
+``addrspace(0)``. Block addresses on targets that have different data and
+code address spaces (Harvard architectures) will always be in the program
+memory address space specified in the target's data layout.
+
 Taking the address of the entry block is illegal.
 
 This value only has defined behavior when used as an operand to the
diff --git a/lib/AsmParser/LLParser.cpp b/lib/AsmParser/LLParser.cpp
index 5fe1e125d48..6581436c20f 100644
--- a/lib/AsmParser/LLParser.cpp
+++ b/lib/AsmParser/LLParser.cpp
@@ -3154,9 +3154,13 @@ bool LLParser::ParseValID(ValID &ID, PerFunctionState *PFS) {
                                               std::map<ValID, GlobalValue *>()))
               .first->second.insert(std::make_pair(std::move(Label), nullptr))
               .first->second;
-      if (!FwdRef)
+      if (!FwdRef) {
         FwdRef = new GlobalVariable(*M, Type::getInt8Ty(Context), false,
-                                    GlobalValue::InternalLinkage, nullptr, "");
+                                  GlobalValue::InternalLinkage, nullptr, "",
+                                  nullptr, GlobalValue::NotThreadLocal,
+                                  M->getDataLayout().getProgramAddressSpace());
+      }
+
       ID.ConstantVal = FwdRef;
       ID.Kind = ValID::t_Constant;
       return false;
diff --git a/test/CodeGen/AVR/block-address-is-in-progmem-space.ll b/test/CodeGen/AVR/block-address-is-in-progmem-space.ll
new file mode 100644
index 00000000000..8e6e3a71062
--- /dev/null
+++ b/test/CodeGen/AVR/block-address-is-in-progmem-space.ll
@@ -0,0 +1,51 @@
+; RUN: llc -mcpu=atmega328 < %s -march=avr | FileCheck %s
+
+; This test verifies that the pointer to a basic block
+; should always be a pointer in address space 1.
+;
+; If this were not the case, then programs targeting
+; AVR that attempted to read their own machine code
+; via a pointer to a label would actually read from RAM
+; using a pointer relative to the the start of program flash.
+;
+; This would cause a load of uninitialized memory, not even
+; touching the program's machine code as otherwise desired.
+
+target datalayout = "e-P1-p:16:8-i8:8-i16:8-i32:8-i64:8-f32:8-f64:8-n8-a:8"
+
+; CHECK-LABEL: load_with_no_forward_reference
+define i8 @load_with_no_forward_reference(i8 %a, i8 %b) {
+second:
+  ; CHECK:      ldi r30, .Ltmp0+2
+  ; CHECK-NEXT: ldi r31, .Ltmp0+4
+  ; CHECK: lpm r24, Z
+  %bar = load i8, i8 addrspace(1)* blockaddress(@function_with_no_forward_reference, %second)
+  ret i8 %bar
+}
+
+; CHECK-LABEL: load_from_local_label
+define i8 @load_from_local_label(i8 %a, i8 %b) {
+entry:
+  %result1 = add i8 %a, %b
+
+  br label %second
+
+; CHECK-LABEL: .Ltmp1:
+second:
+  ; CHECK:      ldi r30, .Ltmp1+2
+  ; CHECK-NEXT: ldi r31, .Ltmp1+4
+  ; CHECK-NEXT: lpm r24, Z
+  %result2 = load i8, i8 addrspace(1)* blockaddress(@load_from_local_label, %second)
+  ret i8 %result2
+}
+
+; A function with no forward reference, right at the end
+; of the file.
+define i8 @function_with_no_forward_reference(i8 %a, i8 %b) {
+entry:
+  %result = add i8 %a, %b
+  br label %second
+second:
+  ret i8 0
+}
+
dylanmckay requested changes to this revision.Nov 15 2018, 11:05 PM
This revision now requires changes to proceed.Nov 15 2018, 11:05 PM

Rebase on latest master and merge suggestions

Herald added a project: Restricted Project. · View Herald Transcript
Herald added subscribers: Jim, hiraditya. · View Herald Transcript

clang-format

theraven accepted this revision.Sep 2 2020, 1:56 AM

Looks good to me. This bakes in the assumption that function pointers and basic block addresses are always in the same address space. That seems reasonable to me but it might be worth documenting in the DataLayout docs about the program address space.

arichardson edited the summary of this revision. (Show Details)Sep 7 2020, 2:28 AM

@dylanmckay does this change look good to you now?

arsenm added inline comments.Sep 9 2020, 8:02 AM
llvm/lib/AsmParser/LLParser.cpp
3538

Why wouldn't this come from the parent function? You should be able to mix functions with different address spaces in the same module

bjope added inline comments.Oct 5 2020, 4:42 AM
llvm/lib/AsmParser/LLParser.cpp
3538

(Maybe @arichardson got a different reason, but sharing my point-of-view here anyway.)

While it's possible to annotate calls and functions definitions with non-zero program address spaces, I think one need to be consistent. I don't think we really support multiple program address spaces (is there an actual use case for supporting that?).

I'm also not exactly sure what you mean by "parent function". The addrspce in the resulting pointer type need to match the addrspace of the function referenced in the first argument of the blockaddress. And that function has not been defined yet, since we are inside the "!F" clause.

I guess we have to trust the datalayout if the function hasn't been defined yet (or use some kind of forward ref and backtrack to fill in addrspace to get the correct type later). I wonder if we'd get some kind of type error later if we assume that datalayout is correct here, and we find a different addrspace when finding the function definition later?

(We also got the usual problem that if datalayout is set by a datalayout definition that comes later in the ll file we haven't parsed the datalayout yet. But if I remember correclty that is a general problem also for the function definitions etc.)

dylanmckay requested changes to this revision.Oct 27 2020, 4:29 AM
dylanmckay added inline comments.
llvm/lib/AsmParser/LLParser.cpp
3538

I'm also not exactly sure what you mean by "parent function". The addrspce in the resulting pointer type need to match the addrspace of the function referenced in the first argument of the blockaddress. And that function has not been defined yet, since we are inside the "!F" clause.

I suspect @arsenm is suggesting that the address space be copied from the LLParserPerFunctionState* PFS argument this function has.

For example, replace M->getDataLayout().getProgramAddressSpace() with PFS->getFunction()->getFunctionType()->getPointerAddressSpace()

This seems like a better alternative, as it means that if a function did opt to use a different address space from the program address space in the data layout, the blockaddresses within it will use that same address space rather than assuming the one from the datalayout.

This also makes an assumption about the address space of the target function, although I feel the case for that assumption is stronger than the current one of "assume address space from datalayout" as the address space from the parent function could be considered "closer to the source". Indeed, we directly lookup the actual address space for this block address in this branch as this is the case for when the actual function has not been defined yet and so the address space information is not available.

Please make this replacement and then the patch should be good to go.

This revision now requires changes to proceed.Oct 27 2020, 4:29 AM
arichardson planned changes to this revision.Oct 27 2020, 4:32 AM
arichardson added inline comments.
llvm/lib/AsmParser/LLParser.cpp
3538

Thanks, will do that and add a test case.

bjope added inline comments.Oct 27 2020, 5:28 AM
llvm/lib/AsmParser/LLParser.cpp
3538

Well, taking the address space from the wrong function does not help for "You should be able to mix functions with different address spaces in the same module.".

If heading in that direction then please add some nifty code comment explaining what is going on. When using the datalayout from the module it is easy to understand that we aren't using any function specific information, but if you use the function pointer from the wrong function to derive the address space it might fool someone that it either is the correct function that is being used, or that it is an "unintended bug" rather than a "hacky workaround".

arsenm added inline comments.Oct 29 2020, 1:21 PM
llvm/lib/AsmParser/LLParser.cpp
3538

block address is always in the context of a function, there's no wrong function to choose. You just use the address space from the parent function

bjope added inline comments.Oct 29 2020, 3:11 PM
llvm/lib/AsmParser/LLParser.cpp
3538

Sure, so then we agree that we don't mix address spaces for program (there can be only one and taking it from any function would be ok).

Still, there are at least some lit test cases (for example the AVR/brind.ll test modified in this patch) that have global variables involving blockaddress with forward references to functions not yet defined. In such cases there is no parent function, right? We only got the function referenced in the blockaddress argument, and its definition might not have been parsed yet. Or maybe I've simply misunderstood when we end up in this part of the code (if all the test cases pass I guess things are in order).

arsenm added inline comments.Oct 29 2020, 3:15 PM
llvm/lib/AsmParser/LLParser.cpp
3538

If the function type already exists, its address space is set. It's difficult to go back and rewrite IR types, so I don't think the IR parser would be doing this

arichardson edited the summary of this revision. (Show Details)
  • Make use of per-function state and add various tests
  • Restore Constants.cpp change that was accidentally dropped while updating this revision
arichardson retitled this revision from Place the BlockAddress type in the program address space to Place the BlockAddress type in the address space of the containing function.Nov 29 2020, 5:05 AM
  • Update langref
dstenb added a subscriber: dstenb.Feb 15 2021, 11:19 PM

Hi, @arichardson! What is the status for this patch?

I was waiting for an approval from one of the reviewers since it has changed quite a bit since the initial version.

rebased. @dylanmckay does this look okay now?

arsenm added inline comments.Feb 17 2021, 6:22 AM
llvm/docs/LangRef.rst
4089–4090

I think this is overexplaining it. The IR is the same regardless of what the target wants to do. It should match the code address space of the function

llvm/lib/AsmParser/LLParser.cpp
3540

This should not depend on pointee element types

3542–3543

Pointee types do not really exist, the error should not mention them

arichardson added inline comments.Feb 17 2021, 6:30 AM
llvm/docs/LangRef.rst
4089–4090

I believe the following should be sufficient, right?

It always has an `i8 addrspace(P)* type, where P` is the address space
of the function containing `%block`.

@dylanmckay are you happy with dropping the the remaining text?

arichardson marked an inline comment as done.
  • update error message
  • Simplify langref
llvm/lib/AsmParser/LLParser.cpp
3540

I've kept this check for now (with a TODO) and only updated the error message.

arichardson marked 8 inline comments as done.Mar 8 2021, 2:02 AM

ping?

@dylanmckay ping? Would like to get this committed soon, it's only been 1.5 years

@arsenm / @dylanmckay is this okay to commit now?

I will commit this based on the previous approval in 1 month (1st June) unless there are any further comments.

I will commit this based on the previous approval in 1 month (1st June) unless there are any further comments.

Looks like this wasn't re-approved after the changes were requested.
I would suggest submitting an RFC to llvm-dev.

I will commit this based on the previous approval in 1 month (1st June) unless there are any further comments.

Looks like this wasn't re-approved after the changes were requested.
I would suggest submitting an RFC to llvm-dev.

That makes sense since the pinging here has been ignored.

bjope added a comment.Apr 28 2021, 3:25 AM

FWIW, we have merged this downstream some time ago. If I recall correctly it was related to adding support for inline asm goto.

So the solution seem to work fine for us (but have thought that it would be rude to approve it with @dylanmckay and @arsenm being ping:ed in person).

arsenm added inline comments.Apr 28 2021, 5:58 AM
llvm/lib/AsmParser/LLParser.cpp
3540

No, just rip out the type check. It's not needed now, and if it is, it's the verifier's responsibility to check it

3551

Typos programm adress

3552–3554

I prefer to not add code that you can't test and should be unreachable

Thanks for the review, will update shortly.

llvm/lib/AsmParser/LLParser.cpp
3540

Will move check to verifier if there isn't one already.

3552–3554

Sounds good, will change to llvm_unreachable("").

  • Drop check for i8 as suggested by @arsenm
arichardson marked 4 inline comments as done.Apr 28 2021, 10:19 AM
dylanmckay requested changes to this revision.May 30 2021, 5:12 AM

My apologies for the couple month latency, almost every time I've checked this patch in the last few years there isn't any new activity. It looks like there's one comment from Matt last month that still needs to be addressed (remove a piece of error handling). Once updated, I'd like to get this approved.

llvm/lib/AsmParser/LLParser.cpp
3540

The error

+          if (!ExpectedTy->isPointerTy())
+            return error(ID.Loc,
+                         "type of blockaddress must be a pointer and not '" +
+                             getTypeString(ExpectedTy) + "'");

still exists and hasn't been moved to the verifier or removed from this file.

This revision now requires changes to proceed.May 30 2021, 5:12 AM
arichardson marked an inline comment as done.May 30 2021, 7:28 AM

I believe all remaining issues were addressed in the latest version.

llvm/lib/AsmParser/LLParser.cpp
3540

The problem was checking the pointee type , which I've removed. We need to check if it's a pointer since otherwise we can't call ExpectedTy->getPointerAddressSpace().

dylanmckay accepted this revision.May 31 2021, 9:41 AM

Thanks for the clarification, makes sense. LGTM

This revision is now accepted and ready to land.May 31 2021, 9:41 AM
This revision was landed with ongoing or failed builds.Jul 2 2021, 4:19 AM
This revision was automatically updated to reflect the committed changes.
arichardson marked an inline comment as done.