1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (C) 2015, Wang Nan <wangnan0@huawei.com>
4  * Copyright (C) 2015, Huawei Inc.
5  */
6 #ifndef __LLVM_UTILS_H
7 #define __LLVM_UTILS_H
8 
9 #include <stdbool.h>
10 
11 struct llvm_param {
12 	/* Path of clang executable */
13 	const char *clang_path;
14 	/* Path of llc executable */
15 	const char *llc_path;
16 	/*
17 	 * Template of clang bpf compiling. 5 env variables
18 	 * can be used:
19 	 *   $CLANG_EXEC:		Path to clang.
20 	 *   $CLANG_OPTIONS:		Extra options to clang.
21 	 *   $KERNEL_INC_OPTIONS:	Kernel include directories.
22 	 *   $WORKING_DIR:		Kernel source directory.
23 	 *   $CLANG_SOURCE:		Source file to be compiled.
24 	 */
25 	const char *clang_bpf_cmd_template;
26 	/* Will be filled in $CLANG_OPTIONS */
27 	const char *clang_opt;
28 	/*
29 	 * If present it'll add -emit-llvm to $CLANG_OPTIONS to pipe
30 	 * the clang output to llc, useful for new llvm options not
31 	 * yet selectable via 'clang -mllvm option', such as -mattr=dwarfris
32 	 * in clang 6.0/llvm 7
33 	 */
34 	const char *opts;
35 	/* Where to find kbuild system */
36 	const char *kbuild_dir;
37 	/*
38 	 * Arguments passed to make, like 'ARCH=arm' if doing cross
39 	 * compiling. Should not be used for dynamic compiling.
40 	 */
41 	const char *kbuild_opts;
42 	/*
43 	 * Default is false. If set to true, write compiling result
44 	 * to object file.
45 	 */
46 	bool dump_obj;
47 	/*
48 	 * Default is false. If one of the above fields is set by user
49 	 * explicitly then user_set_llvm is set to true. This is used
50 	 * for perf test. If user doesn't set anything in .perfconfig
51 	 * and clang is not found, don't trigger llvm test.
52 	 */
53 	bool user_set_param;
54 };
55 
56 extern struct llvm_param llvm_param;
57 int perf_llvm_config(const char *var, const char *value);
58 
59 int llvm__compile_bpf(const char *path, void **p_obj_buf, size_t *p_obj_buf_sz);
60 
61 /* This function is for test__llvm() use only */
62 int llvm__search_clang(void);
63 
64 /* Following functions are reused by builtin clang support */
65 void llvm__get_kbuild_opts(char **kbuild_dir, char **kbuild_include_opts);
66 int llvm__get_nr_cpus(void);
67 
68 void llvm__dump_obj(const char *path, void *obj_buf, size_t size);
69 #endif
70