android/android_kernel_xiaomi_sm8450
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

devlink: fix kdoc

Browse Source 
devlink suffers from a few kdoc warnings:

net/core/devlink.c:5292: warning: Function parameter or member 'dev' not described in 'devlink_register'
net/core/devlink.c:5351: warning: Function parameter or member 'port_index' not described in 'devlink_port_register'
net/core/devlink.c:5753: warning: Function parameter or member 'parent_resource_id' not described in 'devlink_resource_register'
net/core/devlink.c:5753: warning: Function parameter or member 'size_params' not described in 'devlink_resource_register'
net/core/devlink.c:5753: warning: Excess function parameter 'top_hierarchy' description in 'devlink_resource_register'
net/core/devlink.c:5753: warning: Excess function parameter 'reload_required' description in 'devlink_resource_register'
net/core/devlink.c:5753: warning: Excess function parameter 'parent_reosurce_id' description in 'devlink_resource_register'
net/core/devlink.c:6451: warning: Function parameter or member 'region' not described in 'devlink_region_snapshot_create'
net/core/devlink.c:6451: warning: Excess function parameter 'devlink_region' description in 'devlink_region_snapshot_create'

Signed-off-by: Jakub Kicinski <jakub.kicinski@netronome.com>
Acked-by: Jiri Pirko <jiri@mellanox.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Jakub Kicinski
2019-02-27 11:36:36 -08:00
committed by David S. Miller
parent 6ae8762653
commit eeaadd8285
1 changed files with 5 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
net/core/devlink.c
View File

@ -5249,6 +5249,7 @@ EXPORT_SYMBOL_GPL(devlink_alloc);
* devlink_register - Register devlink instance * devlink_register - Register devlink instance
* *
* @devlink: devlink * @devlink: devlink
* @dev: parent device
*/ */
int devlink_register(struct devlink *devlink, struct device *dev) int devlink_register(struct devlink *devlink, struct device *dev)
{ {
@ -5299,7 +5300,7 @@ EXPORT_SYMBOL_GPL(devlink_free);
* *
* @devlink: devlink * @devlink: devlink
* @devlink_port: devlink port * @devlink_port: devlink port
* @port_index * @port_index: driver-specific numerical identifier of the port
* *
* Register devlink port with provided port index. User can use * Register devlink port with provided port index. User can use
* any indexing, even hw-related one. devlink_port structure * any indexing, even hw-related one. devlink_port structure
@ -5629,13 +5630,10 @@ EXPORT_SYMBOL_GPL(devlink_dpipe_table_unregister);
* *
* @devlink: devlink * @devlink: devlink
* @resource_name: resource's name * @resource_name: resource's name
* @top_hierarchy: top hierarchy
* @reload_required: reload is required for new configuration to
* apply
* @resource_size: resource's size * @resource_size: resource's size
* @resource_id: resource's id * @resource_id: resource's id
* @parent_reosurce_id: resource's parent id * @parent_resource_id: resource's parent id
* @size params: size parameters * @size_params: size parameters
*/ */
int devlink_resource_register(struct devlink *devlink, int devlink_resource_register(struct devlink *devlink,
const char *resource_name, const char *resource_name,
@ -6332,7 +6330,7 @@ EXPORT_SYMBOL_GPL(devlink_region_shapshot_id_get);
* Multiple snapshots can be created on a region. * Multiple snapshots can be created on a region.
* The @snapshot_id should be obtained using the getter function. * The @snapshot_id should be obtained using the getter function.
* *
* @devlink_region: devlink region of the snapshot * @region: devlink region of the snapshot
* @data_len: size of snapshot data * @data_len: size of snapshot data
* @data: snapshot data * @data: snapshot data
* @snapshot_id: snapshot id to be created * @snapshot_id: snapshot id to be created