object-introspection/oi/type_graph/DrgnExporter.h
Jake Hillion 55989a9156 oilgen: migrate to source parsing (#421)
Summary:
oilgen: migrate to source parsing

Using debug information generated from partial source (that is, not the final
binary) has been insufficient to generally generate OIL code.

A particular example is pointers to templates:
```cpp
#include <oi/oi.h>
template <typename T>
struct Foo {
  T t;
};
template <typename T>
struct Bar {
  Foo<T>& f;
};
void foo(const Bar<int>& b) {
  oi::introspect(b);
}
```

The pointer/reference to `Foo<int>` appears in DWARF with
`DW_AT_declaration(true)` because it could be specialised before its usage.
However, with OIL, we are creating an implicit usage site in the
`oi::introspect` call that the compiler is unable to see.

This change reworks OILGen to work from a Clang command line rather than debug
information. We setup and run a compiler on the source, giving us access to an
AST and Semantic Analyser. We then:
- Find the `oi::introspect` template.
- Iterate through each of its callsites for their type.
- Run `ClangTypeParser::parse` on each type.
- Run codegen.
- Compile into an object file.

Having access to the semantic analyser allows us to forcefully complete a type,
as it would be if it was used in the initial code.


Test Plan:
hope

`buck2 run fbcode//mode/opt fbcode//object-introspection/oil/examples/compile-time:compile-time`

Reviewed By: tyroguru

Differential Revision: D51854477

Pulled By: JakeHillion
2023-12-19 13:26:25 -08:00

74 lines
2.1 KiB
C++

/*
* Copyright (c) Meta Platforms, Inc. and affiliates.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#pragma once
#include <list>
#include <string>
#include "NodeTracker.h"
#include "PassManager.h"
#include "Types.h"
#include "Visitor.h"
extern "C" {
#include <drgn.h>
}
struct TypeHierarchy;
namespace oi::detail::type_graph {
/*
* DrgnExporter
*
* Converts Type Graph nodes into minimal drgn_type structs and populates a
* TypeHierarchy with them, for use by TreeBuilder v1.
*/
class DrgnExporter : public Visitor<drgn_type*> {
public:
static Pass createPass(TypeHierarchy& th, std::list<drgn_type>& drgnTypes);
DrgnExporter(TypeHierarchy& th, std::list<drgn_type>& drgnTypes)
: th_(th), drgnTypes_(drgnTypes) {
}
drgn_type* accept(Type&);
drgn_type* visit(Incomplete&) override;
drgn_type* visit(Class&) override;
drgn_type* visit(Container&) override;
drgn_type* visit(Primitive&) override;
drgn_type* visit(Enum&) override;
drgn_type* visit(Array&) override;
drgn_type* visit(Typedef&) override;
drgn_type* visit(Pointer&) override;
drgn_type* visit(Reference&) override;
drgn_type* visit(Dummy&) override;
drgn_type* visit(DummyAllocator&) override;
drgn_type* visit(CaptureKeys&) override;
private:
drgn_type* makeDrgnType(enum drgn_type_kind kind,
bool is_complete,
enum drgn_primitive_type primitive,
const Type& type);
ResultTracker<drgn_type*> tracker_;
TypeHierarchy& th_;
std::list<drgn_type>& drgnTypes_;
};
} // namespace oi::detail::type_graph