misc: cxl: hcalls: Demote half-assed kerneldoc attempt
Function headers will need a lot of work before they reach the standards expected of kerneldoc. Demote them down to basic comments/headers, for now at least. Fixes the following W=1 kernel build warnings: drivers/misc/cxl/hcalls.c:175: warning: Function parameter or member 'unit_address' not described in 'cxl_h_detach_process' drivers/misc/cxl/hcalls.c:175: warning: Function parameter or member 'process_token' not described in 'cxl_h_detach_process' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'unit_address' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'op' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'p1' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'p2' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'p3' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'p4' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:207: warning: Function parameter or member 'out' not described in 'cxl_h_control_function' drivers/misc/cxl/hcalls.c:245: warning: Function parameter or member 'unit_address' not described in 'cxl_h_reset_afu' drivers/misc/cxl/hcalls.c:258: warning: Function parameter or member 'unit_address' not described in 'cxl_h_suspend_process' drivers/misc/cxl/hcalls.c:258: warning: Function parameter or member 'process_token' not described in 'cxl_h_suspend_process' drivers/misc/cxl/hcalls.c:271: warning: Function parameter or member 'unit_address' not described in 'cxl_h_resume_process' drivers/misc/cxl/hcalls.c:271: warning: Function parameter or member 'process_token' not described in 'cxl_h_resume_process' drivers/misc/cxl/hcalls.c:284: warning: Function parameter or member 'unit_address' not described in 'cxl_h_read_error_state' drivers/misc/cxl/hcalls.c:284: warning: Function parameter or member 'state' not described in 'cxl_h_read_error_state' drivers/misc/cxl/hcalls.c:300: warning: Function parameter or member 'unit_address' not described in 'cxl_h_get_afu_err' drivers/misc/cxl/hcalls.c:300: warning: Function parameter or member 'offset' not described in 'cxl_h_get_afu_err' drivers/misc/cxl/hcalls.c:300: warning: Function parameter or member 'buf_address' not described in 'cxl_h_get_afu_err' drivers/misc/cxl/hcalls.c:300: warning: Function parameter or member 'len' not described in 'cxl_h_get_afu_err' drivers/misc/cxl/hcalls.c:320: warning: Function parameter or member 'unit_address' not described in 'cxl_h_get_config' drivers/misc/cxl/hcalls.c:320: warning: Function parameter or member 'cr_num' not described in 'cxl_h_get_config' drivers/misc/cxl/hcalls.c:320: warning: Function parameter or member 'offset' not described in 'cxl_h_get_config' drivers/misc/cxl/hcalls.c:320: warning: Function parameter or member 'buf_address' not described in 'cxl_h_get_config' drivers/misc/cxl/hcalls.c:320: warning: Function parameter or member 'len' not described in 'cxl_h_get_config' drivers/misc/cxl/hcalls.c:333: warning: Function parameter or member 'unit_address' not described in 'cxl_h_terminate_process' drivers/misc/cxl/hcalls.c:333: warning: Function parameter or member 'process_token' not described in 'cxl_h_terminate_process' drivers/misc/cxl/hcalls.c:351: warning: Function parameter or member 'unit_address' not described in 'cxl_h_collect_vpd' drivers/misc/cxl/hcalls.c:351: warning: Function parameter or member 'record' not described in 'cxl_h_collect_vpd' drivers/misc/cxl/hcalls.c:351: warning: Function parameter or member 'list_address' not described in 'cxl_h_collect_vpd' drivers/misc/cxl/hcalls.c:351: warning: Function parameter or member 'num' not described in 'cxl_h_collect_vpd' drivers/misc/cxl/hcalls.c:351: warning: Function parameter or member 'out' not described in 'cxl_h_collect_vpd' drivers/misc/cxl/hcalls.c:362: warning: Function parameter or member 'unit_address' not described in 'cxl_h_get_fn_error_interrupt' drivers/misc/cxl/hcalls.c:362: warning: Function parameter or member 'reg' not described in 'cxl_h_get_fn_error_interrupt' drivers/misc/cxl/hcalls.c:374: warning: Function parameter or member 'unit_address' not described in 'cxl_h_ack_fn_error_interrupt' drivers/misc/cxl/hcalls.c:374: warning: Function parameter or member 'value' not described in 'cxl_h_ack_fn_error_interrupt' drivers/misc/cxl/hcalls.c:386: warning: Function parameter or member 'unit_address' not described in 'cxl_h_get_error_log' drivers/misc/cxl/hcalls.c:386: warning: Function parameter or member 'value' not described in 'cxl_h_get_error_log' drivers/misc/cxl/hcalls.c:399: warning: Function parameter or member 'unit_address' not described in 'cxl_h_collect_int_info' drivers/misc/cxl/hcalls.c:399: warning: Function parameter or member 'process_token' not described in 'cxl_h_collect_int_info' drivers/misc/cxl/hcalls.c:399: warning: Function parameter or member 'info' not described in 'cxl_h_collect_int_info' drivers/misc/cxl/hcalls.c:440: warning: Function parameter or member 'unit_address' not described in 'cxl_h_control_faults' drivers/misc/cxl/hcalls.c:440: warning: Function parameter or member 'process_token' not described in 'cxl_h_control_faults' drivers/misc/cxl/hcalls.c:440: warning: Function parameter or member 'control_mask' not described in 'cxl_h_control_faults' drivers/misc/cxl/hcalls.c:440: warning: Function parameter or member 'reset_mask' not described in 'cxl_h_control_faults' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'unit_address' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'op' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'p1' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'p2' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'p3' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'p4' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:480: warning: Function parameter or member 'out' not described in 'cxl_h_control_facility' drivers/misc/cxl/hcalls.c:516: warning: Function parameter or member 'unit_address' not described in 'cxl_h_reset_adapter' drivers/misc/cxl/hcalls.c:532: warning: Function parameter or member 'unit_address' not described in 'cxl_h_collect_vpd_adapter' drivers/misc/cxl/hcalls.c:532: warning: Function parameter or member 'list_address' not described in 'cxl_h_collect_vpd_adapter' drivers/misc/cxl/hcalls.c:532: warning: Function parameter or member 'num' not described in 'cxl_h_collect_vpd_adapter' drivers/misc/cxl/hcalls.c:532: warning: Function parameter or member 'out' not described in 'cxl_h_collect_vpd_adapter' drivers/misc/cxl/hcalls.c:561: warning: Function parameter or member 'unit_address' not described in 'cxl_h_download_facility' drivers/misc/cxl/hcalls.c:561: warning: Function parameter or member 'op' not described in 'cxl_h_download_facility' drivers/misc/cxl/hcalls.c:561: warning: Function parameter or member 'list_address' not described in 'cxl_h_download_facility' drivers/misc/cxl/hcalls.c:561: warning: Function parameter or member 'num' not described in 'cxl_h_download_facility' drivers/misc/cxl/hcalls.c:561: warning: Function parameter or member 'out' not described in 'cxl_h_download_facility' drivers/misc/cxl/hcalls.c:626: warning: Function parameter or member 'unit_address' not described in 'cxl_h_download_adapter_image' drivers/misc/cxl/hcalls.c:626: warning: Function parameter or member 'list_address' not described in 'cxl_h_download_adapter_image' drivers/misc/cxl/hcalls.c:626: warning: Function parameter or member 'num' not described in 'cxl_h_download_adapter_image' drivers/misc/cxl/hcalls.c:626: warning: Function parameter or member 'out' not described in 'cxl_h_download_adapter_image' drivers/misc/cxl/hcalls.c:639: warning: Function parameter or member 'unit_address' not described in 'cxl_h_validate_adapter_image' drivers/misc/cxl/hcalls.c:639: warning: Function parameter or member 'list_address' not described in 'cxl_h_validate_adapter_image' drivers/misc/cxl/hcalls.c:639: warning: Function parameter or member 'num' not described in 'cxl_h_validate_adapter_image' Cc: Frederic Barrat <fbarrat@linux.ibm.com> Cc: Andrew Donnellan <ajd@linux.ibm.com> Cc: linuxppc-dev@lists.ozlabs.org Signed-off-by: Lee Jones <lee.jones@linaro.org> Link: https://lore.kernel.org/r/20200701083118.45744-28-lee.jones@linaro.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Родитель
ff512a8b79
Коммит
b865c5b322
|
@ -167,7 +167,7 @@ long cxl_h_attach_process(u64 unit_address,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_detach_process - Detach a process element from a coherent
|
||||
* platform function.
|
||||
*/
|
||||
|
@ -197,7 +197,7 @@ long cxl_h_detach_process(u64 unit_address, u64 process_token)
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_control_function - This H_CONTROL_CA_FUNCTION hypervisor call allows
|
||||
* the partition to manipulate or query
|
||||
* certain coherent platform function behaviors.
|
||||
|
@ -238,7 +238,7 @@ static long cxl_h_control_function(u64 unit_address, u64 op,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_reset_afu - Perform a reset to the coherent platform function.
|
||||
*/
|
||||
long cxl_h_reset_afu(u64 unit_address)
|
||||
|
@ -249,7 +249,7 @@ long cxl_h_reset_afu(u64 unit_address)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_suspend_process - Suspend a process from being executed
|
||||
* Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when
|
||||
* process was attached.
|
||||
|
@ -262,7 +262,7 @@ long cxl_h_suspend_process(u64 unit_address, u64 process_token)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_resume_process - Resume a process to be executed
|
||||
* Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when
|
||||
* process was attached.
|
||||
|
@ -275,7 +275,7 @@ long cxl_h_resume_process(u64 unit_address, u64 process_token)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_read_error_state - Checks the error state of the coherent
|
||||
* platform function.
|
||||
* R4 contains the error state
|
||||
|
@ -288,7 +288,7 @@ long cxl_h_read_error_state(u64 unit_address, u64 *state)
|
|||
state);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_get_afu_err - collect the AFU error buffer
|
||||
* Parameter1 = byte offset into error buffer to retrieve, valid values
|
||||
* are between 0 and (ibm,error-buffer-size - 1)
|
||||
|
@ -304,7 +304,7 @@ long cxl_h_get_afu_err(u64 unit_address, u64 offset,
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_get_config - collect configuration record for the
|
||||
* coherent platform function
|
||||
* Parameter1 = # of configuration record to retrieve, valid values are
|
||||
|
@ -324,7 +324,7 @@ long cxl_h_get_config(u64 unit_address, u64 cr_num, u64 offset,
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_terminate_process - Terminate the process before completion
|
||||
* Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when
|
||||
* process was attached.
|
||||
|
@ -337,7 +337,7 @@ long cxl_h_terminate_process(u64 unit_address, u64 process_token)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_collect_vpd - Collect VPD for the coherent platform function.
|
||||
* Parameter1 = # of VPD record to retrieve, valid values are between 0
|
||||
* and (ibm,#config-records - 1).
|
||||
|
@ -355,7 +355,7 @@ long cxl_h_collect_vpd(u64 unit_address, u64 record, u64 list_address,
|
|||
out);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_get_fn_error_interrupt - Read the function-wide error data based on an interrupt
|
||||
*/
|
||||
long cxl_h_get_fn_error_interrupt(u64 unit_address, u64 *reg)
|
||||
|
@ -365,7 +365,7 @@ long cxl_h_get_fn_error_interrupt(u64 unit_address, u64 *reg)
|
|||
0, 0, 0, 0, reg);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_ack_fn_error_interrupt - Acknowledge function-wide error data
|
||||
* based on an interrupt
|
||||
* Parameter1 = value to write to the function-wide error interrupt register
|
||||
|
@ -378,7 +378,7 @@ long cxl_h_ack_fn_error_interrupt(u64 unit_address, u64 value)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_get_error_log - Retrieve the Platform Log ID (PLID) of
|
||||
* an error log
|
||||
*/
|
||||
|
@ -390,7 +390,7 @@ long cxl_h_get_error_log(u64 unit_address, u64 value)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_collect_int_info - Collect interrupt info about a coherent
|
||||
* platform function after an interrupt occurred.
|
||||
*/
|
||||
|
@ -425,7 +425,7 @@ long cxl_h_collect_int_info(u64 unit_address, u64 process_token,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_control_faults - Control the operation of a coherent platform
|
||||
* function after a fault occurs.
|
||||
*
|
||||
|
@ -470,7 +470,7 @@ long cxl_h_control_faults(u64 unit_address, u64 process_token,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_control_facility - This H_CONTROL_CA_FACILITY hypervisor call
|
||||
* allows the partition to manipulate or query
|
||||
* certain coherent platform facility behaviors.
|
||||
|
@ -509,7 +509,7 @@ static long cxl_h_control_facility(u64 unit_address, u64 op,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_reset_adapter - Perform a reset to the coherent platform facility.
|
||||
*/
|
||||
long cxl_h_reset_adapter(u64 unit_address)
|
||||
|
@ -520,7 +520,7 @@ long cxl_h_reset_adapter(u64 unit_address)
|
|||
NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_collect_vpd - Collect VPD for the coherent platform function.
|
||||
* Parameter1 = 4K naturally aligned real buffer containing block
|
||||
* list entries
|
||||
|
@ -536,7 +536,7 @@ long cxl_h_collect_vpd_adapter(u64 unit_address, u64 list_address,
|
|||
out);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_download_facility - This H_DOWNLOAD_CA_FACILITY
|
||||
* hypervisor call provide platform support for
|
||||
* downloading a base adapter image to the coherent
|
||||
|
@ -616,7 +616,7 @@ static long cxl_h_download_facility(u64 unit_address, u64 op,
|
|||
}
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_download_adapter_image - Download the base image to the coherent
|
||||
* platform facility.
|
||||
*/
|
||||
|
@ -629,7 +629,7 @@ long cxl_h_download_adapter_image(u64 unit_address,
|
|||
list_address, num, out);
|
||||
}
|
||||
|
||||
/**
|
||||
/*
|
||||
* cxl_h_validate_adapter_image - Validate the base image in the coherent
|
||||
* platform facility.
|
||||
*/
|
||||
|
|
Загрузка…
Ссылка в новой задаче