qapi: Improve specificity of type/member descriptions
[qemu/armbru.git] / hw / nvram / spapr_nvram.c
blob2d72f304422a4f3e30aee6db7adc4f1c876ac221
1 /*
2 * QEMU sPAPR NVRAM emulation
4 * Copyright (C) 2012 David Gibson, IBM Corporation.
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
25 #include "qemu/osdep.h"
26 #include "qemu/module.h"
27 #include "qemu/units.h"
28 #include "qapi/error.h"
29 #include <libfdt.h>
31 #include "sysemu/block-backend.h"
32 #include "sysemu/device_tree.h"
33 #include "sysemu/sysemu.h"
34 #include "sysemu/runstate.h"
35 #include "migration/vmstate.h"
36 #include "hw/nvram/chrp_nvram.h"
37 #include "hw/ppc/spapr.h"
38 #include "hw/ppc/spapr_vio.h"
39 #include "hw/qdev-properties.h"
40 #include "hw/qdev-properties-system.h"
41 #include "qom/object.h"
43 struct SpaprNvram {
44 SpaprVioDevice sdev;
45 uint32_t size;
46 uint8_t *buf;
47 BlockBackend *blk;
48 VMChangeStateEntry *vmstate;
51 #define TYPE_VIO_SPAPR_NVRAM "spapr-nvram"
52 OBJECT_DECLARE_SIMPLE_TYPE(SpaprNvram, VIO_SPAPR_NVRAM)
54 #define MIN_NVRAM_SIZE (8 * KiB)
55 #define DEFAULT_NVRAM_SIZE (64 * KiB)
56 #define MAX_NVRAM_SIZE (1 * MiB)
58 static void rtas_nvram_fetch(PowerPCCPU *cpu, SpaprMachineState *spapr,
59 uint32_t token, uint32_t nargs,
60 target_ulong args,
61 uint32_t nret, target_ulong rets)
63 SpaprNvram *nvram = spapr->nvram;
64 hwaddr offset, buffer, len;
65 void *membuf;
67 if ((nargs != 3) || (nret != 2)) {
68 rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
69 return;
72 if (!nvram) {
73 rtas_st(rets, 0, RTAS_OUT_HW_ERROR);
74 rtas_st(rets, 1, 0);
75 return;
78 offset = rtas_ld(args, 0);
79 buffer = rtas_ld(args, 1);
80 len = rtas_ld(args, 2);
82 if (((offset + len) < offset)
83 || ((offset + len) > nvram->size)) {
84 rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
85 rtas_st(rets, 1, 0);
86 return;
89 assert(nvram->buf);
91 membuf = cpu_physical_memory_map(buffer, &len, true);
92 memcpy(membuf, nvram->buf + offset, len);
93 cpu_physical_memory_unmap(membuf, len, 1, len);
95 rtas_st(rets, 0, RTAS_OUT_SUCCESS);
96 rtas_st(rets, 1, len);
99 static void rtas_nvram_store(PowerPCCPU *cpu, SpaprMachineState *spapr,
100 uint32_t token, uint32_t nargs,
101 target_ulong args,
102 uint32_t nret, target_ulong rets)
104 SpaprNvram *nvram = spapr->nvram;
105 hwaddr offset, buffer, len;
106 int ret;
107 void *membuf;
109 if ((nargs != 3) || (nret != 2)) {
110 rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
111 return;
114 if (!nvram) {
115 rtas_st(rets, 0, RTAS_OUT_HW_ERROR);
116 return;
119 offset = rtas_ld(args, 0);
120 buffer = rtas_ld(args, 1);
121 len = rtas_ld(args, 2);
123 if (((offset + len) < offset)
124 || ((offset + len) > nvram->size)) {
125 rtas_st(rets, 0, RTAS_OUT_PARAM_ERROR);
126 return;
129 membuf = cpu_physical_memory_map(buffer, &len, false);
131 ret = 0;
132 if (nvram->blk) {
133 ret = blk_pwrite(nvram->blk, offset, len, membuf, 0);
136 assert(nvram->buf);
137 memcpy(nvram->buf + offset, membuf, len);
139 cpu_physical_memory_unmap(membuf, len, 0, len);
141 rtas_st(rets, 0, (ret < 0) ? RTAS_OUT_HW_ERROR : RTAS_OUT_SUCCESS);
142 rtas_st(rets, 1, (ret < 0) ? 0 : len);
145 static void spapr_nvram_realize(SpaprVioDevice *dev, Error **errp)
147 SpaprNvram *nvram = VIO_SPAPR_NVRAM(dev);
148 int ret;
150 if (nvram->blk) {
151 int64_t len = blk_getlength(nvram->blk);
153 if (len < 0) {
154 error_setg_errno(errp, -len,
155 "could not get length of backing image");
156 return;
159 nvram->size = len;
161 ret = blk_set_perm(nvram->blk,
162 BLK_PERM_CONSISTENT_READ | BLK_PERM_WRITE,
163 BLK_PERM_ALL, errp);
164 if (ret < 0) {
165 return;
167 } else {
168 nvram->size = DEFAULT_NVRAM_SIZE;
171 nvram->buf = g_malloc0(nvram->size);
173 if ((nvram->size < MIN_NVRAM_SIZE) || (nvram->size > MAX_NVRAM_SIZE)) {
174 error_setg(errp,
175 "spapr-nvram must be between %" PRId64
176 " and %" PRId64 " bytes in size",
177 MIN_NVRAM_SIZE, MAX_NVRAM_SIZE);
178 return;
181 if (nvram->blk) {
182 ret = blk_pread(nvram->blk, 0, nvram->size, nvram->buf, 0);
184 if (ret < 0) {
185 error_setg(errp, "can't read spapr-nvram contents");
186 return;
188 } else if (nb_prom_envs > 0) {
189 /* Create a system partition to pass the -prom-env variables */
190 chrp_nvram_create_system_partition(nvram->buf, MIN_NVRAM_SIZE / 4,
191 nvram->size);
192 chrp_nvram_create_free_partition(&nvram->buf[MIN_NVRAM_SIZE / 4],
193 nvram->size - MIN_NVRAM_SIZE / 4);
196 spapr_rtas_register(RTAS_NVRAM_FETCH, "nvram-fetch", rtas_nvram_fetch);
197 spapr_rtas_register(RTAS_NVRAM_STORE, "nvram-store", rtas_nvram_store);
200 static int spapr_nvram_devnode(SpaprVioDevice *dev, void *fdt, int node_off)
202 SpaprNvram *nvram = VIO_SPAPR_NVRAM(dev);
204 return fdt_setprop_cell(fdt, node_off, "#bytes", nvram->size);
207 static int spapr_nvram_pre_load(void *opaque)
209 SpaprNvram *nvram = VIO_SPAPR_NVRAM(opaque);
211 g_free(nvram->buf);
212 nvram->buf = NULL;
213 nvram->size = 0;
215 return 0;
218 static void postload_update_cb(void *opaque, bool running, RunState state)
220 SpaprNvram *nvram = opaque;
222 /* This is called after bdrv_activate_all. */
224 qemu_del_vm_change_state_handler(nvram->vmstate);
225 nvram->vmstate = NULL;
227 blk_pwrite(nvram->blk, 0, nvram->size, nvram->buf, 0);
230 static int spapr_nvram_post_load(void *opaque, int version_id)
232 SpaprNvram *nvram = VIO_SPAPR_NVRAM(opaque);
234 if (nvram->blk) {
235 nvram->vmstate = qemu_add_vm_change_state_handler(postload_update_cb,
236 nvram);
239 return 0;
242 static const VMStateDescription vmstate_spapr_nvram = {
243 .name = "spapr_nvram",
244 .version_id = 1,
245 .minimum_version_id = 1,
246 .pre_load = spapr_nvram_pre_load,
247 .post_load = spapr_nvram_post_load,
248 .fields = (VMStateField[]) {
249 VMSTATE_UINT32(size, SpaprNvram),
250 VMSTATE_VBUFFER_ALLOC_UINT32(buf, SpaprNvram, 1, NULL, size),
251 VMSTATE_END_OF_LIST()
255 static Property spapr_nvram_properties[] = {
256 DEFINE_SPAPR_PROPERTIES(SpaprNvram, sdev),
257 DEFINE_PROP_DRIVE("drive", SpaprNvram, blk),
258 DEFINE_PROP_END_OF_LIST(),
261 static void spapr_nvram_class_init(ObjectClass *klass, void *data)
263 DeviceClass *dc = DEVICE_CLASS(klass);
264 SpaprVioDeviceClass *k = VIO_SPAPR_DEVICE_CLASS(klass);
266 k->realize = spapr_nvram_realize;
267 k->devnode = spapr_nvram_devnode;
268 k->dt_name = "nvram";
269 k->dt_type = "nvram";
270 k->dt_compatible = "qemu,spapr-nvram";
271 set_bit(DEVICE_CATEGORY_MISC, dc->categories);
272 device_class_set_props(dc, spapr_nvram_properties);
273 dc->vmsd = &vmstate_spapr_nvram;
274 /* Reason: Internal device only, uses spapr_rtas_register() in realize() */
275 dc->user_creatable = false;
278 static const TypeInfo spapr_nvram_type_info = {
279 .name = TYPE_VIO_SPAPR_NVRAM,
280 .parent = TYPE_VIO_SPAPR_DEVICE,
281 .instance_size = sizeof(SpaprNvram),
282 .class_init = spapr_nvram_class_init,
285 static void spapr_nvram_register_types(void)
287 type_register_static(&spapr_nvram_type_info);
290 type_init(spapr_nvram_register_types)