Help with the 'WritingAnLLVMPass' tutorial


I’m making my way through the WritingAnLLVMPass tutorial and hitting the following issue.

$ opt -load …/…/…/Debug+Asserts/lib/ -hello < hello.bc > /dev/null
opt: symbol lookup error: …/…/…/Debug+Asserts/lib/ undefined symbol: AnnotateHappensAfter

nm -g …/…/…/Debug+Asserts/lib/

U AnnotateHappensAfter

$ ldd …/…/…/Debug+Asserts/lib/ => (0x00007fffa87fe000) => /lib64/ (0x00007f21b409e000) => /lib64/ (0x00007f21b3e80000) => /lib64/ (0x00007f21b3c56000) => /lib64/ (0x00007f21b3a52000) => /lib64/ (0x00007f21b374a000) => /lib64/ (0x00007f21b3442000) => /lib64/ (0x00007f21b322c000) => /lib64/ (0x00007f21b2e6c000)
/lib64/ (0x0000003baaa00000)

Am I not linking against some library I should have?


If AnnotateHappensAfter is from one of the LLVM libraries, then you must make sure your pass links with that library. When you find the library that AnnotateHappensAfter lives in, be sure that library is included in the LINK_COMPONENTS or USED_LIBS variable in your Makefile. That’s what I suspect the problem is, anyway. Regards, John Criswell

Hi John,

Thanks for the hints!

After some grep and nm magic, it seems like I had to do the following:

  • Run configure in the root directory
  • Run make in ./lib/Support
  • Add ‘USEDLIBS = LLVMSupport.a’ in the Hello Makefile

Now, I see:

$ opt -load …/…/…/Debug+Asserts/lib/ -hello < hello.bc > /dev/null
Hello: main

Another workaround was to turn off thread support by setting LLVM_ENABLE_THREADS to 0 in llvm-config.h. Not sure what the implications of this are though.

I detail the changes needed above so that the llvm maintainers can consider updating the tutorial.

As another side, the tutorial suggests that the output of opt command above will be following:

$ opt -load …/…/…/Debug+Asserts/lib/ -hello < hello.bc > /dev/null
Hello: __main
Hello: puts
Hello: main

But hello.bc defines just one function: main so I see a different output. Another update that can be considered for the tutorial.