.. | .. |
---|
| 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 | */ |
---|