scsi: ufs: Fix kernel-doc headers
Fix the remaining kernel-doc warnings that are reported when building with W=2. Signed-off-by: Bart Van Assche <bvanassche@acm.org> Link: https://lore.kernel.org/r/20230727194457.3152309-4-bvanassche@acm.org Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
parent
fd4bffb54d
commit
8d8af294ce
|
@ -101,8 +101,7 @@ static void cdns_ufs_set_l4_attr(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* cdns_ufs_set_hclkdiv()
|
||||
* Sets HCLKDIV register value based on the core_clk
|
||||
* cdns_ufs_set_hclkdiv() - set HCLKDIV register value based on the core_clk.
|
||||
* @hba: host controller instance
|
||||
*
|
||||
* Return: zero for success and non-zero for failure.
|
||||
|
@ -143,8 +142,7 @@ static int cdns_ufs_set_hclkdiv(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* cdns_ufs_hce_enable_notify()
|
||||
* Called before and after HCE enable bit is set.
|
||||
* cdns_ufs_hce_enable_notify() - set HCLKDIV register
|
||||
* @hba: host controller instance
|
||||
* @status: notify stage (pre, post change)
|
||||
*
|
||||
|
@ -160,12 +158,10 @@ static int cdns_ufs_hce_enable_notify(struct ufs_hba *hba,
|
|||
}
|
||||
|
||||
/**
|
||||
* cdns_ufs_hibern8_notify()
|
||||
* Called around hibern8 enter/exit.
|
||||
* cdns_ufs_hibern8_notify() - save and restore L4 attributes.
|
||||
* @hba: host controller instance
|
||||
* @cmd: UIC Command
|
||||
* @status: notify stage (pre, post change)
|
||||
*
|
||||
*/
|
||||
static void cdns_ufs_hibern8_notify(struct ufs_hba *hba, enum uic_cmd_dme cmd,
|
||||
enum ufs_notify_change_status status)
|
||||
|
@ -177,8 +173,7 @@ static void cdns_ufs_hibern8_notify(struct ufs_hba *hba, enum uic_cmd_dme cmd,
|
|||
}
|
||||
|
||||
/**
|
||||
* cdns_ufs_link_startup_notify()
|
||||
* Called before and after Link startup is carried out.
|
||||
* cdns_ufs_link_startup_notify() - handle link startup.
|
||||
* @hba: host controller instance
|
||||
* @status: notify stage (pre, post change)
|
||||
*
|
||||
|
|
|
@ -17,8 +17,7 @@
|
|||
#include "tc-dwc-g210.h"
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_setup_40bit_rmmi()
|
||||
* This function configures Synopsys TC specific atributes (40-bit RMMI)
|
||||
* tc_dwc_g210_setup_40bit_rmmi() - configure 40-bit RMMI.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success or non-zero value on failure.
|
||||
|
@ -81,8 +80,7 @@ static int tc_dwc_g210_setup_40bit_rmmi(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_setup_20bit_rmmi_lane0()
|
||||
* This function configures Synopsys TC 20-bit RMMI Lane 0
|
||||
* tc_dwc_g210_setup_20bit_rmmi_lane0() - configure 20-bit RMMI Lane 0.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success or non-zero value on failure.
|
||||
|
@ -134,8 +132,7 @@ static int tc_dwc_g210_setup_20bit_rmmi_lane0(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_setup_20bit_rmmi_lane1()
|
||||
* This function configures Synopsys TC 20-bit RMMI Lane 1
|
||||
* tc_dwc_g210_setup_20bit_rmmi_lane1() - configure 20-bit RMMI Lane 1.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success or non-zero value on failure.
|
||||
|
@ -211,8 +208,7 @@ out:
|
|||
}
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_setup_20bit_rmmi()
|
||||
* This function configures Synopsys TC specific atributes (20-bit RMMI)
|
||||
* tc_dwc_g210_setup_20bit_rmmi() - configure 20-bit RMMI.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success or non-zero value on failure.
|
||||
|
@ -251,9 +247,7 @@ out:
|
|||
}
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_config_40_bit()
|
||||
* This function configures Local (host) Synopsys 40-bit TC specific attributes
|
||||
*
|
||||
* tc_dwc_g210_config_40_bit() - configure 40-bit TC specific attributes.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success non-zero value on failure.
|
||||
|
@ -283,9 +277,7 @@ out:
|
|||
EXPORT_SYMBOL(tc_dwc_g210_config_40_bit);
|
||||
|
||||
/**
|
||||
* tc_dwc_g210_config_20_bit()
|
||||
* This function configures Local (host) Synopsys 20-bit TC specific attributes
|
||||
*
|
||||
* tc_dwc_g210_config_20_bit() - configure 20-bit TC specific attributes.
|
||||
* @hba: Pointer to drivers structure
|
||||
*
|
||||
* Return: 0 on success non-zero value on failure.
|
||||
|
|
|
@ -34,9 +34,7 @@ int ufshcd_dwc_dme_set_attrs(struct ufs_hba *hba,
|
|||
EXPORT_SYMBOL(ufshcd_dwc_dme_set_attrs);
|
||||
|
||||
/**
|
||||
* ufshcd_dwc_program_clk_div()
|
||||
* This function programs the clk divider value. This value is needed to
|
||||
* provide 1 microsecond tick to unipro layer.
|
||||
* ufshcd_dwc_program_clk_div() - program clock divider.
|
||||
* @hba: Private Structure pointer
|
||||
* @divider_val: clock divider value to be programmed
|
||||
*
|
||||
|
@ -47,8 +45,7 @@ static void ufshcd_dwc_program_clk_div(struct ufs_hba *hba, u32 divider_val)
|
|||
}
|
||||
|
||||
/**
|
||||
* ufshcd_dwc_link_is_up()
|
||||
* Check if link is up
|
||||
* ufshcd_dwc_link_is_up() - check if link is up.
|
||||
* @hba: private structure pointer
|
||||
*
|
||||
* Return: 0 on success, non-zero value on failure.
|
||||
|
@ -68,7 +65,9 @@ static int ufshcd_dwc_link_is_up(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* ufshcd_dwc_connection_setup()
|
||||
* ufshcd_dwc_connection_setup() - configure unipro attributes.
|
||||
* @hba: pointer to drivers private data
|
||||
*
|
||||
* This function configures both the local side (host) and the peer side
|
||||
* (device) unipro attributes to establish the connection to application/
|
||||
* cport.
|
||||
|
@ -76,8 +75,6 @@ static int ufshcd_dwc_link_is_up(struct ufs_hba *hba)
|
|||
* have this connection setup on reset. But invoking this function does no
|
||||
* harm and should be fine even working with any ufs device.
|
||||
*
|
||||
* @hba: pointer to drivers private data
|
||||
*
|
||||
* Return: 0 on success non-zero value on failure.
|
||||
*/
|
||||
static int ufshcd_dwc_connection_setup(struct ufs_hba *hba)
|
||||
|
@ -107,8 +104,7 @@ static int ufshcd_dwc_connection_setup(struct ufs_hba *hba)
|
|||
}
|
||||
|
||||
/**
|
||||
* ufshcd_dwc_link_startup_notify()
|
||||
* UFS Host DWC specific link startup sequence
|
||||
* ufshcd_dwc_link_startup_notify() - program clock divider.
|
||||
* @hba: private structure pointer
|
||||
* @status: Callback notify status
|
||||
*
|
||||
|
|
Loading…
Reference in New Issue