Commit f0ebc2b6 authored by Jakub Kicinski's avatar Jakub Kicinski Committed by David S. Miller
Browse files

ethtool: un-kdocify extended link state 



Extended link state structures and enums use kdoc headers
but then do not describe any of the members.

Convert to normal comments.

Signed-off-by: default avatarJakub Kicinski <kuba@kernel.org>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 0c85a7e8

include/linux/ethtool.h

+1 −3
Original line number Diff line number Diff line
@@ -87,9 +87,7 @@ u32 ethtool_op_get_link(struct net_device *dev); 
int ethtool_op_get_ts_info(struct net_device *dev, struct ethtool_ts_info *eti);





/**

 * struct ethtool_link_ext_state_info - link extended state and substate.

 */

/* Link extended state and substate. */

struct ethtool_link_ext_state_info {

	enum ethtool_link_ext_state link_ext_state;

	union {

include/uapi/linux/ethtool.h

+6 −20
Original line number Diff line number Diff line
@@ -579,9 +579,7 @@ struct ethtool_pauseparam { 
	__u32	tx_pause;

};



/**

 * enum ethtool_link_ext_state - link extended state

 */

/* Link extended state */

enum ethtool_link_ext_state {

	ETHTOOL_LINK_EXT_STATE_AUTONEG,

	ETHTOOL_LINK_EXT_STATE_LINK_TRAINING_FAILURE,
@@ -595,10 +593,7 @@ enum ethtool_link_ext_state { 
	ETHTOOL_LINK_EXT_STATE_OVERHEAT,

};



/**

 * enum ethtool_link_ext_substate_autoneg - more information in addition to

 * ETHTOOL_LINK_EXT_STATE_AUTONEG.

 */

/* More information in addition to ETHTOOL_LINK_EXT_STATE_AUTONEG. */

enum ethtool_link_ext_substate_autoneg {

	ETHTOOL_LINK_EXT_SUBSTATE_AN_NO_PARTNER_DETECTED = 1,

	ETHTOOL_LINK_EXT_SUBSTATE_AN_ACK_NOT_RECEIVED,
@@ -608,9 +603,7 @@ enum ethtool_link_ext_substate_autoneg { 
	ETHTOOL_LINK_EXT_SUBSTATE_AN_NO_HCD,

};



/**

 * enum ethtool_link_ext_substate_link_training - more information in addition to

 * ETHTOOL_LINK_EXT_STATE_LINK_TRAINING_FAILURE.

/* More information in addition to ETHTOOL_LINK_EXT_STATE_LINK_TRAINING_FAILURE.

 */

enum ethtool_link_ext_substate_link_training {

	ETHTOOL_LINK_EXT_SUBSTATE_LT_KR_FRAME_LOCK_NOT_ACQUIRED = 1,
@@ -619,9 +612,7 @@ enum ethtool_link_ext_substate_link_training { 
	ETHTOOL_LINK_EXT_SUBSTATE_LT_REMOTE_FAULT,

};



/**

 * enum ethtool_link_ext_substate_logical_mismatch - more information in addition

 * to ETHTOOL_LINK_EXT_STATE_LINK_LOGICAL_MISMATCH.

/* More information in addition to ETHTOOL_LINK_EXT_STATE_LINK_LOGICAL_MISMATCH.

 */

enum ethtool_link_ext_substate_link_logical_mismatch {

	ETHTOOL_LINK_EXT_SUBSTATE_LLM_PCS_DID_NOT_ACQUIRE_BLOCK_LOCK = 1,
@@ -631,19 +622,14 @@ enum ethtool_link_ext_substate_link_logical_mismatch { 
	ETHTOOL_LINK_EXT_SUBSTATE_LLM_RS_FEC_IS_NOT_LOCKED,

};



/**

 * enum ethtool_link_ext_substate_bad_signal_integrity - more information in

 * addition to ETHTOOL_LINK_EXT_STATE_BAD_SIGNAL_INTEGRITY.

/* More information in addition to ETHTOOL_LINK_EXT_STATE_BAD_SIGNAL_INTEGRITY.

 */

enum ethtool_link_ext_substate_bad_signal_integrity {

	ETHTOOL_LINK_EXT_SUBSTATE_BSI_LARGE_NUMBER_OF_PHYSICAL_ERRORS = 1,

	ETHTOOL_LINK_EXT_SUBSTATE_BSI_UNSUPPORTED_RATE,

};



/**

 * enum ethtool_link_ext_substate_cable_issue - more information in

 * addition to ETHTOOL_LINK_EXT_STATE_CABLE_ISSUE.

 */

/* More information in addition to ETHTOOL_LINK_EXT_STATE_CABLE_ISSUE. */

enum ethtool_link_ext_substate_cable_issue {

	ETHTOOL_LINK_EXT_SUBSTATE_CI_UNSUPPORTED_CABLE = 1,

	ETHTOOL_LINK_EXT_SUBSTATE_CI_CABLE_TEST_FAILURE,