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
76
|
===============================
Initialization and finalization
===============================
.. currentmodule:: llvmlite.binding
You only need to call these functions once per process invocation.
* .. function:: initialize()
**Deprecated.** Initialize the LLVM core.
This function is deprecated and will raise a :class:`RuntimeError` when
called. LLVM initialization is now handled automatically and no longer
requires explicit initialization calls. Remove calls to this function and
check for other behavioral changes that may have occurred due to LLVM
updates.
For code that needs to support both older and newer versions of llvmlite,
you can use version-conditional initialization::
import llvmlite
import llvmlite.binding as llvm
# Check llvmlite version to determine if initialization is needed
version = [int(p) for p in llvmlite.__version__.split('.')[:2]]
if version < [0, 45]:
# Older versions require explicit initialization
llvm.initialize()
# No initialization needed for version 0.45+
.. Code above is adapted from https://github.com/numba/llvmlite/issues/1261#issuecomment-3324513084
* .. function:: initialize_all_targets()
Initialize all targets. Must be called before targets can
be looked up via the :class:`Target` class.
* .. function:: initialize_all_asmprinters()
Initialize all code generators. Must be called before
generating any assembly or machine code via the
:meth:`TargetMachine.emit_object` and
:meth:`TargetMachine.emit_assembly` methods.
* .. function:: initialize_native_target()
Initialize the native---host---target. Must be called once
before doing any code generation.
* .. function:: initialize_native_asmprinter()
Initialize the native assembly printer.
* .. function:: initialize_native_asmparser()
Initialize the native assembly parser. Must be called for
inline assembly to work.
* .. function:: shutdown()
Shut down the LLVM core.
* .. data:: llvm_version_info
A 3-integer tuple representing the LLVM version number.
EXAMPLE: ``(3, 7, 1)``
Since LLVM is statically linked into the ``llvmlite`` DLL,
this is guaranteed to represent the true LLVM version in use.
|
