| .. | .. |
|---|
| 1 | +// SPDX-License-Identifier: GPL-2.0-or-later |
|---|
| 1 | 2 | /* |
|---|
| 2 | 3 | * Copyright 2015 IBM Corp. |
|---|
| 3 | | - * |
|---|
| 4 | | - * This program is free software; you can redistribute it and/or |
|---|
| 5 | | - * modify it under the terms of the GNU General Public License |
|---|
| 6 | | - * as published by the Free Software Foundation; either version |
|---|
| 7 | | - * 2 of the License, or (at your option) any later version. |
|---|
| 8 | 4 | */ |
|---|
| 9 | 5 | |
|---|
| 10 | 6 | |
|---|
| .. | .. |
|---|
| 171 | 167 | } |
|---|
| 172 | 168 | } |
|---|
| 173 | 169 | |
|---|
| 174 | | -/** |
|---|
| 170 | +/* |
|---|
| 175 | 171 | * cxl_h_detach_process - Detach a process element from a coherent |
|---|
| 176 | 172 | * platform function. |
|---|
| 177 | 173 | */ |
|---|
| .. | .. |
|---|
| 201 | 197 | } |
|---|
| 202 | 198 | } |
|---|
| 203 | 199 | |
|---|
| 204 | | -/** |
|---|
| 200 | +/* |
|---|
| 205 | 201 | * cxl_h_control_function - This H_CONTROL_CA_FUNCTION hypervisor call allows |
|---|
| 206 | 202 | * the partition to manipulate or query |
|---|
| 207 | 203 | * certain coherent platform function behaviors. |
|---|
| .. | .. |
|---|
| 242 | 238 | } |
|---|
| 243 | 239 | } |
|---|
| 244 | 240 | |
|---|
| 245 | | -/** |
|---|
| 241 | +/* |
|---|
| 246 | 242 | * cxl_h_reset_afu - Perform a reset to the coherent platform function. |
|---|
| 247 | 243 | */ |
|---|
| 248 | 244 | long cxl_h_reset_afu(u64 unit_address) |
|---|
| .. | .. |
|---|
| 253 | 249 | NULL); |
|---|
| 254 | 250 | } |
|---|
| 255 | 251 | |
|---|
| 256 | | -/** |
|---|
| 252 | +/* |
|---|
| 257 | 253 | * cxl_h_suspend_process - Suspend a process from being executed |
|---|
| 258 | 254 | * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when |
|---|
| 259 | 255 | * process was attached. |
|---|
| .. | .. |
|---|
| 266 | 262 | NULL); |
|---|
| 267 | 263 | } |
|---|
| 268 | 264 | |
|---|
| 269 | | -/** |
|---|
| 265 | +/* |
|---|
| 270 | 266 | * cxl_h_resume_process - Resume a process to be executed |
|---|
| 271 | 267 | * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when |
|---|
| 272 | 268 | * process was attached. |
|---|
| .. | .. |
|---|
| 279 | 275 | NULL); |
|---|
| 280 | 276 | } |
|---|
| 281 | 277 | |
|---|
| 282 | | -/** |
|---|
| 278 | +/* |
|---|
| 283 | 279 | * cxl_h_read_error_state - Checks the error state of the coherent |
|---|
| 284 | 280 | * platform function. |
|---|
| 285 | 281 | * R4 contains the error state |
|---|
| .. | .. |
|---|
| 292 | 288 | state); |
|---|
| 293 | 289 | } |
|---|
| 294 | 290 | |
|---|
| 295 | | -/** |
|---|
| 291 | +/* |
|---|
| 296 | 292 | * cxl_h_get_afu_err - collect the AFU error buffer |
|---|
| 297 | 293 | * Parameter1 = byte offset into error buffer to retrieve, valid values |
|---|
| 298 | 294 | * are between 0 and (ibm,error-buffer-size - 1) |
|---|
| .. | .. |
|---|
| 308 | 304 | NULL); |
|---|
| 309 | 305 | } |
|---|
| 310 | 306 | |
|---|
| 311 | | -/** |
|---|
| 307 | +/* |
|---|
| 312 | 308 | * cxl_h_get_config - collect configuration record for the |
|---|
| 313 | 309 | * coherent platform function |
|---|
| 314 | 310 | * Parameter1 = # of configuration record to retrieve, valid values are |
|---|
| .. | .. |
|---|
| 328 | 324 | NULL); |
|---|
| 329 | 325 | } |
|---|
| 330 | 326 | |
|---|
| 331 | | -/** |
|---|
| 327 | +/* |
|---|
| 332 | 328 | * cxl_h_terminate_process - Terminate the process before completion |
|---|
| 333 | 329 | * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when |
|---|
| 334 | 330 | * process was attached. |
|---|
| .. | .. |
|---|
| 341 | 337 | NULL); |
|---|
| 342 | 338 | } |
|---|
| 343 | 339 | |
|---|
| 344 | | -/** |
|---|
| 340 | +/* |
|---|
| 345 | 341 | * cxl_h_collect_vpd - Collect VPD for the coherent platform function. |
|---|
| 346 | 342 | * Parameter1 = # of VPD record to retrieve, valid values are between 0 |
|---|
| 347 | 343 | * and (ibm,#config-records - 1). |
|---|
| .. | .. |
|---|
| 359 | 355 | out); |
|---|
| 360 | 356 | } |
|---|
| 361 | 357 | |
|---|
| 362 | | -/** |
|---|
| 358 | +/* |
|---|
| 363 | 359 | * cxl_h_get_fn_error_interrupt - Read the function-wide error data based on an interrupt |
|---|
| 364 | 360 | */ |
|---|
| 365 | 361 | long cxl_h_get_fn_error_interrupt(u64 unit_address, u64 *reg) |
|---|
| .. | .. |
|---|
| 369 | 365 | 0, 0, 0, 0, reg); |
|---|
| 370 | 366 | } |
|---|
| 371 | 367 | |
|---|
| 372 | | -/** |
|---|
| 368 | +/* |
|---|
| 373 | 369 | * cxl_h_ack_fn_error_interrupt - Acknowledge function-wide error data |
|---|
| 374 | 370 | * based on an interrupt |
|---|
| 375 | 371 | * Parameter1 = value to write to the function-wide error interrupt register |
|---|
| .. | .. |
|---|
| 382 | 378 | NULL); |
|---|
| 383 | 379 | } |
|---|
| 384 | 380 | |
|---|
| 385 | | -/** |
|---|
| 381 | +/* |
|---|
| 386 | 382 | * cxl_h_get_error_log - Retrieve the Platform Log ID (PLID) of |
|---|
| 387 | 383 | * an error log |
|---|
| 388 | 384 | */ |
|---|
| .. | .. |
|---|
| 394 | 390 | NULL); |
|---|
| 395 | 391 | } |
|---|
| 396 | 392 | |
|---|
| 397 | | -/** |
|---|
| 393 | +/* |
|---|
| 398 | 394 | * cxl_h_collect_int_info - Collect interrupt info about a coherent |
|---|
| 399 | 395 | * platform function after an interrupt occurred. |
|---|
| 400 | 396 | */ |
|---|
| .. | .. |
|---|
| 429 | 425 | } |
|---|
| 430 | 426 | } |
|---|
| 431 | 427 | |
|---|
| 432 | | -/** |
|---|
| 428 | +/* |
|---|
| 433 | 429 | * cxl_h_control_faults - Control the operation of a coherent platform |
|---|
| 434 | 430 | * function after a fault occurs. |
|---|
| 435 | 431 | * |
|---|
| .. | .. |
|---|
| 474 | 470 | } |
|---|
| 475 | 471 | } |
|---|
| 476 | 472 | |
|---|
| 477 | | -/** |
|---|
| 473 | +/* |
|---|
| 478 | 474 | * cxl_h_control_facility - This H_CONTROL_CA_FACILITY hypervisor call |
|---|
| 479 | 475 | * allows the partition to manipulate or query |
|---|
| 480 | 476 | * certain coherent platform facility behaviors. |
|---|
| .. | .. |
|---|
| 513 | 509 | } |
|---|
| 514 | 510 | } |
|---|
| 515 | 511 | |
|---|
| 516 | | -/** |
|---|
| 512 | +/* |
|---|
| 517 | 513 | * cxl_h_reset_adapter - Perform a reset to the coherent platform facility. |
|---|
| 518 | 514 | */ |
|---|
| 519 | 515 | long cxl_h_reset_adapter(u64 unit_address) |
|---|
| .. | .. |
|---|
| 524 | 520 | NULL); |
|---|
| 525 | 521 | } |
|---|
| 526 | 522 | |
|---|
| 527 | | -/** |
|---|
| 523 | +/* |
|---|
| 528 | 524 | * cxl_h_collect_vpd - Collect VPD for the coherent platform function. |
|---|
| 529 | 525 | * Parameter1 = 4K naturally aligned real buffer containing block |
|---|
| 530 | 526 | * list entries |
|---|
| .. | .. |
|---|
| 540 | 536 | out); |
|---|
| 541 | 537 | } |
|---|
| 542 | 538 | |
|---|
| 543 | | -/** |
|---|
| 539 | +/* |
|---|
| 544 | 540 | * cxl_h_download_facility - This H_DOWNLOAD_CA_FACILITY |
|---|
| 545 | 541 | * hypervisor call provide platform support for |
|---|
| 546 | 542 | * downloading a base adapter image to the coherent |
|---|
| .. | .. |
|---|
| 620 | 616 | } |
|---|
| 621 | 617 | } |
|---|
| 622 | 618 | |
|---|
| 623 | | -/** |
|---|
| 619 | +/* |
|---|
| 624 | 620 | * cxl_h_download_adapter_image - Download the base image to the coherent |
|---|
| 625 | 621 | * platform facility. |
|---|
| 626 | 622 | */ |
|---|
| .. | .. |
|---|
| 633 | 629 | list_address, num, out); |
|---|
| 634 | 630 | } |
|---|
| 635 | 631 | |
|---|
| 636 | | -/** |
|---|
| 632 | +/* |
|---|
| 637 | 633 | * cxl_h_validate_adapter_image - Validate the base image in the coherent |
|---|
| 638 | 634 | * platform facility. |
|---|
| 639 | 635 | */ |
|---|