aboutsummaryrefslogtreecommitdiff
path: root/libbuild2/bin/utility.hxx
blob: 91b51f8dd45dd73aa06ca77ee018eec6abfc5d1f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
// file      : libbuild2/bin/utility.hxx -*- C++ -*-
// license   : MIT; see accompanying LICENSE file

#ifndef LIBBUILD2_BIN_UTILITY_HXX
#define LIBBUILD2_BIN_UTILITY_HXX

#include <libbuild2/types.hxx>
#include <libbuild2/utility.hxx>

#include <libbuild2/action.hxx>

#include <libbuild2/bin/types.hxx>
#include <libbuild2/bin/target.hxx>

namespace build2
{
  namespace bin
  {
    // @@ Here we conflate the term "link" to mean both linker output and
    //    linking of a library.

    // Linker output type from binary (exe{}, lib*{}) target.
    //
    ltype
    link_type (const target&);

    // Library group (lib{}) members to build according to the bin.lib value.
    //
    LIBBUILD2_BIN_SYMEXPORT lmembers
    link_members (const scope& rs);

    // Library link order.
    //
    // The reason we pass scope and not the target is because this function is
    // called not only for exe/lib but also for obj as part of the library
    // metadata protocol implementation. Normally the bin.*.lib values will be
    // project-wide. With this scheme they can be customized on the per-
    // directory basis but not per-target which means all exe/lib in the same
    // directory have to have the same link order.
    //
    LIBBUILD2_BIN_SYMEXPORT lorder
    link_order (const scope& base, otype);

    inline linfo
    link_info (const scope& base, otype ot)
    {
      return linfo {ot, link_order (base, ot)};
    }

    // Given the link order return the library member to link. That is, liba{}
    // or libs{} for lib{} and libua{} or libus{} for libul{}.
    //
    // If existing is true, then only return the member target if it exists
    // (currently only used and supported for utility libraries).
    //
    LIBBUILD2_BIN_SYMEXPORT const target*
    link_member (const libx&, action, linfo, bool existing = false);

    // Lookup the bin.pattern value and split it into the pattern and the
    // search paths.
    //
    struct pattern_paths
    {
      const char* pattern = nullptr;
      const char* paths   = nullptr;
    };

    LIBBUILD2_BIN_SYMEXPORT pattern_paths
    lookup_pattern (const scope& rs);
  }
}

#include <libbuild2/bin/utility.ixx>

#endif // LIBBUILD2_BIN_UTILITY_HXX