Commit 81929a4a authored by Jesse Brandeburg's avatar Jesse Brandeburg Committed by David S. Miller

drivers/net/ethernet: remove incorrectly formatted doc

As part of the W=1 series for ethernet, these drivers were
discovered to be using kdoc style comments but were not actually
doing kdoc. The kernel uses kdoc style when documenting code, not
doxygen or other styles.

Fixed Warnings:
drivers/net/ethernet/amazon/ena/ena_com.c:613: warning: Function parameter or member 'ena_dev' not described in 'ena_com_set_llq'
drivers/net/ethernet/aquantia/atlantic/hw_atl/hw_atl_b0.c:1540: warning: Cannot understand  * @brief Set VLAN filter table
drivers/net/ethernet/xilinx/ll_temac_main.c:114: warning: Function parameter or member 'lp' not described in 'temac_indirect_busywait'
drivers/net/ethernet/xilinx/ll_temac_main.c:129: warning: Function parameter or member 'lp' not described in 'temac_indirect_in32'
drivers/net/ethernet/xilinx/ll_temac_main.c:129: warning: Function parameter or member 'reg' not described in 'temac_indirect_in32'
drivers/net/ethernet/xilinx/ll_temac_main.c:147: warning: Function parameter or member 'lp' not described in 'temac_indirect_in32_locked'
drivers/net/ethernet/xilinx/ll_temac_main.c:147: warning: Function parameter or member 'reg' not described in 'temac_indirect_in32_locked'
drivers/net/ethernet/xilinx/ll_temac_main.c:172: warning: Function parameter or member 'lp' not described in 'temac_indirect_out32'
drivers/net/ethernet/xilinx/ll_temac_main.c:172: warning: Function parameter or member 'reg' not described in 'temac_indirect_out32'
drivers/net/ethernet/xilinx/ll_temac_main.c:172: warning: Function parameter or member 'value' not described in 'temac_indirect_out32'
drivers/net/ethernet/xilinx/ll_temac_main.c:188: warning: Function parameter or member 'lp' not described in 'temac_indirect_out32_locked'
drivers/net/ethernet/xilinx/ll_temac_main.c:188: warning: Function parameter or member 'reg' not described in 'temac_indirect_out32_locked'
drivers/net/ethernet/xilinx/ll_temac_main.c:188: warning: Function parameter or member 'value' not described in 'temac_indirect_out32_locked'
drivers/net/ethernet/xilinx/ll_temac_main.c:212: warning: Function parameter or member 'lp' not described in 'temac_dma_in32_be'
drivers/net/ethernet/xilinx/ll_temac_main.c:212: warning: Function parameter or member 'reg' not described in 'temac_dma_in32_be'
drivers/net/ethernet/xilinx/ll_temac_main.c:228: warning: Function parameter or member 'lp' not described in 'temac_dma_out32_be'
drivers/net/ethernet/xilinx/ll_temac_main.c:228: warning: Function parameter or member 'reg' not described in 'temac_dma_out32_be'
drivers/net/ethernet/xilinx/ll_temac_main.c:228: warning: Function parameter or member 'value' not described in 'temac_dma_out32_be'
drivers/net/ethernet/xilinx/ll_temac_main.c:247: warning: Function parameter or member 'lp' not described in 'temac_dma_dcr_in'
drivers/net/ethernet/xilinx/ll_temac_main.c:247: warning: Function parameter or member 'reg' not described in 'temac_dma_dcr_in'
drivers/net/ethernet/xilinx/ll_temac_main.c:255: warning: Function parameter or member 'lp' not described in 'temac_dma_dcr_out'
drivers/net/ethernet/xilinx/ll_temac_main.c:255: warning: Function parameter or member 'reg' not described in 'temac_dma_dcr_out'
drivers/net/ethernet/xilinx/ll_temac_main.c:255: warning: Function parameter or member 'value' not described in 'temac_dma_dcr_out'
drivers/net/ethernet/xilinx/ll_temac_main.c:265: warning: Function parameter or member 'lp' not described in 'temac_dcr_setup'
drivers/net/ethernet/xilinx/ll_temac_main.c:265: warning: Function parameter or member 'op' not described in 'temac_dcr_setup'
drivers/net/ethernet/xilinx/ll_temac_main.c:265: warning: Function parameter or member 'np' not described in 'temac_dcr_setup'
drivers/net/ethernet/xilinx/ll_temac_main.c:300: warning: Function parameter or member 'ndev' not described in 'temac_dma_bd_release'
drivers/net/ethernet/xilinx/ll_temac_main.c:330: warning: Function parameter or member 'ndev' not described in 'temac_dma_bd_init'
drivers/net/ethernet/xilinx/ll_temac_main.c:600: warning: Function parameter or member 'ndev' not described in 'temac_setoptions'
drivers/net/ethernet/xilinx/ll_temac_main.c:600: warning: Function parameter or member 'options' not described in 'temac_setoptions'
Signed-off-by: default avatarJesse Brandeburg <jesse.brandeburg@intel.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent f410f157
...@@ -579,7 +579,7 @@ static int ena_com_wait_and_process_admin_cq_polling(struct ena_comp_ctx *comp_c ...@@ -579,7 +579,7 @@ static int ena_com_wait_and_process_admin_cq_polling(struct ena_comp_ctx *comp_c
return ret; return ret;
} }
/** /*
* Set the LLQ configurations of the firmware * Set the LLQ configurations of the firmware
* *
* The driver provides only the enabled feature values to the device, * The driver provides only the enabled feature values to the device,
......
...@@ -1536,7 +1536,7 @@ static int hw_atl_b0_hw_fl2_clear(struct aq_hw_s *self, ...@@ -1536,7 +1536,7 @@ static int hw_atl_b0_hw_fl2_clear(struct aq_hw_s *self,
return aq_hw_err_from_flags(self); return aq_hw_err_from_flags(self);
} }
/** /*
* @brief Set VLAN filter table * @brief Set VLAN filter table
* @details Configure VLAN filter table to accept (and assign the queue) traffic * @details Configure VLAN filter table to accept (and assign the queue) traffic
* for the particular vlan ids. * for the particular vlan ids.
......
...@@ -106,7 +106,7 @@ static bool hard_acs_rdy_or_timeout(struct temac_local *lp, ktime_t timeout) ...@@ -106,7 +106,7 @@ static bool hard_acs_rdy_or_timeout(struct temac_local *lp, ktime_t timeout)
*/ */
#define HARD_ACS_RDY_POLL_NS (20 * NSEC_PER_MSEC) #define HARD_ACS_RDY_POLL_NS (20 * NSEC_PER_MSEC)
/** /*
* temac_indirect_busywait - Wait for current indirect register access * temac_indirect_busywait - Wait for current indirect register access
* to complete. * to complete.
*/ */
...@@ -121,7 +121,7 @@ int temac_indirect_busywait(struct temac_local *lp) ...@@ -121,7 +121,7 @@ int temac_indirect_busywait(struct temac_local *lp)
return 0; return 0;
} }
/** /*
* temac_indirect_in32 - Indirect register read access. This function * temac_indirect_in32 - Indirect register read access. This function
* must be called without lp->indirect_lock being held. * must be called without lp->indirect_lock being held.
*/ */
...@@ -136,7 +136,7 @@ u32 temac_indirect_in32(struct temac_local *lp, int reg) ...@@ -136,7 +136,7 @@ u32 temac_indirect_in32(struct temac_local *lp, int reg)
return val; return val;
} }
/** /*
* temac_indirect_in32_locked - Indirect register read access. This * temac_indirect_in32_locked - Indirect register read access. This
* function must be called with lp->indirect_lock being held. Use * function must be called with lp->indirect_lock being held. Use
* this together with spin_lock_irqsave/spin_lock_irqrestore to avoid * this together with spin_lock_irqsave/spin_lock_irqrestore to avoid
...@@ -164,7 +164,7 @@ u32 temac_indirect_in32_locked(struct temac_local *lp, int reg) ...@@ -164,7 +164,7 @@ u32 temac_indirect_in32_locked(struct temac_local *lp, int reg)
return temac_ior(lp, XTE_LSW0_OFFSET); return temac_ior(lp, XTE_LSW0_OFFSET);
} }
/** /*
* temac_indirect_out32 - Indirect register write access. This function * temac_indirect_out32 - Indirect register write access. This function
* must be called without lp->indirect_lock being held. * must be called without lp->indirect_lock being held.
*/ */
...@@ -177,7 +177,7 @@ void temac_indirect_out32(struct temac_local *lp, int reg, u32 value) ...@@ -177,7 +177,7 @@ void temac_indirect_out32(struct temac_local *lp, int reg, u32 value)
spin_unlock_irqrestore(lp->indirect_lock, flags); spin_unlock_irqrestore(lp->indirect_lock, flags);
} }
/** /*
* temac_indirect_out32_locked - Indirect register write access. This * temac_indirect_out32_locked - Indirect register write access. This
* function must be called with lp->indirect_lock being held. Use * function must be called with lp->indirect_lock being held. Use
* this together with spin_lock_irqsave/spin_lock_irqrestore to avoid * this together with spin_lock_irqsave/spin_lock_irqrestore to avoid
...@@ -202,7 +202,7 @@ void temac_indirect_out32_locked(struct temac_local *lp, int reg, u32 value) ...@@ -202,7 +202,7 @@ void temac_indirect_out32_locked(struct temac_local *lp, int reg, u32 value)
WARN_ON(temac_indirect_busywait(lp)); WARN_ON(temac_indirect_busywait(lp));
} }
/** /*
* temac_dma_in32_* - Memory mapped DMA read, these function expects a * temac_dma_in32_* - Memory mapped DMA read, these function expects a
* register input that is based on DCR word addresses which are then * register input that is based on DCR word addresses which are then
* converted to memory mapped byte addresses. To be assigned to * converted to memory mapped byte addresses. To be assigned to
...@@ -218,7 +218,7 @@ static u32 temac_dma_in32_le(struct temac_local *lp, int reg) ...@@ -218,7 +218,7 @@ static u32 temac_dma_in32_le(struct temac_local *lp, int reg)
return ioread32(lp->sdma_regs + (reg << 2)); return ioread32(lp->sdma_regs + (reg << 2));
} }
/** /*
* temac_dma_out32_* - Memory mapped DMA read, these function expects * temac_dma_out32_* - Memory mapped DMA read, these function expects
* a register input that is based on DCR word addresses which are then * a register input that is based on DCR word addresses which are then
* converted to memory mapped byte addresses. To be assigned to * converted to memory mapped byte addresses. To be assigned to
...@@ -240,7 +240,7 @@ static void temac_dma_out32_le(struct temac_local *lp, int reg, u32 value) ...@@ -240,7 +240,7 @@ static void temac_dma_out32_le(struct temac_local *lp, int reg, u32 value)
*/ */
#ifdef CONFIG_PPC_DCR #ifdef CONFIG_PPC_DCR
/** /*
* temac_dma_dcr_in32 - DCR based DMA read * temac_dma_dcr_in32 - DCR based DMA read
*/ */
static u32 temac_dma_dcr_in(struct temac_local *lp, int reg) static u32 temac_dma_dcr_in(struct temac_local *lp, int reg)
...@@ -248,7 +248,7 @@ static u32 temac_dma_dcr_in(struct temac_local *lp, int reg) ...@@ -248,7 +248,7 @@ static u32 temac_dma_dcr_in(struct temac_local *lp, int reg)
return dcr_read(lp->sdma_dcrs, reg); return dcr_read(lp->sdma_dcrs, reg);
} }
/** /*
* temac_dma_dcr_out32 - DCR based DMA write * temac_dma_dcr_out32 - DCR based DMA write
*/ */
static void temac_dma_dcr_out(struct temac_local *lp, int reg, u32 value) static void temac_dma_dcr_out(struct temac_local *lp, int reg, u32 value)
...@@ -256,7 +256,7 @@ static void temac_dma_dcr_out(struct temac_local *lp, int reg, u32 value) ...@@ -256,7 +256,7 @@ static void temac_dma_dcr_out(struct temac_local *lp, int reg, u32 value)
dcr_write(lp->sdma_dcrs, reg, value); dcr_write(lp->sdma_dcrs, reg, value);
} }
/** /*
* temac_dcr_setup - If the DMA is DCR based, then setup the address and * temac_dcr_setup - If the DMA is DCR based, then setup the address and
* I/O functions * I/O functions
*/ */
...@@ -293,7 +293,7 @@ static int temac_dcr_setup(struct temac_local *lp, struct platform_device *op, ...@@ -293,7 +293,7 @@ static int temac_dcr_setup(struct temac_local *lp, struct platform_device *op,
#endif #endif
/** /*
* temac_dma_bd_release - Release buffer descriptor rings * temac_dma_bd_release - Release buffer descriptor rings
*/ */
static void temac_dma_bd_release(struct net_device *ndev) static void temac_dma_bd_release(struct net_device *ndev)
...@@ -323,7 +323,7 @@ static void temac_dma_bd_release(struct net_device *ndev) ...@@ -323,7 +323,7 @@ static void temac_dma_bd_release(struct net_device *ndev)
lp->tx_bd_v, lp->tx_bd_p); lp->tx_bd_v, lp->tx_bd_p);
} }
/** /*
* temac_dma_bd_init - Setup buffer descriptor rings * temac_dma_bd_init - Setup buffer descriptor rings
*/ */
static int temac_dma_bd_init(struct net_device *ndev) static int temac_dma_bd_init(struct net_device *ndev)
...@@ -593,7 +593,7 @@ static struct temac_option { ...@@ -593,7 +593,7 @@ static struct temac_option {
{} {}
}; };
/** /*
* temac_setoptions * temac_setoptions
*/ */
static u32 temac_setoptions(struct net_device *ndev, u32 options) static u32 temac_setoptions(struct net_device *ndev, u32 options)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment