1/* SPDX-License-Identifier: GPL-2.0+ */ 2/* 3 * Symbol access for symbols set up by binman as part of the build. 4 * 5 * This allows C code to access the position of a particular part of the image 6 * assembled by binman. 7 * 8 * Copyright (c) 2017 Google, Inc 9 */ 10 11#ifndef __BINMAN_SYM_H 12#define __BINMAN_SYM_H 13 14#define BINMAN_SYM_MISSING (-1UL) 15 16#ifdef CONFIG_BINMAN 17 18/** 19 * binman_symname() - Internal function to get a binman symbol name 20 * 21 * @entry_name: Name of the entry to look for (e.g. 'u_boot_spl') 22 * @_prop_name: Property value to get from that entry (e.g. 'pos') 23 * @returns name of the symbol for that entry and property 24 */ 25#define binman_symname(_entry_name, _prop_name) \ 26 _binman_ ## _entry_name ## _prop_ ## _prop_name 27 28/** 29 * binman_sym_declare() - Declare a symbol that will be used at run-time 30 * 31 * @_type: Type f the symbol (e.g. unsigned long) 32 * @entry_name: Name of the entry to look for (e.g. 'u_boot_spl') 33 * @_prop_name: Property value to get from that entry (e.g. 'pos') 34 */ 35#define binman_sym_declare(_type, _entry_name, _prop_name) \ 36 _type binman_symname(_entry_name, _prop_name) \ 37 __attribute__((aligned(4), unused, section(".binman_sym"))) 38 39/** 40 * binman_sym_extern() - Declare a extern symbol that will be used at run-time 41 * 42 * @_type: Type f the symbol (e.g. unsigned long) 43 * @entry_name: Name of the entry to look for (e.g. 'u_boot_spl') 44 * @_prop_name: Property value to get from that entry (e.g. 'pos') 45 */ 46#define binman_sym_extern(_type, _entry_name, _prop_name) \ 47 extern _type binman_symname(_entry_name, _prop_name) \ 48 __attribute__((aligned(4), unused, section(".binman_sym"))) 49 50/** 51 * binman_sym_declare_optional() - Declare an optional symbol 52 * 53 * If this symbol cannot be provided by binman, an error will not be generated. 54 * Instead the image will be assigned the value BINMAN_SYM_MISSING. 55 * 56 * @_type: Type f the symbol (e.g. unsigned long) 57 * @entry_name: Name of the entry to look for (e.g. 'u_boot_spl') 58 * @_prop_name: Property value to get from that entry (e.g. 'pos') 59 */ 60#define binman_sym_declare_optional(_type, _entry_name, _prop_name) \ 61 _type binman_symname(_entry_name, _prop_name) \ 62 __attribute__((aligned(4), weak, unused, \ 63 section(".binman_sym"))) 64 65/** 66 * binman_sym() - Access a previously declared symbol 67 * 68 * This is used to get the value of a symbol. E.g.: 69 * 70 * ulong address = binman_sym(ulong, u_boot_spl, pos); 71 * 72 * @_type: Type f the symbol (e.g. unsigned long) 73 * @entry_name: Name of the entry to look for (e.g. 'u_boot_spl') 74 * @_prop_name: Property value to get from that entry (e.g. 'pos') 75 * @returns value of that property (filled in by binman) 76 */ 77#define binman_sym(_type, _entry_name, _prop_name) \ 78 (*(_type *)&binman_symname(_entry_name, _prop_name)) 79 80#else /* !BINMAN */ 81 82#define binman_sym_declare(_type, _entry_name, _prop_name) 83 84#define binman_sym_declare_optional(_type, _entry_name, _prop_name) 85 86#define binman_sym_extern(_type, _entry_name, _prop_name) 87 88#define binman_sym(_type, _entry_name, _prop_name) BINMAN_SYM_MISSING 89 90#endif /* BINMAN */ 91 92#endif 93