[lldb-dev] Exported symbols from LLDB build products

[Greg Clayton via lldb-dev]

> On Aug 13, 2015, at 6:43 PM, Bruce Mitchener via lldb-dev <lldb-dev at lists.llvm.org> wrote:
> 
> Hello,
> 
> On Mac OS X, when using the xcode projects, there is some machinery to manage what symbols are exported from various things:
> 
> 	• liblldb only exports the public API.

It currently exports:

_ZN4lldb*
_ZNK4lldb*
init_lld*


> 	• debugserver only exports _DNB* and __DNB*

That is due to legacy stuff and debugserver actually doesn't need to export anything...

> 	• argdumper exports nothing
> 	• lldb-server exports nothing

No executable tools need to ever really export anything, so this can and should almost always be the rules we use in CMake to create executables, not shared libraries, but just executables.

> This machinery only exists within the xcode projects though and isn't used in the cmake or autotools build systems.

We should fix this.

> I'm not interested in adding it to the autotools build system, but I would like to get this set up in the cmake build system.
> 
> The LLVM cmake code provides a helper function for managing this already in a cross-platform manner. The main difference is that it expects one fewer leading underscores in the exports files and a particular naming scheme for the files.
> 
> Managing the files and their names is pretty easy and I can handle that.
> 
> The other difference is a bit harder to manage unless we set up a script to run in the xcode build to perform the mapping (not hard for someone that knows xcode, I guess).

Why? The http://llvm.org/svn/llvm-project/lldb/trunk/resources/lldb-framework-exports file is so simple and it won't change. I don't see the need to do anything special in Xcode to convert some random file into another format.

> 
> So:
> 
> 	• Is this something we want on all platforms? I think the most important of these is limiting liblldb to only exporting the public API.

The lldb.so should limit its exports. It makes the shared library cleaner and easier for the dynamic loaders to deal with.
> 	• Should any other targets have their exported symbols similarly restricted? (Perhaps lldb-mi?)

lldb-mi should export nothing just like argdumper and lldb-server.

> 	• Is someone willing to assist with a minor xcode change so that we don't have to have a separate copy of 2 of the files for the xcode build?

I am not sure how this would work. I would rather not have something generating the http://llvm.org/svn/llvm-project/lldb/trunk/resources/lldb-framework-exports file as these files aren't too difficult to create, even if there are two copies. It currently contains:

__ZN4lldb*
__ZNK4lldb*
_init_lld*

These could easily be added to the linker flags for command line builds and they aren't going to be changing. So I don't see the need to jump through any hoops to make this happen since they won't change. Just make it happen in our CMake/make builds.

Greg