hw/nvram/fw_cfg.h

5 #include "standard-headers/linux/qemu_fw_cfg.h"
13 #define TYPE_FW_CFG_DATA_GENERATOR_INTERFACE "fw_cfg-data-generator"
31      * @errp: pointer to a NULL-initialized error object
112  * @key: selector key value for new fw_cfg item
116  * Add a new fw_cfg item, available by selecting the given key, as a raw
120 void fw_cfg_add_bytes(FWCfgState *s, uint16_t key, void *data, size_t len);
125  * @key: selector key value for new fw_cfg item
126  * @value: NUL-terminated ascii string
128  * Add a new fw_cfg item, available by selecting the given key. The item
132 void fw_cfg_add_string(FWCfgState *s, uint16_t key, const char *value);
137  * @key: selector key value for new fw_cfg item
138  * @value: NUL-terminated ascii string
140  * Replace the fw_cfg item available by selecting the given key. The new
146 void fw_cfg_modify_string(FWCfgState *s, uint16_t key, const char *value);
151  * @key: selector key value for new fw_cfg item
152  * @value: 16-bit integer
154  * Add a new fw_cfg item, available by selecting the given key. The item
155  * data will consist of a dynamically allocated copy of the given 16-bit
156  * value, converted to little-endian representation.
158 void fw_cfg_add_i16(FWCfgState *s, uint16_t key, uint16_t value);
163  * @key: selector key value for new fw_cfg item
164  * @value: 16-bit integer
166  * Replace the fw_cfg item available by selecting the given key. The new
167  * data will consist of a dynamically allocated copy of the given 16-bit
168  * value, converted to little-endian representation. The data being replaced,
172 void fw_cfg_modify_i16(FWCfgState *s, uint16_t key, uint16_t value);
177  * @key: selector key value for new fw_cfg item
178  * @value: 32-bit integer
180  * Add a new fw_cfg item, available by selecting the given key. The item
181  * data will consist of a dynamically allocated copy of the given 32-bit
182  * value, converted to little-endian representation.
184 void fw_cfg_add_i32(FWCfgState *s, uint16_t key, uint32_t value);
189  * @key: selector key value for new fw_cfg item
190  * @value: 32-bit integer
192  * Replace the fw_cfg item available by selecting the given key. The new
193  * data will consist of a dynamically allocated copy of the given 32-bit
194  * value, converted to little-endian representation. The data being replaced,
198 void fw_cfg_modify_i32(FWCfgState *s, uint16_t key, uint32_t value);
203  * @key: selector key value for new fw_cfg item
204  * @value: 64-bit integer
206  * Add a new fw_cfg item, available by selecting the given key. The item
207  * data will consist of a dynamically allocated copy of the given 64-bit
208  * value, converted to little-endian representation.
210 void fw_cfg_add_i64(FWCfgState *s, uint16_t key, uint64_t value);
215  * @key: selector key value for new fw_cfg item
216  * @value: 64-bit integer
218  * Replace the fw_cfg item available by selecting the given key. The new
219  * data will consist of a dynamically allocated copy of the given 64-bit
220  * value, converted to little-endian representation. The data being replaced,
224 void fw_cfg_modify_i64(FWCfgState *s, uint16_t key, uint64_t value);
236  * The next available (unused) selector key starting at FW_CFG_FILE_FIRST
238  * structure residing at key value FW_CFG_FILE_DIR, containing the item name,
239  * data size, and assigned selector key value.
258  * The next available (unused) selector key starting at FW_CFG_FILE_FIRST
260  * structure residing at key value FW_CFG_FILE_DIR, containing the item name,
261  * data size, and assigned selector key value.
263  * time this item is selected (by having its selector key either written to
303  * The next available (unused) selector key starting at FW_CFG_FILE_FIRST
305  * structure residing at key value FW_CFG_FILE_DIR, containing the item name,
306  * data size, and assigned selector key value.
335  * @key: The uint16 selector key.
337  * The key is architecture-specific (the FW_CFG_ARCH_LOCAL mask is expected
338  * to be set in the key).
340  * Returns: The stringified architecture-specific name if the selector
341  *          refers to a well-known numerically defined item, or NULL on
342  *          key lookup failure.
344 const char *fw_cfg_arch_key_name(uint16_t key);
347  * load_image_to_fw_cfg() - Load an image file into an fw_cfg entry identified
348  *                          by key.
350  * @size_key:       The firmware config key to store the size of the loaded
352  * @data_key:       The firmware config key to store the loaded data under,
358  *                  loaded as-is.