1 /* 2 * Copyright (c) 2022-2023, ARM Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 #include <assert.h> 7 #include <errno.h> 8 #include <inttypes.h> 9 10 #include <common/debug.h> 11 #include <common/runtime_svc.h> 12 #include <lib/object_pool.h> 13 #include <lib/spinlock.h> 14 #include <lib/xlat_tables/xlat_tables_v2.h> 15 #include <services/ffa_svc.h> 16 #include "spmc.h" 17 #include "spmc_shared_mem.h" 18 19 #include <platform_def.h> 20 21 /** 22 * struct spmc_shmem_obj - Shared memory object. 23 * @desc_size: Size of @desc. 24 * @desc_filled: Size of @desc already received. 25 * @in_use: Number of clients that have called ffa_mem_retrieve_req 26 * without a matching ffa_mem_relinquish call. 27 * @desc: FF-A memory region descriptor passed in ffa_mem_share. 28 */ 29 struct spmc_shmem_obj { 30 size_t desc_size; 31 size_t desc_filled; 32 size_t in_use; 33 struct ffa_mtd desc; 34 }; 35 36 /* 37 * Declare our data structure to store the metadata of memory share requests. 38 * The main datastore is allocated on a per platform basis to ensure enough 39 * storage can be made available. 40 * The address of the data store will be populated by the SPMC during its 41 * initialization. 42 */ 43 44 struct spmc_shmem_obj_state spmc_shmem_obj_state = { 45 /* Set start value for handle so top 32 bits are needed quickly. */ 46 .next_handle = 0xffffffc0U, 47 }; 48 49 /** 50 * spmc_shmem_obj_size - Convert from descriptor size to object size. 51 * @desc_size: Size of struct ffa_memory_region_descriptor object. 52 * 53 * Return: Size of struct spmc_shmem_obj object. 54 */ 55 static size_t spmc_shmem_obj_size(size_t desc_size) 56 { 57 return desc_size + offsetof(struct spmc_shmem_obj, desc); 58 } 59 60 /** 61 * spmc_shmem_obj_alloc - Allocate struct spmc_shmem_obj. 62 * @state: Global state. 63 * @desc_size: Size of struct ffa_memory_region_descriptor object that 64 * allocated object will hold. 65 * 66 * Return: Pointer to newly allocated object, or %NULL if there not enough space 67 * left. The returned pointer is only valid while @state is locked, to 68 * used it again after unlocking @state, spmc_shmem_obj_lookup must be 69 * called. 70 */ 71 static struct spmc_shmem_obj * 72 spmc_shmem_obj_alloc(struct spmc_shmem_obj_state *state, size_t desc_size) 73 { 74 struct spmc_shmem_obj *obj; 75 size_t free = state->data_size - state->allocated; 76 size_t obj_size; 77 78 if (state->data == NULL) { 79 ERROR("Missing shmem datastore!\n"); 80 return NULL; 81 } 82 83 /* Ensure that descriptor size is aligned */ 84 if (!is_aligned(desc_size, 16)) { 85 WARN("%s(0x%zx) desc_size not 16-byte aligned\n", 86 __func__, desc_size); 87 return NULL; 88 } 89 90 obj_size = spmc_shmem_obj_size(desc_size); 91 92 /* Ensure the obj size has not overflowed. */ 93 if (obj_size < desc_size) { 94 WARN("%s(0x%zx) desc_size overflow\n", 95 __func__, desc_size); 96 return NULL; 97 } 98 99 if (obj_size > free) { 100 WARN("%s(0x%zx) failed, free 0x%zx\n", 101 __func__, desc_size, free); 102 return NULL; 103 } 104 obj = (struct spmc_shmem_obj *)(state->data + state->allocated); 105 obj->desc = (struct ffa_mtd) {0}; 106 obj->desc_size = desc_size; 107 obj->desc_filled = 0; 108 obj->in_use = 0; 109 state->allocated += obj_size; 110 return obj; 111 } 112 113 /** 114 * spmc_shmem_obj_free - Free struct spmc_shmem_obj. 115 * @state: Global state. 116 * @obj: Object to free. 117 * 118 * Release memory used by @obj. Other objects may move, so on return all 119 * pointers to struct spmc_shmem_obj object should be considered invalid, not 120 * just @obj. 121 * 122 * The current implementation always compacts the remaining objects to simplify 123 * the allocator and to avoid fragmentation. 124 */ 125 126 static void spmc_shmem_obj_free(struct spmc_shmem_obj_state *state, 127 struct spmc_shmem_obj *obj) 128 { 129 size_t free_size = spmc_shmem_obj_size(obj->desc_size); 130 uint8_t *shift_dest = (uint8_t *)obj; 131 uint8_t *shift_src = shift_dest + free_size; 132 size_t shift_size = state->allocated - (shift_src - state->data); 133 134 if (shift_size != 0U) { 135 memmove(shift_dest, shift_src, shift_size); 136 } 137 state->allocated -= free_size; 138 } 139 140 /** 141 * spmc_shmem_obj_lookup - Lookup struct spmc_shmem_obj by handle. 142 * @state: Global state. 143 * @handle: Unique handle of object to return. 144 * 145 * Return: struct spmc_shmem_obj_state object with handle matching @handle. 146 * %NULL, if not object in @state->data has a matching handle. 147 */ 148 static struct spmc_shmem_obj * 149 spmc_shmem_obj_lookup(struct spmc_shmem_obj_state *state, uint64_t handle) 150 { 151 uint8_t *curr = state->data; 152 153 while (curr - state->data < state->allocated) { 154 struct spmc_shmem_obj *obj = (struct spmc_shmem_obj *)curr; 155 156 if (obj->desc.handle == handle) { 157 return obj; 158 } 159 curr += spmc_shmem_obj_size(obj->desc_size); 160 } 161 return NULL; 162 } 163 164 /** 165 * spmc_shmem_obj_get_next - Get the next memory object from an offset. 166 * @offset: Offset used to track which objects have previously been 167 * returned. 168 * 169 * Return: the next struct spmc_shmem_obj_state object from the provided 170 * offset. 171 * %NULL, if there are no more objects. 172 */ 173 static struct spmc_shmem_obj * 174 spmc_shmem_obj_get_next(struct spmc_shmem_obj_state *state, size_t *offset) 175 { 176 uint8_t *curr = state->data + *offset; 177 178 if (curr - state->data < state->allocated) { 179 struct spmc_shmem_obj *obj = (struct spmc_shmem_obj *)curr; 180 181 *offset += spmc_shmem_obj_size(obj->desc_size); 182 183 return obj; 184 } 185 return NULL; 186 } 187 188 /******************************************************************************* 189 * FF-A memory descriptor helper functions. 190 ******************************************************************************/ 191 /** 192 * spmc_shmem_obj_get_emad - Get the emad from a given index depending on the 193 * clients FF-A version. 194 * @desc: The memory transaction descriptor. 195 * @index: The index of the emad element to be accessed. 196 * @ffa_version: FF-A version of the provided structure. 197 * @emad_size: Will be populated with the size of the returned emad 198 * descriptor. 199 * Return: A pointer to the requested emad structure. 200 */ 201 static void * 202 spmc_shmem_obj_get_emad(const struct ffa_mtd *desc, uint32_t index, 203 uint32_t ffa_version, size_t *emad_size) 204 { 205 uint8_t *emad; 206 207 assert(index < desc->emad_count); 208 209 /* 210 * If the caller is using FF-A v1.0 interpret the descriptor as a v1.0 211 * format, otherwise assume it is a v1.1 format. 212 */ 213 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 214 emad = (uint8_t *)desc + offsetof(struct ffa_mtd_v1_0, emad); 215 *emad_size = sizeof(struct ffa_emad_v1_0); 216 } else { 217 assert(is_aligned(desc->emad_offset, 16)); 218 emad = ((uint8_t *) desc + desc->emad_offset); 219 *emad_size = desc->emad_size; 220 } 221 222 assert(((uint64_t)index * (uint64_t)*emad_size) <= UINT32_MAX); 223 return (emad + (*emad_size * index)); 224 } 225 226 /** 227 * spmc_shmem_obj_get_comp_mrd - Get comp_mrd from a mtd struct based on the 228 * FF-A version of the descriptor. 229 * @obj: Object containing ffa_memory_region_descriptor. 230 * 231 * Return: struct ffa_comp_mrd object corresponding to the composite memory 232 * region descriptor. 233 */ 234 static struct ffa_comp_mrd * 235 spmc_shmem_obj_get_comp_mrd(struct spmc_shmem_obj *obj, uint32_t ffa_version) 236 { 237 size_t emad_size; 238 /* 239 * The comp_mrd_offset field of the emad descriptor remains consistent 240 * between FF-A versions therefore we can use the v1.0 descriptor here 241 * in all cases. 242 */ 243 struct ffa_emad_v1_0 *emad = spmc_shmem_obj_get_emad(&obj->desc, 0, 244 ffa_version, 245 &emad_size); 246 247 /* Ensure the composite descriptor offset is aligned. */ 248 if (!is_aligned(emad->comp_mrd_offset, 8)) { 249 WARN("Unaligned composite memory region descriptor offset.\n"); 250 return NULL; 251 } 252 253 return (struct ffa_comp_mrd *) 254 ((uint8_t *)(&obj->desc) + emad->comp_mrd_offset); 255 } 256 257 /** 258 * spmc_shmem_obj_validate_id - Validate a partition ID is participating in 259 * a given memory transaction. 260 * @sp_id: Partition ID to validate. 261 * @obj: The shared memory object containing the descriptor 262 * of the memory transaction. 263 * Return: true if ID is valid, else false. 264 */ 265 bool spmc_shmem_obj_validate_id(struct spmc_shmem_obj *obj, uint16_t sp_id) 266 { 267 bool found = false; 268 struct ffa_mtd *desc = &obj->desc; 269 size_t desc_size = obj->desc_size; 270 271 /* Validate the partition is a valid participant. */ 272 for (unsigned int i = 0U; i < desc->emad_count; i++) { 273 size_t emad_size; 274 struct ffa_emad_v1_0 *emad; 275 276 emad = spmc_shmem_obj_get_emad(desc, i, 277 MAKE_FFA_VERSION(1, 1), 278 &emad_size); 279 /* 280 * Validate the calculated emad address resides within the 281 * descriptor. 282 */ 283 if ((emad == NULL) || (uintptr_t) emad >= 284 (uintptr_t)((uint8_t *) desc + desc_size)) { 285 VERBOSE("Invalid emad.\n"); 286 break; 287 } 288 if (sp_id == emad->mapd.endpoint_id) { 289 found = true; 290 break; 291 } 292 } 293 return found; 294 } 295 296 /* 297 * Compare two memory regions to determine if any range overlaps with another 298 * ongoing memory transaction. 299 */ 300 static bool 301 overlapping_memory_regions(struct ffa_comp_mrd *region1, 302 struct ffa_comp_mrd *region2) 303 { 304 uint64_t region1_start; 305 uint64_t region1_size; 306 uint64_t region1_end; 307 uint64_t region2_start; 308 uint64_t region2_size; 309 uint64_t region2_end; 310 311 assert(region1 != NULL); 312 assert(region2 != NULL); 313 314 if (region1 == region2) { 315 return true; 316 } 317 318 /* 319 * Check each memory region in the request against existing 320 * transactions. 321 */ 322 for (size_t i = 0; i < region1->address_range_count; i++) { 323 324 region1_start = region1->address_range_array[i].address; 325 region1_size = 326 region1->address_range_array[i].page_count * 327 PAGE_SIZE_4KB; 328 region1_end = region1_start + region1_size; 329 330 for (size_t j = 0; j < region2->address_range_count; j++) { 331 332 region2_start = region2->address_range_array[j].address; 333 region2_size = 334 region2->address_range_array[j].page_count * 335 PAGE_SIZE_4KB; 336 region2_end = region2_start + region2_size; 337 338 /* Check if regions are not overlapping. */ 339 if (!((region2_end <= region1_start) || 340 (region1_end <= region2_start))) { 341 WARN("Overlapping mem regions 0x%lx-0x%lx & 0x%lx-0x%lx\n", 342 region1_start, region1_end, 343 region2_start, region2_end); 344 return true; 345 } 346 } 347 } 348 return false; 349 } 350 351 /******************************************************************************* 352 * FF-A v1.0 Memory Descriptor Conversion Helpers. 353 ******************************************************************************/ 354 /** 355 * spmc_shm_get_v1_1_descriptor_size - Calculate the required size for a v1.1 356 * converted descriptor. 357 * @orig: The original v1.0 memory transaction descriptor. 358 * @desc_size: The size of the original v1.0 memory transaction descriptor. 359 * 360 * Return: the size required to store the descriptor store in the v1.1 format. 361 */ 362 static uint64_t 363 spmc_shm_get_v1_1_descriptor_size(struct ffa_mtd_v1_0 *orig, size_t desc_size) 364 { 365 uint64_t size = 0; 366 struct ffa_comp_mrd *mrd; 367 struct ffa_emad_v1_0 *emad_array = orig->emad; 368 369 /* Get the size of the v1.1 descriptor. */ 370 size += sizeof(struct ffa_mtd); 371 372 /* Add the size of the emad descriptors. */ 373 size += orig->emad_count * sizeof(struct ffa_emad_v1_0); 374 375 /* Add the size of the composite mrds. */ 376 size += sizeof(struct ffa_comp_mrd); 377 378 /* Add the size of the constituent mrds. */ 379 mrd = (struct ffa_comp_mrd *) ((uint8_t *) orig + 380 emad_array[0].comp_mrd_offset); 381 382 /* Add the size of the memory region descriptors. */ 383 size += mrd->address_range_count * sizeof(struct ffa_cons_mrd); 384 385 return size; 386 } 387 388 /** 389 * spmc_shm_get_v1_0_descriptor_size - Calculate the required size for a v1.0 390 * converted descriptor. 391 * @orig: The original v1.1 memory transaction descriptor. 392 * @desc_size: The size of the original v1.1 memory transaction descriptor. 393 * 394 * Return: the size required to store the descriptor store in the v1.0 format. 395 */ 396 static size_t 397 spmc_shm_get_v1_0_descriptor_size(struct ffa_mtd *orig, size_t desc_size) 398 { 399 size_t size = 0; 400 struct ffa_comp_mrd *mrd; 401 struct ffa_emad_v1_0 *emad_array = (struct ffa_emad_v1_0 *) 402 ((uint8_t *) orig + 403 orig->emad_offset); 404 405 /* Get the size of the v1.0 descriptor. */ 406 size += sizeof(struct ffa_mtd_v1_0); 407 408 /* Add the size of the v1.0 emad descriptors. */ 409 size += orig->emad_count * sizeof(struct ffa_emad_v1_0); 410 411 /* Add the size of the composite mrds. */ 412 size += sizeof(struct ffa_comp_mrd); 413 414 /* Add the size of the constituent mrds. */ 415 mrd = (struct ffa_comp_mrd *) ((uint8_t *) orig + 416 emad_array[0].comp_mrd_offset); 417 418 /* Check the calculated address is within the memory descriptor. */ 419 if (((uintptr_t) mrd + sizeof(struct ffa_comp_mrd)) > 420 (uintptr_t)((uint8_t *) orig + desc_size)) { 421 return 0; 422 } 423 size += mrd->address_range_count * sizeof(struct ffa_cons_mrd); 424 425 return size; 426 } 427 428 /** 429 * spmc_shm_convert_shmem_obj_from_v1_0 - Converts a given v1.0 memory object. 430 * @out_obj: The shared memory object to populate the converted descriptor. 431 * @orig: The shared memory object containing the v1.0 descriptor. 432 * 433 * Return: true if the conversion is successful else false. 434 */ 435 static bool 436 spmc_shm_convert_shmem_obj_from_v1_0(struct spmc_shmem_obj *out_obj, 437 struct spmc_shmem_obj *orig) 438 { 439 struct ffa_mtd_v1_0 *mtd_orig = (struct ffa_mtd_v1_0 *) &orig->desc; 440 struct ffa_mtd *out = &out_obj->desc; 441 struct ffa_emad_v1_0 *emad_array_in; 442 struct ffa_emad_v1_0 *emad_array_out; 443 struct ffa_comp_mrd *mrd_in; 444 struct ffa_comp_mrd *mrd_out; 445 446 size_t mrd_in_offset; 447 size_t mrd_out_offset; 448 size_t mrd_size = 0; 449 450 /* Populate the new descriptor format from the v1.0 struct. */ 451 out->sender_id = mtd_orig->sender_id; 452 out->memory_region_attributes = mtd_orig->memory_region_attributes; 453 out->flags = mtd_orig->flags; 454 out->handle = mtd_orig->handle; 455 out->tag = mtd_orig->tag; 456 out->emad_count = mtd_orig->emad_count; 457 out->emad_size = sizeof(struct ffa_emad_v1_0); 458 459 /* 460 * We will locate the emad descriptors directly after the ffa_mtd 461 * struct. This will be 8-byte aligned. 462 */ 463 out->emad_offset = sizeof(struct ffa_mtd); 464 465 emad_array_in = mtd_orig->emad; 466 emad_array_out = (struct ffa_emad_v1_0 *) 467 ((uint8_t *) out + out->emad_offset); 468 469 /* Copy across the emad structs. */ 470 for (unsigned int i = 0U; i < out->emad_count; i++) { 471 /* Bound check for emad array. */ 472 if (((uint8_t *)emad_array_in + sizeof(struct ffa_emad_v1_0)) > 473 ((uint8_t *) mtd_orig + orig->desc_size)) { 474 VERBOSE("%s: Invalid mtd structure.\n", __func__); 475 return false; 476 } 477 memcpy(&emad_array_out[i], &emad_array_in[i], 478 sizeof(struct ffa_emad_v1_0)); 479 } 480 481 /* Place the mrd descriptors after the end of the emad descriptors.*/ 482 mrd_in_offset = emad_array_in->comp_mrd_offset; 483 mrd_out_offset = out->emad_offset + (out->emad_size * out->emad_count); 484 mrd_out = (struct ffa_comp_mrd *) ((uint8_t *) out + mrd_out_offset); 485 486 /* Add the size of the composite memory region descriptor. */ 487 mrd_size += sizeof(struct ffa_comp_mrd); 488 489 /* Find the mrd descriptor. */ 490 mrd_in = (struct ffa_comp_mrd *) ((uint8_t *) mtd_orig + mrd_in_offset); 491 492 /* Add the size of the constituent memory region descriptors. */ 493 mrd_size += mrd_in->address_range_count * sizeof(struct ffa_cons_mrd); 494 495 /* 496 * Update the offset in the emads by the delta between the input and 497 * output addresses. 498 */ 499 for (unsigned int i = 0U; i < out->emad_count; i++) { 500 emad_array_out[i].comp_mrd_offset = 501 emad_array_in[i].comp_mrd_offset + 502 (mrd_out_offset - mrd_in_offset); 503 } 504 505 /* Verify that we stay within bound of the memory descriptors. */ 506 if ((uintptr_t)((uint8_t *) mrd_in + mrd_size) > 507 (uintptr_t)((uint8_t *) mtd_orig + orig->desc_size) || 508 ((uintptr_t)((uint8_t *) mrd_out + mrd_size) > 509 (uintptr_t)((uint8_t *) out + out_obj->desc_size))) { 510 ERROR("%s: Invalid mrd structure.\n", __func__); 511 return false; 512 } 513 514 /* Copy the mrd descriptors directly. */ 515 memcpy(mrd_out, mrd_in, mrd_size); 516 517 return true; 518 } 519 520 /** 521 * spmc_shm_convert_mtd_to_v1_0 - Converts a given v1.1 memory object to 522 * v1.0 memory object. 523 * @out_obj: The shared memory object to populate the v1.0 descriptor. 524 * @orig: The shared memory object containing the v1.1 descriptor. 525 * 526 * Return: true if the conversion is successful else false. 527 */ 528 static bool 529 spmc_shm_convert_mtd_to_v1_0(struct spmc_shmem_obj *out_obj, 530 struct spmc_shmem_obj *orig) 531 { 532 struct ffa_mtd *mtd_orig = &orig->desc; 533 struct ffa_mtd_v1_0 *out = (struct ffa_mtd_v1_0 *) &out_obj->desc; 534 struct ffa_emad_v1_0 *emad_in; 535 struct ffa_emad_v1_0 *emad_array_in; 536 struct ffa_emad_v1_0 *emad_array_out; 537 struct ffa_comp_mrd *mrd_in; 538 struct ffa_comp_mrd *mrd_out; 539 540 size_t mrd_in_offset; 541 size_t mrd_out_offset; 542 size_t emad_out_array_size; 543 size_t mrd_size = 0; 544 size_t orig_desc_size = orig->desc_size; 545 546 /* Populate the v1.0 descriptor format from the v1.1 struct. */ 547 out->sender_id = mtd_orig->sender_id; 548 out->memory_region_attributes = mtd_orig->memory_region_attributes; 549 out->flags = mtd_orig->flags; 550 out->handle = mtd_orig->handle; 551 out->tag = mtd_orig->tag; 552 out->emad_count = mtd_orig->emad_count; 553 554 /* Determine the location of the emad array in both descriptors. */ 555 emad_array_in = (struct ffa_emad_v1_0 *) 556 ((uint8_t *) mtd_orig + mtd_orig->emad_offset); 557 emad_array_out = out->emad; 558 559 /* Copy across the emad structs. */ 560 emad_in = emad_array_in; 561 for (unsigned int i = 0U; i < out->emad_count; i++) { 562 /* Bound check for emad array. */ 563 if (((uint8_t *)emad_in + sizeof(struct ffa_emad_v1_0)) > 564 ((uint8_t *) mtd_orig + orig_desc_size)) { 565 VERBOSE("%s: Invalid mtd structure.\n", __func__); 566 return false; 567 } 568 memcpy(&emad_array_out[i], emad_in, 569 sizeof(struct ffa_emad_v1_0)); 570 571 emad_in += mtd_orig->emad_size; 572 } 573 574 /* Place the mrd descriptors after the end of the emad descriptors. */ 575 emad_out_array_size = sizeof(struct ffa_emad_v1_0) * out->emad_count; 576 577 mrd_out_offset = (uint8_t *) out->emad - (uint8_t *) out + 578 emad_out_array_size; 579 580 mrd_out = (struct ffa_comp_mrd *) ((uint8_t *) out + mrd_out_offset); 581 582 mrd_in_offset = mtd_orig->emad_offset + 583 (mtd_orig->emad_size * mtd_orig->emad_count); 584 585 /* Add the size of the composite memory region descriptor. */ 586 mrd_size += sizeof(struct ffa_comp_mrd); 587 588 /* Find the mrd descriptor. */ 589 mrd_in = (struct ffa_comp_mrd *) ((uint8_t *) mtd_orig + mrd_in_offset); 590 591 /* Add the size of the constituent memory region descriptors. */ 592 mrd_size += mrd_in->address_range_count * sizeof(struct ffa_cons_mrd); 593 594 /* 595 * Update the offset in the emads by the delta between the input and 596 * output addresses. 597 */ 598 emad_in = emad_array_in; 599 600 for (unsigned int i = 0U; i < out->emad_count; i++) { 601 emad_array_out[i].comp_mrd_offset = emad_in->comp_mrd_offset + 602 (mrd_out_offset - 603 mrd_in_offset); 604 emad_in += mtd_orig->emad_size; 605 } 606 607 /* Verify that we stay within bound of the memory descriptors. */ 608 if ((uintptr_t)((uint8_t *) mrd_in + mrd_size) > 609 (uintptr_t)((uint8_t *) mtd_orig + orig->desc_size) || 610 ((uintptr_t)((uint8_t *) mrd_out + mrd_size) > 611 (uintptr_t)((uint8_t *) out + out_obj->desc_size))) { 612 ERROR("%s: Invalid mrd structure.\n", __func__); 613 return false; 614 } 615 616 /* Copy the mrd descriptors directly. */ 617 memcpy(mrd_out, mrd_in, mrd_size); 618 619 return true; 620 } 621 622 /** 623 * spmc_populate_ffa_v1_0_descriptor - Converts a given v1.1 memory object to 624 * the v1.0 format and populates the 625 * provided buffer. 626 * @dst: Buffer to populate v1.0 ffa_memory_region_descriptor. 627 * @orig_obj: Object containing v1.1 ffa_memory_region_descriptor. 628 * @buf_size: Size of the buffer to populate. 629 * @offset: The offset of the converted descriptor to copy. 630 * @copy_size: Will be populated with the number of bytes copied. 631 * @out_desc_size: Will be populated with the total size of the v1.0 632 * descriptor. 633 * 634 * Return: 0 if conversion and population succeeded. 635 * Note: This function invalidates the reference to @orig therefore 636 * `spmc_shmem_obj_lookup` must be called if further usage is required. 637 */ 638 static uint32_t 639 spmc_populate_ffa_v1_0_descriptor(void *dst, struct spmc_shmem_obj *orig_obj, 640 size_t buf_size, size_t offset, 641 size_t *copy_size, size_t *v1_0_desc_size) 642 { 643 struct spmc_shmem_obj *v1_0_obj; 644 645 /* Calculate the size that the v1.0 descriptor will require. */ 646 *v1_0_desc_size = spmc_shm_get_v1_0_descriptor_size( 647 &orig_obj->desc, orig_obj->desc_size); 648 649 if (*v1_0_desc_size == 0) { 650 ERROR("%s: cannot determine size of descriptor.\n", 651 __func__); 652 return FFA_ERROR_INVALID_PARAMETER; 653 } 654 655 /* Get a new obj to store the v1.0 descriptor. */ 656 v1_0_obj = spmc_shmem_obj_alloc(&spmc_shmem_obj_state, 657 *v1_0_desc_size); 658 659 if (!v1_0_obj) { 660 return FFA_ERROR_NO_MEMORY; 661 } 662 663 /* Perform the conversion from v1.1 to v1.0. */ 664 if (!spmc_shm_convert_mtd_to_v1_0(v1_0_obj, orig_obj)) { 665 spmc_shmem_obj_free(&spmc_shmem_obj_state, v1_0_obj); 666 return FFA_ERROR_INVALID_PARAMETER; 667 } 668 669 *copy_size = MIN(v1_0_obj->desc_size - offset, buf_size); 670 memcpy(dst, (uint8_t *) &v1_0_obj->desc + offset, *copy_size); 671 672 /* 673 * We're finished with the v1.0 descriptor for now so free it. 674 * Note that this will invalidate any references to the v1.1 675 * descriptor. 676 */ 677 spmc_shmem_obj_free(&spmc_shmem_obj_state, v1_0_obj); 678 679 return 0; 680 } 681 682 static int 683 spmc_validate_mtd_start(struct ffa_mtd *desc, uint32_t ffa_version, 684 size_t fragment_length, size_t total_length) 685 { 686 unsigned long long emad_end; 687 unsigned long long emad_size; 688 unsigned long long emad_offset; 689 unsigned int min_desc_size; 690 691 /* Determine the appropriate minimum descriptor size. */ 692 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 693 min_desc_size = sizeof(struct ffa_mtd_v1_0); 694 } else if (ffa_version == MAKE_FFA_VERSION(1, 1)) { 695 min_desc_size = sizeof(struct ffa_mtd); 696 } else { 697 return FFA_ERROR_INVALID_PARAMETER; 698 } 699 if (fragment_length < min_desc_size) { 700 WARN("%s: invalid length %zu < %u\n", __func__, fragment_length, 701 min_desc_size); 702 return FFA_ERROR_INVALID_PARAMETER; 703 } 704 705 if (desc->emad_count == 0U) { 706 WARN("%s: unsupported attribute desc count %u.\n", 707 __func__, desc->emad_count); 708 return FFA_ERROR_INVALID_PARAMETER; 709 } 710 711 /* 712 * If the caller is using FF-A v1.0 interpret the descriptor as a v1.0 713 * format, otherwise assume it is a v1.1 format. 714 */ 715 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 716 emad_offset = emad_size = sizeof(struct ffa_emad_v1_0); 717 } else { 718 if (!is_aligned(desc->emad_offset, 16)) { 719 WARN("%s: Emad offset %" PRIx32 " is not 16-byte aligned.\n", 720 __func__, desc->emad_offset); 721 return FFA_ERROR_INVALID_PARAMETER; 722 } 723 if (desc->emad_offset < sizeof(struct ffa_mtd)) { 724 WARN("%s: Emad offset too small: 0x%" PRIx32 " < 0x%zx.\n", 725 __func__, desc->emad_offset, 726 sizeof(struct ffa_mtd)); 727 return FFA_ERROR_INVALID_PARAMETER; 728 } 729 emad_offset = desc->emad_offset; 730 if (desc->emad_size < sizeof(struct ffa_emad_v1_0)) { 731 WARN("%s: Bad emad size (%" PRIu32 " < %zu).\n", __func__, 732 desc->emad_size, sizeof(struct ffa_emad_v1_0)); 733 return FFA_ERROR_INVALID_PARAMETER; 734 } 735 if (!is_aligned(desc->emad_size, 16)) { 736 WARN("%s: Emad size 0x%" PRIx32 " is not 16-byte aligned.\n", 737 __func__, desc->emad_size); 738 return FFA_ERROR_INVALID_PARAMETER; 739 } 740 emad_size = desc->emad_size; 741 } 742 743 /* 744 * Overflow is impossible: the arithmetic happens in at least 64-bit 745 * precision, but all of the operands are bounded by UINT32_MAX, and 746 * ((2^32 - 1)^2 + (2^32 - 1) + (2^32 - 1)) = ((2^32 - 1) * (2^32 + 1)) 747 * = (2^64 - 1). 748 */ 749 CASSERT(sizeof(desc->emad_count == 4), assert_emad_count_max_too_large); 750 emad_end = (desc->emad_count * (unsigned long long)emad_size) + 751 (unsigned long long)sizeof(struct ffa_comp_mrd) + 752 (unsigned long long)emad_offset; 753 754 if (emad_end > total_length) { 755 WARN("%s: Composite memory region extends beyond descriptor: 0x%llx > 0x%zx\n", 756 __func__, emad_end, total_length); 757 return FFA_ERROR_INVALID_PARAMETER; 758 } 759 760 return 0; 761 } 762 763 /** 764 * spmc_shmem_check_obj - Check that counts in descriptor match overall size. 765 * @obj: Object containing ffa_memory_region_descriptor. 766 * @ffa_version: FF-A version of the provided descriptor. 767 * 768 * Return: 0 if object is valid, FFA_ERROR_INVALID_PARAMETER if 769 * constituent_memory_region_descriptor offset or count is invalid. 770 */ 771 static int spmc_shmem_check_obj(struct spmc_shmem_obj *obj, 772 uint32_t ffa_version) 773 { 774 const struct ffa_emad_v1_0 *emad; 775 size_t emad_size; 776 uint32_t comp_mrd_offset = 0; 777 778 if (obj->desc_filled != obj->desc_size) { 779 ERROR("BUG: %s called on incomplete object (%zu != %zu)\n", 780 __func__, obj->desc_filled, obj->desc_size); 781 panic(); 782 } 783 784 if (spmc_validate_mtd_start(&obj->desc, ffa_version, 785 obj->desc_filled, obj->desc_size)) { 786 ERROR("BUG: %s called on object with corrupt memory region descriptor\n", 787 __func__); 788 panic(); 789 } 790 791 emad = spmc_shmem_obj_get_emad(&obj->desc, 0, 792 ffa_version, &emad_size); 793 794 for (size_t emad_num = 0; emad_num < obj->desc.emad_count; emad_num++) { 795 size_t size; 796 size_t count; 797 size_t expected_size; 798 uint64_t total_page_count; 799 size_t header_emad_size; 800 uint32_t offset; 801 struct ffa_comp_mrd *comp; 802 ffa_endpoint_id16_t ep_id; 803 804 /* 805 * Validate the calculated emad address resides within the 806 * descriptor. 807 */ 808 if ((uintptr_t) emad > 809 ((uintptr_t) &obj->desc + obj->desc_size - emad_size)) { 810 ERROR("BUG: Invalid emad access not detected earlier.\n"); 811 panic(); 812 } 813 814 emad = (const struct ffa_emad_v1_0 *)((const uint8_t *)emad + emad_size); 815 offset = emad->comp_mrd_offset; 816 817 /* 818 * If a partition ID resides in the secure world validate that 819 * the partition ID is for a known partition. Ignore any 820 * partition ID belonging to the normal world as it is assumed 821 * the Hypervisor will have validated these. 822 */ 823 ep_id = emad->mapd.endpoint_id; 824 if (ffa_is_secure_world_id(ep_id)) { 825 if (spmc_get_sp_ctx(ep_id) == NULL) { 826 WARN("%s: Invalid receiver id 0x%x\n", 827 __func__, ep_id); 828 return FFA_ERROR_INVALID_PARAMETER; 829 } 830 } 831 832 /* 833 * The offset provided to the composite memory region descriptor 834 * should be consistent across endpoint descriptors. Store the 835 * first entry and compare against subsequent entries. 836 */ 837 if (comp_mrd_offset == 0) { 838 comp_mrd_offset = offset; 839 } else { 840 if (comp_mrd_offset != offset) { 841 ERROR("%s: mismatching offsets provided, %u != %u\n", 842 __func__, offset, comp_mrd_offset); 843 return FFA_ERROR_INVALID_PARAMETER; 844 } 845 continue; /* Remainder only executed on first iteration. */ 846 } 847 848 header_emad_size = (size_t)((uint8_t *)emad - (uint8_t *)&obj->desc) + 849 (obj->desc.emad_count * emad_size); 850 851 if (offset < header_emad_size) { 852 WARN("%s: invalid object, offset %u < header + emad %zu\n", 853 __func__, offset, header_emad_size); 854 return FFA_ERROR_INVALID_PARAMETER; 855 } 856 857 size = obj->desc_size; 858 859 if (offset > size) { 860 WARN("%s: invalid object, offset %u > total size %zu\n", 861 __func__, offset, obj->desc_size); 862 return FFA_ERROR_INVALID_PARAMETER; 863 } 864 size -= offset; 865 866 if (size < sizeof(struct ffa_comp_mrd)) { 867 WARN("%s: invalid object, offset %u, total size %zu, no header space.\n", 868 __func__, offset, obj->desc_size); 869 return FFA_ERROR_INVALID_PARAMETER; 870 } 871 size -= sizeof(struct ffa_comp_mrd); 872 873 count = size / sizeof(struct ffa_cons_mrd); 874 875 comp = spmc_shmem_obj_get_comp_mrd(obj, ffa_version); 876 877 if (comp == NULL) { 878 WARN("%s: invalid comp_mrd offset\n", __func__); 879 return FFA_ERROR_INVALID_PARAMETER; 880 } 881 882 if (comp->address_range_count != count) { 883 WARN("%s: invalid object, desc count %u != %zu\n", 884 __func__, comp->address_range_count, count); 885 return FFA_ERROR_INVALID_PARAMETER; 886 } 887 888 expected_size = offset + sizeof(*comp) + 889 count * sizeof(struct ffa_cons_mrd); 890 891 if (expected_size != obj->desc_size) { 892 WARN("%s: invalid object, computed size %zu != size %zu\n", 893 __func__, expected_size, obj->desc_size); 894 return FFA_ERROR_INVALID_PARAMETER; 895 } 896 897 total_page_count = 0; 898 899 for (size_t i = 0; i < count; i++) { 900 total_page_count += 901 comp->address_range_array[i].page_count; 902 } 903 if (comp->total_page_count != total_page_count) { 904 WARN("%s: invalid object, desc total_page_count %u != %" PRIu64 "\n", 905 __func__, comp->total_page_count, 906 total_page_count); 907 return FFA_ERROR_INVALID_PARAMETER; 908 } 909 } 910 return 0; 911 } 912 913 /** 914 * spmc_shmem_check_state_obj - Check if the descriptor describes memory 915 * regions that are currently involved with an 916 * existing memory transactions. This implies that 917 * the memory is not in a valid state for lending. 918 * @obj: Object containing ffa_memory_region_descriptor. 919 * 920 * Return: 0 if object is valid, FFA_ERROR_INVALID_PARAMETER if invalid memory 921 * state. 922 */ 923 static int spmc_shmem_check_state_obj(struct spmc_shmem_obj *obj, 924 uint32_t ffa_version) 925 { 926 size_t obj_offset = 0; 927 struct spmc_shmem_obj *inflight_obj; 928 929 struct ffa_comp_mrd *other_mrd; 930 struct ffa_comp_mrd *requested_mrd = spmc_shmem_obj_get_comp_mrd(obj, 931 ffa_version); 932 933 if (requested_mrd == NULL) { 934 return FFA_ERROR_INVALID_PARAMETER; 935 } 936 937 inflight_obj = spmc_shmem_obj_get_next(&spmc_shmem_obj_state, 938 &obj_offset); 939 940 while (inflight_obj != NULL) { 941 /* 942 * Don't compare the transaction to itself or to partially 943 * transmitted descriptors. 944 */ 945 if ((obj->desc.handle != inflight_obj->desc.handle) && 946 (obj->desc_size == obj->desc_filled)) { 947 other_mrd = spmc_shmem_obj_get_comp_mrd(inflight_obj, 948 FFA_VERSION_COMPILED); 949 if (other_mrd == NULL) { 950 return FFA_ERROR_INVALID_PARAMETER; 951 } 952 if (overlapping_memory_regions(requested_mrd, 953 other_mrd)) { 954 return FFA_ERROR_INVALID_PARAMETER; 955 } 956 } 957 958 inflight_obj = spmc_shmem_obj_get_next(&spmc_shmem_obj_state, 959 &obj_offset); 960 } 961 return 0; 962 } 963 964 static long spmc_ffa_fill_desc(struct mailbox *mbox, 965 struct spmc_shmem_obj *obj, 966 uint32_t fragment_length, 967 ffa_mtd_flag32_t mtd_flag, 968 uint32_t ffa_version, 969 void *smc_handle) 970 { 971 int ret; 972 size_t emad_size; 973 uint32_t handle_low; 974 uint32_t handle_high; 975 struct ffa_emad_v1_0 *emad; 976 struct ffa_emad_v1_0 *other_emad; 977 978 if (mbox->rxtx_page_count == 0U) { 979 WARN("%s: buffer pair not registered.\n", __func__); 980 ret = FFA_ERROR_INVALID_PARAMETER; 981 goto err_arg; 982 } 983 984 CASSERT(sizeof(mbox->rxtx_page_count) == 4, assert_bogus_page_count); 985 if (fragment_length > (uint64_t)mbox->rxtx_page_count * PAGE_SIZE_4KB) { 986 WARN("%s: bad fragment size %u > %" PRIu64 " buffer size\n", __func__, 987 fragment_length, (uint64_t)mbox->rxtx_page_count * PAGE_SIZE_4KB); 988 ret = FFA_ERROR_INVALID_PARAMETER; 989 goto err_arg; 990 } 991 992 if (fragment_length > obj->desc_size - obj->desc_filled) { 993 WARN("%s: bad fragment size %u > %zu remaining\n", __func__, 994 fragment_length, obj->desc_size - obj->desc_filled); 995 ret = FFA_ERROR_INVALID_PARAMETER; 996 goto err_arg; 997 } 998 999 memcpy((uint8_t *)&obj->desc + obj->desc_filled, 1000 (uint8_t *) mbox->tx_buffer, fragment_length); 1001 1002 /* Ensure that the sender ID resides in the normal world. */ 1003 if (ffa_is_secure_world_id(obj->desc.sender_id)) { 1004 WARN("%s: Invalid sender ID 0x%x.\n", 1005 __func__, obj->desc.sender_id); 1006 ret = FFA_ERROR_DENIED; 1007 goto err_arg; 1008 } 1009 1010 /* Ensure the NS bit is set to 0. */ 1011 if ((obj->desc.memory_region_attributes & FFA_MEM_ATTR_NS_BIT) != 0U) { 1012 WARN("%s: NS mem attributes flags MBZ.\n", __func__); 1013 ret = FFA_ERROR_INVALID_PARAMETER; 1014 goto err_arg; 1015 } 1016 1017 /* 1018 * We don't currently support any optional flags so ensure none are 1019 * requested. 1020 */ 1021 if (obj->desc.flags != 0U && mtd_flag != 0U && 1022 (obj->desc.flags != mtd_flag)) { 1023 WARN("%s: invalid memory transaction flags %u != %u\n", 1024 __func__, obj->desc.flags, mtd_flag); 1025 ret = FFA_ERROR_INVALID_PARAMETER; 1026 goto err_arg; 1027 } 1028 1029 if (obj->desc_filled == 0U) { 1030 /* First fragment, descriptor header has been copied */ 1031 ret = spmc_validate_mtd_start(&obj->desc, ffa_version, 1032 fragment_length, obj->desc_size); 1033 if (ret != 0) { 1034 goto err_bad_desc; 1035 } 1036 1037 obj->desc.handle = spmc_shmem_obj_state.next_handle++; 1038 obj->desc.flags |= mtd_flag; 1039 } 1040 1041 obj->desc_filled += fragment_length; 1042 1043 handle_low = (uint32_t)obj->desc.handle; 1044 handle_high = obj->desc.handle >> 32; 1045 1046 if (obj->desc_filled != obj->desc_size) { 1047 SMC_RET8(smc_handle, FFA_MEM_FRAG_RX, handle_low, 1048 handle_high, obj->desc_filled, 1049 (uint32_t)obj->desc.sender_id << 16, 0, 0, 0); 1050 } 1051 1052 /* The full descriptor has been received, perform any final checks. */ 1053 1054 ret = spmc_shmem_check_obj(obj, ffa_version); 1055 if (ret != 0) { 1056 goto err_bad_desc; 1057 } 1058 1059 /* Ensure partition IDs are not duplicated. */ 1060 for (size_t i = 0; i < obj->desc.emad_count; i++) { 1061 emad = spmc_shmem_obj_get_emad(&obj->desc, i, ffa_version, 1062 &emad_size); 1063 1064 for (size_t j = i + 1; j < obj->desc.emad_count; j++) { 1065 other_emad = spmc_shmem_obj_get_emad(&obj->desc, j, 1066 ffa_version, 1067 &emad_size); 1068 1069 if (emad->mapd.endpoint_id == 1070 other_emad->mapd.endpoint_id) { 1071 WARN("%s: Duplicated endpoint id 0x%x\n", 1072 __func__, emad->mapd.endpoint_id); 1073 ret = FFA_ERROR_INVALID_PARAMETER; 1074 goto err_bad_desc; 1075 } 1076 } 1077 } 1078 1079 ret = spmc_shmem_check_state_obj(obj, ffa_version); 1080 if (ret) { 1081 ERROR("%s: invalid memory region descriptor.\n", __func__); 1082 goto err_bad_desc; 1083 } 1084 1085 /* 1086 * Everything checks out, if the sender was using FF-A v1.0, convert 1087 * the descriptor format to use the v1.1 structures. 1088 */ 1089 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 1090 struct spmc_shmem_obj *v1_1_obj; 1091 uint64_t mem_handle; 1092 1093 /* Calculate the size that the v1.1 descriptor will required. */ 1094 uint64_t v1_1_desc_size = 1095 spmc_shm_get_v1_1_descriptor_size((void *) &obj->desc, 1096 obj->desc_size); 1097 1098 if (v1_1_desc_size > UINT32_MAX) { 1099 ret = FFA_ERROR_NO_MEMORY; 1100 goto err_arg; 1101 } 1102 1103 /* Get a new obj to store the v1.1 descriptor. */ 1104 v1_1_obj = 1105 spmc_shmem_obj_alloc(&spmc_shmem_obj_state, (size_t)v1_1_desc_size); 1106 1107 if (!v1_1_obj) { 1108 ret = FFA_ERROR_NO_MEMORY; 1109 goto err_arg; 1110 } 1111 1112 /* Perform the conversion from v1.0 to v1.1. */ 1113 v1_1_obj->desc_size = (uint32_t)v1_1_desc_size; 1114 v1_1_obj->desc_filled = (uint32_t)v1_1_desc_size; 1115 if (!spmc_shm_convert_shmem_obj_from_v1_0(v1_1_obj, obj)) { 1116 ERROR("%s: Could not convert mtd!\n", __func__); 1117 spmc_shmem_obj_free(&spmc_shmem_obj_state, v1_1_obj); 1118 goto err_arg; 1119 } 1120 1121 /* 1122 * We're finished with the v1.0 descriptor so free it 1123 * and continue our checks with the new v1.1 descriptor. 1124 */ 1125 mem_handle = obj->desc.handle; 1126 spmc_shmem_obj_free(&spmc_shmem_obj_state, obj); 1127 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, mem_handle); 1128 if (obj == NULL) { 1129 ERROR("%s: Failed to find converted descriptor.\n", 1130 __func__); 1131 ret = FFA_ERROR_INVALID_PARAMETER; 1132 return spmc_ffa_error_return(smc_handle, ret); 1133 } 1134 } 1135 1136 /* Allow for platform specific operations to be performed. */ 1137 ret = plat_spmc_shmem_begin(&obj->desc); 1138 if (ret != 0) { 1139 goto err_arg; 1140 } 1141 1142 SMC_RET8(smc_handle, FFA_SUCCESS_SMC32, 0, handle_low, handle_high, 0, 1143 0, 0, 0); 1144 1145 err_bad_desc: 1146 err_arg: 1147 spmc_shmem_obj_free(&spmc_shmem_obj_state, obj); 1148 return spmc_ffa_error_return(smc_handle, ret); 1149 } 1150 1151 /** 1152 * spmc_ffa_mem_send - FFA_MEM_SHARE/LEND implementation. 1153 * @client: Client state. 1154 * @total_length: Total length of shared memory descriptor. 1155 * @fragment_length: Length of fragment of shared memory descriptor passed in 1156 * this call. 1157 * @address: Not supported, must be 0. 1158 * @page_count: Not supported, must be 0. 1159 * @smc_handle: Handle passed to smc call. Used to return 1160 * FFA_MEM_FRAG_RX or SMC_FC_FFA_SUCCESS. 1161 * 1162 * Implements a subset of the FF-A FFA_MEM_SHARE and FFA_MEM_LEND calls needed 1163 * to share or lend memory from non-secure os to secure os (with no stream 1164 * endpoints). 1165 * 1166 * Return: 0 on success, error code on failure. 1167 */ 1168 long spmc_ffa_mem_send(uint32_t smc_fid, 1169 bool secure_origin, 1170 uint64_t total_length, 1171 uint32_t fragment_length, 1172 uint64_t address, 1173 uint32_t page_count, 1174 void *cookie, 1175 void *handle, 1176 uint64_t flags) 1177 1178 { 1179 long ret; 1180 struct spmc_shmem_obj *obj; 1181 struct mailbox *mbox = spmc_get_mbox_desc(secure_origin); 1182 ffa_mtd_flag32_t mtd_flag; 1183 uint32_t ffa_version = get_partition_ffa_version(secure_origin); 1184 size_t min_desc_size; 1185 1186 if (address != 0U || page_count != 0U) { 1187 WARN("%s: custom memory region for message not supported.\n", 1188 __func__); 1189 return spmc_ffa_error_return(handle, 1190 FFA_ERROR_INVALID_PARAMETER); 1191 } 1192 1193 if (secure_origin) { 1194 WARN("%s: unsupported share direction.\n", __func__); 1195 return spmc_ffa_error_return(handle, 1196 FFA_ERROR_INVALID_PARAMETER); 1197 } 1198 1199 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 1200 min_desc_size = sizeof(struct ffa_mtd_v1_0); 1201 } else if (ffa_version == MAKE_FFA_VERSION(1, 1)) { 1202 min_desc_size = sizeof(struct ffa_mtd); 1203 } else { 1204 WARN("%s: bad FF-A version.\n", __func__); 1205 return spmc_ffa_error_return(handle, 1206 FFA_ERROR_INVALID_PARAMETER); 1207 } 1208 1209 /* Check if the descriptor is too small for the FF-A version. */ 1210 if (fragment_length < min_desc_size) { 1211 WARN("%s: bad first fragment size %u < %zu\n", 1212 __func__, fragment_length, sizeof(struct ffa_mtd_v1_0)); 1213 return spmc_ffa_error_return(handle, 1214 FFA_ERROR_INVALID_PARAMETER); 1215 } 1216 1217 if ((smc_fid & FUNCID_NUM_MASK) == FFA_FNUM_MEM_SHARE) { 1218 mtd_flag = FFA_MTD_FLAG_TYPE_SHARE_MEMORY; 1219 } else if ((smc_fid & FUNCID_NUM_MASK) == FFA_FNUM_MEM_LEND) { 1220 mtd_flag = FFA_MTD_FLAG_TYPE_LEND_MEMORY; 1221 } else { 1222 WARN("%s: invalid memory management operation.\n", __func__); 1223 return spmc_ffa_error_return(handle, 1224 FFA_ERROR_INVALID_PARAMETER); 1225 } 1226 1227 spin_lock(&spmc_shmem_obj_state.lock); 1228 obj = spmc_shmem_obj_alloc(&spmc_shmem_obj_state, total_length); 1229 if (obj == NULL) { 1230 ret = FFA_ERROR_NO_MEMORY; 1231 goto err_unlock; 1232 } 1233 1234 spin_lock(&mbox->lock); 1235 ret = spmc_ffa_fill_desc(mbox, obj, fragment_length, mtd_flag, 1236 ffa_version, handle); 1237 spin_unlock(&mbox->lock); 1238 1239 spin_unlock(&spmc_shmem_obj_state.lock); 1240 return ret; 1241 1242 err_unlock: 1243 spin_unlock(&spmc_shmem_obj_state.lock); 1244 return spmc_ffa_error_return(handle, ret); 1245 } 1246 1247 /** 1248 * spmc_ffa_mem_frag_tx - FFA_MEM_FRAG_TX implementation. 1249 * @client: Client state. 1250 * @handle_low: Handle_low value returned from FFA_MEM_FRAG_RX. 1251 * @handle_high: Handle_high value returned from FFA_MEM_FRAG_RX. 1252 * @fragment_length: Length of fragments transmitted. 1253 * @sender_id: Vmid of sender in bits [31:16] 1254 * @smc_handle: Handle passed to smc call. Used to return 1255 * FFA_MEM_FRAG_RX or SMC_FC_FFA_SUCCESS. 1256 * 1257 * Return: @smc_handle on success, error code on failure. 1258 */ 1259 long spmc_ffa_mem_frag_tx(uint32_t smc_fid, 1260 bool secure_origin, 1261 uint64_t handle_low, 1262 uint64_t handle_high, 1263 uint32_t fragment_length, 1264 uint32_t sender_id, 1265 void *cookie, 1266 void *handle, 1267 uint64_t flags) 1268 { 1269 long ret; 1270 uint32_t desc_sender_id; 1271 uint32_t ffa_version = get_partition_ffa_version(secure_origin); 1272 struct mailbox *mbox = spmc_get_mbox_desc(secure_origin); 1273 1274 struct spmc_shmem_obj *obj; 1275 uint64_t mem_handle = handle_low | (((uint64_t)handle_high) << 32); 1276 1277 spin_lock(&spmc_shmem_obj_state.lock); 1278 1279 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, mem_handle); 1280 if (obj == NULL) { 1281 WARN("%s: invalid handle, 0x%lx, not a valid handle.\n", 1282 __func__, mem_handle); 1283 ret = FFA_ERROR_INVALID_PARAMETER; 1284 goto err_unlock; 1285 } 1286 1287 desc_sender_id = (uint32_t)obj->desc.sender_id << 16; 1288 if (sender_id != desc_sender_id) { 1289 WARN("%s: invalid sender_id 0x%x != 0x%x\n", __func__, 1290 sender_id, desc_sender_id); 1291 ret = FFA_ERROR_INVALID_PARAMETER; 1292 goto err_unlock; 1293 } 1294 1295 if (obj->desc_filled == obj->desc_size) { 1296 WARN("%s: object desc already filled, %zu\n", __func__, 1297 obj->desc_filled); 1298 ret = FFA_ERROR_INVALID_PARAMETER; 1299 goto err_unlock; 1300 } 1301 1302 spin_lock(&mbox->lock); 1303 ret = spmc_ffa_fill_desc(mbox, obj, fragment_length, 0, ffa_version, 1304 handle); 1305 spin_unlock(&mbox->lock); 1306 1307 spin_unlock(&spmc_shmem_obj_state.lock); 1308 return ret; 1309 1310 err_unlock: 1311 spin_unlock(&spmc_shmem_obj_state.lock); 1312 return spmc_ffa_error_return(handle, ret); 1313 } 1314 1315 /** 1316 * spmc_ffa_mem_retrieve_set_ns_bit - Set the NS bit in the response descriptor 1317 * if the caller implements a version greater 1318 * than FF-A 1.0 or if they have requested 1319 * the functionality. 1320 * TODO: We are assuming that the caller is 1321 * an SP. To support retrieval from the 1322 * normal world this function will need to be 1323 * expanded accordingly. 1324 * @resp: Descriptor populated in callers RX buffer. 1325 * @sp_ctx: Context of the calling SP. 1326 */ 1327 void spmc_ffa_mem_retrieve_set_ns_bit(struct ffa_mtd *resp, 1328 struct secure_partition_desc *sp_ctx) 1329 { 1330 if (sp_ctx->ffa_version > MAKE_FFA_VERSION(1, 0) || 1331 sp_ctx->ns_bit_requested) { 1332 /* 1333 * Currently memory senders must reside in the normal 1334 * world, and we do not have the functionlaity to change 1335 * the state of memory dynamically. Therefore we can always set 1336 * the NS bit to 1. 1337 */ 1338 resp->memory_region_attributes |= FFA_MEM_ATTR_NS_BIT; 1339 } 1340 } 1341 1342 /** 1343 * spmc_ffa_mem_retrieve_req - FFA_MEM_RETRIEVE_REQ implementation. 1344 * @smc_fid: FID of SMC 1345 * @total_length: Total length of retrieve request descriptor if this is 1346 * the first call. Otherwise (unsupported) must be 0. 1347 * @fragment_length: Length of fragment of retrieve request descriptor passed 1348 * in this call. Only @fragment_length == @length is 1349 * supported by this implementation. 1350 * @address: Not supported, must be 0. 1351 * @page_count: Not supported, must be 0. 1352 * @smc_handle: Handle passed to smc call. Used to return 1353 * FFA_MEM_RETRIEVE_RESP. 1354 * 1355 * Implements a subset of the FF-A FFA_MEM_RETRIEVE_REQ call. 1356 * Used by secure os to retrieve memory already shared by non-secure os. 1357 * If the data does not fit in a single FFA_MEM_RETRIEVE_RESP message, 1358 * the client must call FFA_MEM_FRAG_RX until the full response has been 1359 * received. 1360 * 1361 * Return: @handle on success, error code on failure. 1362 */ 1363 long 1364 spmc_ffa_mem_retrieve_req(uint32_t smc_fid, 1365 bool secure_origin, 1366 uint32_t total_length, 1367 uint32_t fragment_length, 1368 uint64_t address, 1369 uint32_t page_count, 1370 void *cookie, 1371 void *handle, 1372 uint64_t flags) 1373 { 1374 int ret; 1375 size_t buf_size; 1376 size_t copy_size = 0; 1377 size_t min_desc_size; 1378 size_t out_desc_size = 0; 1379 1380 /* 1381 * Currently we are only accessing fields that are the same in both the 1382 * v1.0 and v1.1 mtd struct therefore we can use a v1.1 struct directly 1383 * here. We only need validate against the appropriate struct size. 1384 */ 1385 struct ffa_mtd *resp; 1386 const struct ffa_mtd *req; 1387 struct spmc_shmem_obj *obj = NULL; 1388 struct mailbox *mbox = spmc_get_mbox_desc(secure_origin); 1389 uint32_t ffa_version = get_partition_ffa_version(secure_origin); 1390 struct secure_partition_desc *sp_ctx = spmc_get_current_sp_ctx(); 1391 1392 if (!secure_origin) { 1393 WARN("%s: unsupported retrieve req direction.\n", __func__); 1394 return spmc_ffa_error_return(handle, 1395 FFA_ERROR_INVALID_PARAMETER); 1396 } 1397 1398 if (address != 0U || page_count != 0U) { 1399 WARN("%s: custom memory region not supported.\n", __func__); 1400 return spmc_ffa_error_return(handle, 1401 FFA_ERROR_INVALID_PARAMETER); 1402 } 1403 1404 spin_lock(&mbox->lock); 1405 1406 req = mbox->tx_buffer; 1407 resp = mbox->rx_buffer; 1408 buf_size = mbox->rxtx_page_count * FFA_PAGE_SIZE; 1409 1410 if (mbox->rxtx_page_count == 0U) { 1411 WARN("%s: buffer pair not registered.\n", __func__); 1412 ret = FFA_ERROR_INVALID_PARAMETER; 1413 goto err_unlock_mailbox; 1414 } 1415 1416 if (mbox->state != MAILBOX_STATE_EMPTY) { 1417 WARN("%s: RX Buffer is full! %d\n", __func__, mbox->state); 1418 ret = FFA_ERROR_DENIED; 1419 goto err_unlock_mailbox; 1420 } 1421 1422 if (fragment_length != total_length) { 1423 WARN("%s: fragmented retrieve request not supported.\n", 1424 __func__); 1425 ret = FFA_ERROR_INVALID_PARAMETER; 1426 goto err_unlock_mailbox; 1427 } 1428 1429 if (req->emad_count == 0U) { 1430 WARN("%s: unsupported attribute desc count %u.\n", 1431 __func__, obj->desc.emad_count); 1432 ret = FFA_ERROR_INVALID_PARAMETER; 1433 goto err_unlock_mailbox; 1434 } 1435 1436 /* Determine the appropriate minimum descriptor size. */ 1437 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 1438 min_desc_size = sizeof(struct ffa_mtd_v1_0); 1439 } else { 1440 min_desc_size = sizeof(struct ffa_mtd); 1441 } 1442 if (total_length < min_desc_size) { 1443 WARN("%s: invalid length %u < %zu\n", __func__, total_length, 1444 min_desc_size); 1445 ret = FFA_ERROR_INVALID_PARAMETER; 1446 goto err_unlock_mailbox; 1447 } 1448 1449 spin_lock(&spmc_shmem_obj_state.lock); 1450 1451 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, req->handle); 1452 if (obj == NULL) { 1453 ret = FFA_ERROR_INVALID_PARAMETER; 1454 goto err_unlock_all; 1455 } 1456 1457 if (obj->desc_filled != obj->desc_size) { 1458 WARN("%s: incomplete object desc filled %zu < size %zu\n", 1459 __func__, obj->desc_filled, obj->desc_size); 1460 ret = FFA_ERROR_INVALID_PARAMETER; 1461 goto err_unlock_all; 1462 } 1463 1464 if (req->emad_count != 0U && req->sender_id != obj->desc.sender_id) { 1465 WARN("%s: wrong sender id 0x%x != 0x%x\n", 1466 __func__, req->sender_id, obj->desc.sender_id); 1467 ret = FFA_ERROR_INVALID_PARAMETER; 1468 goto err_unlock_all; 1469 } 1470 1471 if (req->emad_count != 0U && req->tag != obj->desc.tag) { 1472 WARN("%s: wrong tag 0x%lx != 0x%lx\n", 1473 __func__, req->tag, obj->desc.tag); 1474 ret = FFA_ERROR_INVALID_PARAMETER; 1475 goto err_unlock_all; 1476 } 1477 1478 if (req->emad_count != 0U && req->emad_count != obj->desc.emad_count) { 1479 WARN("%s: mistmatch of endpoint counts %u != %u\n", 1480 __func__, req->emad_count, obj->desc.emad_count); 1481 ret = FFA_ERROR_INVALID_PARAMETER; 1482 goto err_unlock_all; 1483 } 1484 1485 /* Ensure the NS bit is set to 0 in the request. */ 1486 if ((req->memory_region_attributes & FFA_MEM_ATTR_NS_BIT) != 0U) { 1487 WARN("%s: NS mem attributes flags MBZ.\n", __func__); 1488 ret = FFA_ERROR_INVALID_PARAMETER; 1489 goto err_unlock_all; 1490 } 1491 1492 if (req->flags != 0U) { 1493 if ((req->flags & FFA_MTD_FLAG_TYPE_MASK) != 1494 (obj->desc.flags & FFA_MTD_FLAG_TYPE_MASK)) { 1495 /* 1496 * If the retrieve request specifies the memory 1497 * transaction ensure it matches what we expect. 1498 */ 1499 WARN("%s: wrong mem transaction flags %x != %x\n", 1500 __func__, req->flags, obj->desc.flags); 1501 ret = FFA_ERROR_INVALID_PARAMETER; 1502 goto err_unlock_all; 1503 } 1504 1505 if (req->flags != FFA_MTD_FLAG_TYPE_SHARE_MEMORY && 1506 req->flags != FFA_MTD_FLAG_TYPE_LEND_MEMORY) { 1507 /* 1508 * Current implementation does not support donate and 1509 * it supports no other flags. 1510 */ 1511 WARN("%s: invalid flags 0x%x\n", __func__, req->flags); 1512 ret = FFA_ERROR_INVALID_PARAMETER; 1513 goto err_unlock_all; 1514 } 1515 } 1516 1517 /* Validate the caller is a valid participant. */ 1518 if (!spmc_shmem_obj_validate_id(obj, sp_ctx->sp_id)) { 1519 WARN("%s: Invalid endpoint ID (0x%x).\n", 1520 __func__, sp_ctx->sp_id); 1521 ret = FFA_ERROR_INVALID_PARAMETER; 1522 goto err_unlock_all; 1523 } 1524 1525 /* Validate that the provided emad offset and structure is valid.*/ 1526 for (size_t i = 0; i < req->emad_count; i++) { 1527 size_t emad_size; 1528 struct ffa_emad_v1_0 *emad; 1529 1530 emad = spmc_shmem_obj_get_emad(req, i, ffa_version, 1531 &emad_size); 1532 1533 if ((uintptr_t) emad >= (uintptr_t) 1534 ((uint8_t *) req + total_length)) { 1535 WARN("Invalid emad access.\n"); 1536 ret = FFA_ERROR_INVALID_PARAMETER; 1537 goto err_unlock_all; 1538 } 1539 } 1540 1541 /* 1542 * Validate all the endpoints match in the case of multiple 1543 * borrowers. We don't mandate that the order of the borrowers 1544 * must match in the descriptors therefore check to see if the 1545 * endpoints match in any order. 1546 */ 1547 for (size_t i = 0; i < req->emad_count; i++) { 1548 bool found = false; 1549 size_t emad_size; 1550 struct ffa_emad_v1_0 *emad; 1551 struct ffa_emad_v1_0 *other_emad; 1552 1553 emad = spmc_shmem_obj_get_emad(req, i, ffa_version, 1554 &emad_size); 1555 1556 for (size_t j = 0; j < obj->desc.emad_count; j++) { 1557 other_emad = spmc_shmem_obj_get_emad( 1558 &obj->desc, j, MAKE_FFA_VERSION(1, 1), 1559 &emad_size); 1560 1561 if (req->emad_count && 1562 emad->mapd.endpoint_id == 1563 other_emad->mapd.endpoint_id) { 1564 found = true; 1565 break; 1566 } 1567 } 1568 1569 if (!found) { 1570 WARN("%s: invalid receiver id (0x%x).\n", 1571 __func__, emad->mapd.endpoint_id); 1572 ret = FFA_ERROR_INVALID_PARAMETER; 1573 goto err_unlock_all; 1574 } 1575 } 1576 1577 mbox->state = MAILBOX_STATE_FULL; 1578 1579 if (req->emad_count != 0U) { 1580 obj->in_use++; 1581 } 1582 1583 /* 1584 * If the caller is v1.0 convert the descriptor, otherwise copy 1585 * directly. 1586 */ 1587 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 1588 ret = spmc_populate_ffa_v1_0_descriptor(resp, obj, buf_size, 0, 1589 ©_size, 1590 &out_desc_size); 1591 if (ret != 0U) { 1592 ERROR("%s: Failed to process descriptor.\n", __func__); 1593 goto err_unlock_all; 1594 } 1595 } else { 1596 copy_size = MIN(obj->desc_size, buf_size); 1597 out_desc_size = obj->desc_size; 1598 1599 memcpy(resp, &obj->desc, copy_size); 1600 } 1601 1602 /* Set the NS bit in the response if applicable. */ 1603 spmc_ffa_mem_retrieve_set_ns_bit(resp, sp_ctx); 1604 1605 spin_unlock(&spmc_shmem_obj_state.lock); 1606 spin_unlock(&mbox->lock); 1607 1608 SMC_RET8(handle, FFA_MEM_RETRIEVE_RESP, out_desc_size, 1609 copy_size, 0, 0, 0, 0, 0); 1610 1611 err_unlock_all: 1612 spin_unlock(&spmc_shmem_obj_state.lock); 1613 err_unlock_mailbox: 1614 spin_unlock(&mbox->lock); 1615 return spmc_ffa_error_return(handle, ret); 1616 } 1617 1618 /** 1619 * spmc_ffa_mem_frag_rx - FFA_MEM_FRAG_RX implementation. 1620 * @client: Client state. 1621 * @handle_low: Handle passed to &FFA_MEM_RETRIEVE_REQ. Bit[31:0]. 1622 * @handle_high: Handle passed to &FFA_MEM_RETRIEVE_REQ. Bit[63:32]. 1623 * @fragment_offset: Byte offset in descriptor to resume at. 1624 * @sender_id: Bit[31:16]: Endpoint id of sender if client is a 1625 * hypervisor. 0 otherwise. 1626 * @smc_handle: Handle passed to smc call. Used to return 1627 * FFA_MEM_FRAG_TX. 1628 * 1629 * Return: @smc_handle on success, error code on failure. 1630 */ 1631 long spmc_ffa_mem_frag_rx(uint32_t smc_fid, 1632 bool secure_origin, 1633 uint32_t handle_low, 1634 uint32_t handle_high, 1635 uint32_t fragment_offset, 1636 uint32_t sender_id, 1637 void *cookie, 1638 void *handle, 1639 uint64_t flags) 1640 { 1641 int ret; 1642 void *src; 1643 size_t buf_size; 1644 size_t copy_size; 1645 size_t full_copy_size; 1646 uint32_t desc_sender_id; 1647 struct mailbox *mbox = spmc_get_mbox_desc(secure_origin); 1648 uint64_t mem_handle = handle_low | (((uint64_t)handle_high) << 32); 1649 struct spmc_shmem_obj *obj; 1650 uint32_t ffa_version = get_partition_ffa_version(secure_origin); 1651 1652 if (!secure_origin) { 1653 WARN("%s: can only be called from swld.\n", 1654 __func__); 1655 return spmc_ffa_error_return(handle, 1656 FFA_ERROR_INVALID_PARAMETER); 1657 } 1658 1659 spin_lock(&spmc_shmem_obj_state.lock); 1660 1661 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, mem_handle); 1662 if (obj == NULL) { 1663 WARN("%s: invalid handle, 0x%lx, not a valid handle.\n", 1664 __func__, mem_handle); 1665 ret = FFA_ERROR_INVALID_PARAMETER; 1666 goto err_unlock_shmem; 1667 } 1668 1669 desc_sender_id = (uint32_t)obj->desc.sender_id << 16; 1670 if (sender_id != 0U && sender_id != desc_sender_id) { 1671 WARN("%s: invalid sender_id 0x%x != 0x%x\n", __func__, 1672 sender_id, desc_sender_id); 1673 ret = FFA_ERROR_INVALID_PARAMETER; 1674 goto err_unlock_shmem; 1675 } 1676 1677 if (fragment_offset >= obj->desc_size) { 1678 WARN("%s: invalid fragment_offset 0x%x >= 0x%zx\n", 1679 __func__, fragment_offset, obj->desc_size); 1680 ret = FFA_ERROR_INVALID_PARAMETER; 1681 goto err_unlock_shmem; 1682 } 1683 1684 spin_lock(&mbox->lock); 1685 1686 if (mbox->rxtx_page_count == 0U) { 1687 WARN("%s: buffer pair not registered.\n", __func__); 1688 ret = FFA_ERROR_INVALID_PARAMETER; 1689 goto err_unlock_all; 1690 } 1691 1692 if (mbox->state != MAILBOX_STATE_EMPTY) { 1693 WARN("%s: RX Buffer is full!\n", __func__); 1694 ret = FFA_ERROR_DENIED; 1695 goto err_unlock_all; 1696 } 1697 1698 buf_size = mbox->rxtx_page_count * FFA_PAGE_SIZE; 1699 1700 mbox->state = MAILBOX_STATE_FULL; 1701 1702 /* 1703 * If the caller is v1.0 convert the descriptor, otherwise copy 1704 * directly. 1705 */ 1706 if (ffa_version == MAKE_FFA_VERSION(1, 0)) { 1707 size_t out_desc_size; 1708 1709 ret = spmc_populate_ffa_v1_0_descriptor(mbox->rx_buffer, obj, 1710 buf_size, 1711 fragment_offset, 1712 ©_size, 1713 &out_desc_size); 1714 if (ret != 0U) { 1715 ERROR("%s: Failed to process descriptor.\n", __func__); 1716 goto err_unlock_all; 1717 } 1718 } else { 1719 full_copy_size = obj->desc_size - fragment_offset; 1720 copy_size = MIN(full_copy_size, buf_size); 1721 1722 src = &obj->desc; 1723 1724 memcpy(mbox->rx_buffer, src + fragment_offset, copy_size); 1725 } 1726 1727 spin_unlock(&mbox->lock); 1728 spin_unlock(&spmc_shmem_obj_state.lock); 1729 1730 SMC_RET8(handle, FFA_MEM_FRAG_TX, handle_low, handle_high, 1731 copy_size, sender_id, 0, 0, 0); 1732 1733 err_unlock_all: 1734 spin_unlock(&mbox->lock); 1735 err_unlock_shmem: 1736 spin_unlock(&spmc_shmem_obj_state.lock); 1737 return spmc_ffa_error_return(handle, ret); 1738 } 1739 1740 /** 1741 * spmc_ffa_mem_relinquish - FFA_MEM_RELINQUISH implementation. 1742 * @client: Client state. 1743 * 1744 * Implements a subset of the FF-A FFA_MEM_RELINQUISH call. 1745 * Used by secure os release previously shared memory to non-secure os. 1746 * 1747 * The handle to release must be in the client's (secure os's) transmit buffer. 1748 * 1749 * Return: 0 on success, error code on failure. 1750 */ 1751 int spmc_ffa_mem_relinquish(uint32_t smc_fid, 1752 bool secure_origin, 1753 uint32_t handle_low, 1754 uint32_t handle_high, 1755 uint32_t fragment_offset, 1756 uint32_t sender_id, 1757 void *cookie, 1758 void *handle, 1759 uint64_t flags) 1760 { 1761 int ret; 1762 struct mailbox *mbox = spmc_get_mbox_desc(secure_origin); 1763 struct spmc_shmem_obj *obj; 1764 const struct ffa_mem_relinquish_descriptor *req; 1765 struct secure_partition_desc *sp_ctx = spmc_get_current_sp_ctx(); 1766 1767 if (!secure_origin) { 1768 WARN("%s: unsupported relinquish direction.\n", __func__); 1769 return spmc_ffa_error_return(handle, 1770 FFA_ERROR_INVALID_PARAMETER); 1771 } 1772 1773 spin_lock(&mbox->lock); 1774 1775 if (mbox->rxtx_page_count == 0U) { 1776 WARN("%s: buffer pair not registered.\n", __func__); 1777 ret = FFA_ERROR_INVALID_PARAMETER; 1778 goto err_unlock_mailbox; 1779 } 1780 1781 req = mbox->tx_buffer; 1782 1783 if (req->flags != 0U) { 1784 WARN("%s: unsupported flags 0x%x\n", __func__, req->flags); 1785 ret = FFA_ERROR_INVALID_PARAMETER; 1786 goto err_unlock_mailbox; 1787 } 1788 1789 if (req->endpoint_count == 0) { 1790 WARN("%s: endpoint count cannot be 0.\n", __func__); 1791 ret = FFA_ERROR_INVALID_PARAMETER; 1792 goto err_unlock_mailbox; 1793 } 1794 1795 spin_lock(&spmc_shmem_obj_state.lock); 1796 1797 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, req->handle); 1798 if (obj == NULL) { 1799 ret = FFA_ERROR_INVALID_PARAMETER; 1800 goto err_unlock_all; 1801 } 1802 1803 /* 1804 * Validate the endpoint ID was populated correctly. We don't currently 1805 * support proxy endpoints so the endpoint count should always be 1. 1806 */ 1807 if (req->endpoint_count != 1U) { 1808 WARN("%s: unsupported endpoint count %u != 1\n", __func__, 1809 req->endpoint_count); 1810 ret = FFA_ERROR_INVALID_PARAMETER; 1811 goto err_unlock_all; 1812 } 1813 1814 /* Validate provided endpoint ID matches the partition ID. */ 1815 if (req->endpoint_array[0] != sp_ctx->sp_id) { 1816 WARN("%s: invalid endpoint ID %u != %u\n", __func__, 1817 req->endpoint_array[0], sp_ctx->sp_id); 1818 ret = FFA_ERROR_INVALID_PARAMETER; 1819 goto err_unlock_all; 1820 } 1821 1822 /* Validate the caller is a valid participant. */ 1823 if (!spmc_shmem_obj_validate_id(obj, sp_ctx->sp_id)) { 1824 WARN("%s: Invalid endpoint ID (0x%x).\n", 1825 __func__, req->endpoint_array[0]); 1826 ret = FFA_ERROR_INVALID_PARAMETER; 1827 goto err_unlock_all; 1828 } 1829 1830 if (obj->in_use == 0U) { 1831 ret = FFA_ERROR_INVALID_PARAMETER; 1832 goto err_unlock_all; 1833 } 1834 obj->in_use--; 1835 1836 spin_unlock(&spmc_shmem_obj_state.lock); 1837 spin_unlock(&mbox->lock); 1838 1839 SMC_RET1(handle, FFA_SUCCESS_SMC32); 1840 1841 err_unlock_all: 1842 spin_unlock(&spmc_shmem_obj_state.lock); 1843 err_unlock_mailbox: 1844 spin_unlock(&mbox->lock); 1845 return spmc_ffa_error_return(handle, ret); 1846 } 1847 1848 /** 1849 * spmc_ffa_mem_reclaim - FFA_MEM_RECLAIM implementation. 1850 * @client: Client state. 1851 * @handle_low: Unique handle of shared memory object to reclaim. Bit[31:0]. 1852 * @handle_high: Unique handle of shared memory object to reclaim. 1853 * Bit[63:32]. 1854 * @flags: Unsupported, ignored. 1855 * 1856 * Implements a subset of the FF-A FFA_MEM_RECLAIM call. 1857 * Used by non-secure os reclaim memory previously shared with secure os. 1858 * 1859 * Return: 0 on success, error code on failure. 1860 */ 1861 int spmc_ffa_mem_reclaim(uint32_t smc_fid, 1862 bool secure_origin, 1863 uint32_t handle_low, 1864 uint32_t handle_high, 1865 uint32_t mem_flags, 1866 uint64_t x4, 1867 void *cookie, 1868 void *handle, 1869 uint64_t flags) 1870 { 1871 int ret; 1872 struct spmc_shmem_obj *obj; 1873 uint64_t mem_handle = handle_low | (((uint64_t)handle_high) << 32); 1874 1875 if (secure_origin) { 1876 WARN("%s: unsupported reclaim direction.\n", __func__); 1877 return spmc_ffa_error_return(handle, 1878 FFA_ERROR_INVALID_PARAMETER); 1879 } 1880 1881 if (mem_flags != 0U) { 1882 WARN("%s: unsupported flags 0x%x\n", __func__, mem_flags); 1883 return spmc_ffa_error_return(handle, 1884 FFA_ERROR_INVALID_PARAMETER); 1885 } 1886 1887 spin_lock(&spmc_shmem_obj_state.lock); 1888 1889 obj = spmc_shmem_obj_lookup(&spmc_shmem_obj_state, mem_handle); 1890 if (obj == NULL) { 1891 ret = FFA_ERROR_INVALID_PARAMETER; 1892 goto err_unlock; 1893 } 1894 if (obj->in_use != 0U) { 1895 ret = FFA_ERROR_DENIED; 1896 goto err_unlock; 1897 } 1898 1899 if (obj->desc_filled != obj->desc_size) { 1900 WARN("%s: incomplete object desc filled %zu < size %zu\n", 1901 __func__, obj->desc_filled, obj->desc_size); 1902 ret = FFA_ERROR_INVALID_PARAMETER; 1903 goto err_unlock; 1904 } 1905 1906 /* Allow for platform specific operations to be performed. */ 1907 ret = plat_spmc_shmem_reclaim(&obj->desc); 1908 if (ret != 0) { 1909 goto err_unlock; 1910 } 1911 1912 spmc_shmem_obj_free(&spmc_shmem_obj_state, obj); 1913 spin_unlock(&spmc_shmem_obj_state.lock); 1914 1915 SMC_RET1(handle, FFA_SUCCESS_SMC32); 1916 1917 err_unlock: 1918 spin_unlock(&spmc_shmem_obj_state.lock); 1919 return spmc_ffa_error_return(handle, ret); 1920 } 1921