Skip to content

L
linux
Commit a54e2a36 authored by Shannon Nelson's avatar Shannon Nelson Committed by Jakub Kicinski
Browse files
Options

ionic: fix up ionic_if.h kernel-doc issues 

All the changes here are whitespace and comments, no code
or definitions changed.  Not all issues were addressed, but
it is much better than it was.  Mostly fixed was a lot
of "Excess union member" and ''rsvd' not described' warnings.
Signed-off-by: default avatarShannon Nelson <shannon.nelson@amd.com>
Link: https://lore.kernel.org/r/20240529000259.25775-8-shannon.nelson@amd.comSigned-off-by: default avatarJakub Kicinski <kuba@kernel.org>
parent 488da004
Show whitespace changes
Inline Side-by-side
Showing with 181 additions and 56 deletions
drivers/net/ethernet/pensando/ionic/ionic_if.h
View file @ a54e2a36
...@@ -71,7 +71,7 @@ enum ionic_cmd_opcode { ...@@ -71,7 +71,7 @@ enum ionic_cmd_opcode {
IONIC_CMD_FW_CONTROL_V1 = 255, IONIC_CMD_FW_CONTROL_V1 = 255,
}; };
/** /*
* enum ionic_status_code - Device command return codes * enum ionic_status_code - Device command return codes
*/ */
enum ionic_status_code { enum ionic_status_code {
...@@ -112,6 +112,7 @@ enum ionic_notifyq_opcode { ...@@ -112,6 +112,7 @@ enum ionic_notifyq_opcode {
/** /**
* struct ionic_admin_cmd - General admin command format * struct ionic_admin_cmd - General admin command format
* @opcode: Opcode for the command * @opcode: Opcode for the command
* @rsvd: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @cmd_data: Opcode-specific command bytes * @cmd_data: Opcode-specific command bytes
*/ */
...@@ -125,6 +126,7 @@ struct ionic_admin_cmd { ...@@ -125,6 +126,7 @@ struct ionic_admin_cmd {
/** /**
* struct ionic_admin_comp - General admin command completion format * struct ionic_admin_comp - General admin command completion format
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @cmd_data: Command-specific bytes * @cmd_data: Command-specific bytes
* @color: Color bit (Always 0 for commands issued to the * @color: Color bit (Always 0 for commands issued to the
...@@ -147,6 +149,7 @@ static inline u8 color_match(u8 color, u8 done_color) ...@@ -147,6 +149,7 @@ static inline u8 color_match(u8 color, u8 done_color)
/** /**
* struct ionic_nop_cmd - NOP command * struct ionic_nop_cmd - NOP command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
*/ */
struct ionic_nop_cmd { struct ionic_nop_cmd {
u8 opcode; u8 opcode;
...@@ -156,6 +159,7 @@ struct ionic_nop_cmd { ...@@ -156,6 +159,7 @@ struct ionic_nop_cmd {
/** /**
* struct ionic_nop_comp - NOP command completion * struct ionic_nop_comp - NOP command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
*/ */
struct ionic_nop_comp { struct ionic_nop_comp {
u8 status; u8 status;
...@@ -166,6 +170,7 @@ struct ionic_nop_comp { ...@@ -166,6 +170,7 @@ struct ionic_nop_comp {
* struct ionic_dev_init_cmd - Device init command * struct ionic_dev_init_cmd - Device init command
* @opcode: opcode * @opcode: opcode
* @type: Device type * @type: Device type
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_init_cmd { struct ionic_dev_init_cmd {
u8 opcode; u8 opcode;
...@@ -176,6 +181,7 @@ struct ionic_dev_init_cmd { ...@@ -176,6 +181,7 @@ struct ionic_dev_init_cmd {
/** /**
* struct ionic_dev_init_comp - Device init command completion * struct ionic_dev_init_comp - Device init command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_init_comp { struct ionic_dev_init_comp {
u8 status; u8 status;
...@@ -185,6 +191,7 @@ struct ionic_dev_init_comp { ...@@ -185,6 +191,7 @@ struct ionic_dev_init_comp {
/** /**
* struct ionic_dev_reset_cmd - Device reset command * struct ionic_dev_reset_cmd - Device reset command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_reset_cmd { struct ionic_dev_reset_cmd {
u8 opcode; u8 opcode;
...@@ -194,6 +201,7 @@ struct ionic_dev_reset_cmd { ...@@ -194,6 +201,7 @@ struct ionic_dev_reset_cmd {
/** /**
* struct ionic_dev_reset_comp - Reset command completion * struct ionic_dev_reset_comp - Reset command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_reset_comp { struct ionic_dev_reset_comp {
u8 status; u8 status;
...@@ -207,6 +215,7 @@ struct ionic_dev_reset_comp { ...@@ -207,6 +215,7 @@ struct ionic_dev_reset_comp {
* struct ionic_dev_identify_cmd - Driver/device identify command * struct ionic_dev_identify_cmd - Driver/device identify command
* @opcode: opcode * @opcode: opcode
* @ver: Highest version of identify supported by driver * @ver: Highest version of identify supported by driver
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_identify_cmd { struct ionic_dev_identify_cmd {
u8 opcode; u8 opcode;
...@@ -218,6 +227,7 @@ struct ionic_dev_identify_cmd { ...@@ -218,6 +227,7 @@ struct ionic_dev_identify_cmd {
* struct ionic_dev_identify_comp - Driver/device identify command completion * struct ionic_dev_identify_comp - Driver/device identify command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @ver: Version of identify returned by device * @ver: Version of identify returned by device
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_identify_comp { struct ionic_dev_identify_comp {
u8 status; u8 status;
...@@ -242,6 +252,7 @@ enum ionic_os_type { ...@@ -242,6 +252,7 @@ enum ionic_os_type {
* @kernel_ver: Kernel version, numeric format * @kernel_ver: Kernel version, numeric format
* @kernel_ver_str: Kernel version, string format * @kernel_ver_str: Kernel version, string format
* @driver_ver_str: Driver version, string format * @driver_ver_str: Driver version, string format
* @words: word access to struct contents
*/ */
union ionic_drv_identity { union ionic_drv_identity {
struct { struct {
...@@ -267,7 +278,9 @@ enum ionic_dev_capability { ...@@ -267,7 +278,9 @@ enum ionic_dev_capability {
* union ionic_dev_identity - device identity information * union ionic_dev_identity - device identity information
* @version: Version of device identify * @version: Version of device identify
* @type: Identify type (0 for now) * @type: Identify type (0 for now)
* @rsvd: reserved byte(s)
* @nports: Number of ports provisioned * @nports: Number of ports provisioned
* @rsvd2: reserved byte(s)
* @nlifs: Number of LIFs provisioned * @nlifs: Number of LIFs provisioned
* @nintrs: Number of interrupts provisioned * @nintrs: Number of interrupts provisioned
* @ndbpgs_per_lif: Number of doorbell pages per LIF * @ndbpgs_per_lif: Number of doorbell pages per LIF
...@@ -284,6 +297,7 @@ enum ionic_dev_capability { ...@@ -284,6 +297,7 @@ enum ionic_dev_capability {
* @hwstamp_mult: Hardware tick to nanosecond multiplier. * @hwstamp_mult: Hardware tick to nanosecond multiplier.
* @hwstamp_shift: Hardware tick to nanosecond divisor (power of two). * @hwstamp_shift: Hardware tick to nanosecond divisor (power of two).
* @capabilities: Device capabilities * @capabilities: Device capabilities
* @words: word access to struct contents
*/ */
union ionic_dev_identity { union ionic_dev_identity {
struct { struct {
...@@ -317,6 +331,7 @@ enum ionic_lif_type { ...@@ -317,6 +331,7 @@ enum ionic_lif_type {
* @opcode: opcode * @opcode: opcode
* @type: LIF type (enum ionic_lif_type) * @type: LIF type (enum ionic_lif_type)
* @ver: Version of identify returned by device * @ver: Version of identify returned by device
* @rsvd: reserved byte(s)
*/ */
struct ionic_lif_identify_cmd { struct ionic_lif_identify_cmd {
u8 opcode; u8 opcode;
...@@ -329,6 +344,7 @@ struct ionic_lif_identify_cmd { ...@@ -329,6 +344,7 @@ struct ionic_lif_identify_cmd {
* struct ionic_lif_identify_comp - LIF identify command completion * struct ionic_lif_identify_comp - LIF identify command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @ver: Version of identify returned by device * @ver: Version of identify returned by device
* @rsvd2: reserved byte(s)
*/ */
struct ionic_lif_identify_comp { struct ionic_lif_identify_comp {
u8 status; u8 status;
...@@ -416,7 +432,7 @@ enum ionic_txq_feature { ...@@ -416,7 +432,7 @@ enum ionic_txq_feature {
}; };
/** /**
* struct ionic_hwstamp_bits - Hardware timestamp decoding bits * enum ionic_hwstamp_bits - Hardware timestamp decoding bits
* @IONIC_HWSTAMP_INVALID: Invalid hardware timestamp value * @IONIC_HWSTAMP_INVALID: Invalid hardware timestamp value
* @IONIC_HWSTAMP_CQ_NEGOFFSET: Timestamp field negative offset * @IONIC_HWSTAMP_CQ_NEGOFFSET: Timestamp field negative offset
* from the base cq descriptor. * from the base cq descriptor.
...@@ -429,6 +445,7 @@ enum ionic_hwstamp_bits { ...@@ -429,6 +445,7 @@ enum ionic_hwstamp_bits {
/** /**
* struct ionic_lif_logical_qtype - Descriptor of logical to HW queue type * struct ionic_lif_logical_qtype - Descriptor of logical to HW queue type
* @qtype: Hardware Queue Type * @qtype: Hardware Queue Type
* @rsvd: reserved byte(s)
* @qid_count: Number of Queue IDs of the logical type * @qid_count: Number of Queue IDs of the logical type
* @qid_base: Minimum Queue ID of the logical type * @qid_base: Minimum Queue ID of the logical type
*/ */
...@@ -454,12 +471,14 @@ enum ionic_lif_state { ...@@ -454,12 +471,14 @@ enum ionic_lif_state {
/** /**
* union ionic_lif_config - LIF configuration * union ionic_lif_config - LIF configuration
* @state: LIF state (enum ionic_lif_state) * @state: LIF state (enum ionic_lif_state)
* @rsvd: reserved byte(s)
* @name: LIF name * @name: LIF name
* @mtu: MTU * @mtu: MTU
* @mac: Station MAC address * @mac: Station MAC address
* @vlan: Default Vlan ID * @vlan: Default Vlan ID
* @features: Features (enum ionic_eth_hw_features) * @features: Features (enum ionic_eth_hw_features)
* @queue_count: Queue counts per queue-type * @queue_count: Queue counts per queue-type
* @words: word access to struct contents
*/ */
union ionic_lif_config { union ionic_lif_config {
struct { struct {
...@@ -481,33 +500,39 @@ union ionic_lif_config { ...@@ -481,33 +500,39 @@ union ionic_lif_config {
* @capabilities: LIF capabilities * @capabilities: LIF capabilities
* *
* @eth: Ethernet identify structure * @eth: Ethernet identify structure
* @version: Ethernet identify structure version * @eth.version: Ethernet identify structure version
* @max_ucast_filters: Number of perfect unicast addresses supported * @eth.rsvd: reserved byte(s)
* @max_mcast_filters: Number of perfect multicast addresses supported * @eth.max_ucast_filters: Number of perfect unicast addresses supported
* @min_frame_size: Minimum size of frames to be sent * @eth.max_mcast_filters: Number of perfect multicast addresses supported
* @max_frame_size: Maximum size of frames to be sent * @eth.min_frame_size: Minimum size of frames to be sent
* @hwstamp_tx_modes: Bitmask of BIT_ULL(enum ionic_txstamp_mode) * @eth.max_frame_size: Maximum size of frames to be sent
* @hwstamp_rx_filters: Bitmask of enum ionic_pkt_class * @eth.rsvd2: reserved byte(s)
* @config: LIF config struct with features, mtu, mac, q counts * @eth.hwstamp_tx_modes: Bitmask of BIT_ULL(enum ionic_txstamp_mode)
* @eth.hwstamp_rx_filters: Bitmask of enum ionic_pkt_class
* @eth.rsvd3: reserved byte(s)
* @eth.config: LIF config struct with features, mtu, mac, q counts
* *
* @rdma: RDMA identify structure * @rdma: RDMA identify structure
* @version: RDMA version of opcodes and queue descriptors * @rdma.version: RDMA version of opcodes and queue descriptors
* @qp_opcodes: Number of RDMA queue pair opcodes supported * @rdma.qp_opcodes: Number of RDMA queue pair opcodes supported
* @admin_opcodes: Number of RDMA admin opcodes supported * @rdma.admin_opcodes: Number of RDMA admin opcodes supported
* @npts_per_lif: Page table size per LIF * @rdma.rsvd: reserved byte(s)
* @nmrs_per_lif: Number of memory regions per LIF * @rdma.npts_per_lif: Page table size per LIF
* @nahs_per_lif: Number of address handles per LIF * @rdma.nmrs_per_lif: Number of memory regions per LIF
* @max_stride: Max work request stride * @rdma.nahs_per_lif: Number of address handles per LIF
* @cl_stride: Cache line stride * @rdma.max_stride: Max work request stride
* @pte_stride: Page table entry stride * @rdma.cl_stride: Cache line stride
* @rrq_stride: Remote RQ work request stride * @rdma.pte_stride: Page table entry stride
* @rsq_stride: Remote SQ work request stride * @rdma.rrq_stride: Remote RQ work request stride
* @dcqcn_profiles: Number of DCQCN profiles * @rdma.rsq_stride: Remote SQ work request stride
* @aq_qtype: RDMA Admin Qtype * @rdma.dcqcn_profiles: Number of DCQCN profiles
* @sq_qtype: RDMA Send Qtype * @rdma.rsvd_dimensions: reserved byte(s)
* @rq_qtype: RDMA Receive Qtype * @rdma.aq_qtype: RDMA Admin Qtype
* @cq_qtype: RDMA Completion Qtype * @rdma.sq_qtype: RDMA Send Qtype
* @eq_qtype: RDMA Event Qtype * @rdma.rq_qtype: RDMA Receive Qtype
* @rdma.cq_qtype: RDMA Completion Qtype
* @rdma.eq_qtype: RDMA Event Qtype
* @words: word access to struct contents
*/ */
union ionic_lif_identity { union ionic_lif_identity {
struct { struct {
...@@ -558,7 +583,9 @@ union ionic_lif_identity { ...@@ -558,7 +583,9 @@ union ionic_lif_identity {
* @opcode: Opcode * @opcode: Opcode
* @type: LIF type (enum ionic_lif_type) * @type: LIF type (enum ionic_lif_type)
* @index: LIF index * @index: LIF index
* @rsvd: reserved byte(s)
* @info_pa: Destination address for LIF info (struct ionic_lif_info) * @info_pa: Destination address for LIF info (struct ionic_lif_info)
* @rsvd2: reserved byte(s)
*/ */
struct ionic_lif_init_cmd { struct ionic_lif_init_cmd {
u8 opcode; u8 opcode;
...@@ -572,7 +599,9 @@ struct ionic_lif_init_cmd { ...@@ -572,7 +599,9 @@ struct ionic_lif_init_cmd {
/** /**
* struct ionic_lif_init_comp - LIF init command completion * struct ionic_lif_init_comp - LIF init command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @hw_index: Hardware index of the initialized LIF * @hw_index: Hardware index of the initialized LIF
* @rsvd2: reserved byte(s)
*/ */
struct ionic_lif_init_comp { struct ionic_lif_init_comp {
u8 status; u8 status;
...@@ -584,9 +613,11 @@ struct ionic_lif_init_comp { ...@@ -584,9 +613,11 @@ struct ionic_lif_init_comp {
/** /**
* struct ionic_q_identify_cmd - queue identify command * struct ionic_q_identify_cmd - queue identify command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @lif_type: LIF type (enum ionic_lif_type) * @lif_type: LIF type (enum ionic_lif_type)
* @type: Logical queue type (enum ionic_logical_qtype) * @type: Logical queue type (enum ionic_logical_qtype)
* @ver: Highest queue type version that the driver supports * @ver: Highest queue type version that the driver supports
* @rsvd2: reserved byte(s)
*/ */
struct ionic_q_identify_cmd { struct ionic_q_identify_cmd {
u8 opcode; u8 opcode;
...@@ -600,8 +631,10 @@ struct ionic_q_identify_cmd { ...@@ -600,8 +631,10 @@ struct ionic_q_identify_cmd {
/** /**
* struct ionic_q_identify_comp - queue identify command completion * struct ionic_q_identify_comp - queue identify command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @ver: Queue type version that can be used with FW * @ver: Queue type version that can be used with FW
* @rsvd2: reserved byte(s)
*/ */
struct ionic_q_identify_comp { struct ionic_q_identify_comp {
u8 status; u8 status;
...@@ -615,12 +648,14 @@ struct ionic_q_identify_comp { ...@@ -615,12 +648,14 @@ struct ionic_q_identify_comp {
* union ionic_q_identity - queue identity information * union ionic_q_identity - queue identity information
* @version: Queue type version that can be used with FW * @version: Queue type version that can be used with FW
* @supported: Bitfield of queue versions, first bit = ver 0 * @supported: Bitfield of queue versions, first bit = ver 0
* @rsvd: reserved byte(s)
* @features: Queue features (enum ionic_q_feature, etc) * @features: Queue features (enum ionic_q_feature, etc)
* @desc_sz: Descriptor size * @desc_sz: Descriptor size
* @comp_sz: Completion descriptor size * @comp_sz: Completion descriptor size
* @sg_desc_sz: Scatter/Gather descriptor size * @sg_desc_sz: Scatter/Gather descriptor size
* @max_sg_elems: Maximum number of Scatter/Gather elements * @max_sg_elems: Maximum number of Scatter/Gather elements
* @sg_desc_stride: Number of Scatter/Gather elements per descriptor * @sg_desc_stride: Number of Scatter/Gather elements per descriptor
* @words: word access to struct contents
*/ */
union ionic_q_identity { union ionic_q_identity {
struct { struct {
...@@ -640,8 +675,10 @@ union ionic_q_identity { ...@@ -640,8 +675,10 @@ union ionic_q_identity {
/** /**
* struct ionic_q_init_cmd - Queue init command * struct ionic_q_init_cmd - Queue init command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @type: Logical queue type * @type: Logical queue type
* @ver: Queue type version * @ver: Queue type version
* @rsvd1: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @index: (LIF, qtype) relative admin queue index * @index: (LIF, qtype) relative admin queue index
* @intr_index: Interrupt control register index, or Event queue index * @intr_index: Interrupt control register index, or Event queue index
...@@ -667,6 +704,7 @@ union ionic_q_identity { ...@@ -667,6 +704,7 @@ union ionic_q_identity {
* @ring_base: Queue ring base address * @ring_base: Queue ring base address
* @cq_ring_base: Completion queue ring base address * @cq_ring_base: Completion queue ring base address
* @sg_ring_base: Scatter/Gather ring base address * @sg_ring_base: Scatter/Gather ring base address
* @rsvd2: reserved byte(s)
* @features: Mask of queue features to enable, if not in the flags above. * @features: Mask of queue features to enable, if not in the flags above.
*/ */
struct ionic_q_init_cmd { struct ionic_q_init_cmd {
...@@ -698,9 +736,11 @@ struct ionic_q_init_cmd { ...@@ -698,9 +736,11 @@ struct ionic_q_init_cmd {
/** /**
* struct ionic_q_init_comp - Queue init command completion * struct ionic_q_init_comp - Queue init command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @hw_index: Hardware Queue ID * @hw_index: Hardware Queue ID
* @hw_type: Hardware Queue type * @hw_type: Hardware Queue type
* @rsvd2: reserved byte(s)
* @color: Color * @color: Color
*/ */
struct ionic_q_init_comp { struct ionic_q_init_comp {
...@@ -800,7 +840,7 @@ enum ionic_txq_desc_opcode { ...@@ -800,7 +840,7 @@ enum ionic_txq_desc_opcode {
* will set CWR flag in the first segment if * will set CWR flag in the first segment if
* CWR is set in the template header, and * CWR is set in the template header, and
* clear CWR in remaining segments. * clear CWR in remaining segments.
* @flags: * flags:
* vlan: * vlan:
* Insert an L2 VLAN header using @vlan_tci * Insert an L2 VLAN header using @vlan_tci
* encap: * encap:
...@@ -813,13 +853,14 @@ enum ionic_txq_desc_opcode { ...@@ -813,13 +853,14 @@ enum ionic_txq_desc_opcode {
* TSO start * TSO start
* tso_eot: * tso_eot:
* TSO end * TSO end
* @num_sg_elems: Number of scatter-gather elements in SG * num_sg_elems: Number of scatter-gather elements in SG
* descriptor * descriptor
* @addr: First data buffer's DMA address * addr: First data buffer's DMA address
* (Subsequent data buffers are on txq_sg_desc) * (Subsequent data buffers are on txq_sg_desc)
* @len: First data buffer's length, in bytes * @len: First data buffer's length, in bytes
* @vlan_tci: VLAN tag to insert in the packet (if requested * @vlan_tci: VLAN tag to insert in the packet (if requested
* by @V-bit). Includes .1p and .1q tags * by @V-bit). Includes .1p and .1q tags
* @hword0: half word padding
* @hdr_len: Length of packet headers, including * @hdr_len: Length of packet headers, including
* encapsulating outer header, if applicable * encapsulating outer header, if applicable
* Valid for opcodes IONIC_TXQ_DESC_OPCODE_CALC_CSUM and * Valid for opcodes IONIC_TXQ_DESC_OPCODE_CALC_CSUM and
...@@ -830,10 +871,12 @@ enum ionic_txq_desc_opcode { ...@@ -830,10 +871,12 @@ enum ionic_txq_desc_opcode {
* IONIC_TXQ_DESC_OPCODE_TSO, @hdr_len is up to * IONIC_TXQ_DESC_OPCODE_TSO, @hdr_len is up to
* inner-most L4 payload, so inclusive of * inner-most L4 payload, so inclusive of
* inner-most L4 header. * inner-most L4 header.
* @hword1: half word padding
* @mss: Desired MSS value for TSO; only applicable for * @mss: Desired MSS value for TSO; only applicable for
* IONIC_TXQ_DESC_OPCODE_TSO * IONIC_TXQ_DESC_OPCODE_TSO
* @csum_start: Offset from packet to first byte checked in L4 checksum * @csum_start: Offset from packet to first byte checked in L4 checksum
* @csum_offset: Offset from csum_start to L4 checksum field * @csum_offset: Offset from csum_start to L4 checksum field
* @hword2: half word padding
*/ */
struct ionic_txq_desc { struct ionic_txq_desc {
__le64 cmd; __le64 cmd;
...@@ -901,6 +944,7 @@ static inline void decode_txq_desc_cmd(u64 cmd, u8 *opcode, u8 *flags, ...@@ -901,6 +944,7 @@ static inline void decode_txq_desc_cmd(u64 cmd, u8 *opcode, u8 *flags,
* struct ionic_txq_sg_elem - Transmit scatter-gather (SG) descriptor element * struct ionic_txq_sg_elem - Transmit scatter-gather (SG) descriptor element
* @addr: DMA address of SG element data buffer * @addr: DMA address of SG element data buffer
* @len: Length of SG element data buffer, in bytes * @len: Length of SG element data buffer, in bytes
* @rsvd: reserved byte(s)
*/ */
struct ionic_txq_sg_elem { struct ionic_txq_sg_elem {
__le64 addr; __le64 addr;
...@@ -927,7 +971,9 @@ struct ionic_txq_sg_desc_v1 { ...@@ -927,7 +971,9 @@ struct ionic_txq_sg_desc_v1 {
/** /**
* struct ionic_txq_comp - Ethernet transmit queue completion descriptor * struct ionic_txq_comp - Ethernet transmit queue completion descriptor
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_txq_comp { struct ionic_txq_comp {
...@@ -953,6 +999,7 @@ enum ionic_rxq_desc_opcode { ...@@ -953,6 +999,7 @@ enum ionic_rxq_desc_opcode {
* receive, including actual bytes received, * receive, including actual bytes received,
* are recorded in Rx completion descriptor. * are recorded in Rx completion descriptor.
* *
* @rsvd: reserved byte(s)
* @len: Data buffer's length, in bytes * @len: Data buffer's length, in bytes
* @addr: Data buffer's DMA address * @addr: Data buffer's DMA address
*/ */
...@@ -967,6 +1014,7 @@ struct ionic_rxq_desc { ...@@ -967,6 +1014,7 @@ struct ionic_rxq_desc {
* struct ionic_rxq_sg_elem - Receive scatter-gather (SG) descriptor element * struct ionic_rxq_sg_elem - Receive scatter-gather (SG) descriptor element
* @addr: DMA address of SG element data buffer * @addr: DMA address of SG element data buffer
* @len: Length of SG element data buffer, in bytes * @len: Length of SG element data buffer, in bytes
* @rsvd: reserved byte(s)
*/ */
struct ionic_rxq_sg_elem { struct ionic_rxq_sg_elem {
__le64 addr; __le64 addr;
...@@ -1170,6 +1218,7 @@ enum ionic_pkt_class { ...@@ -1170,6 +1218,7 @@ enum ionic_pkt_class {
* @lif_index: LIF index * @lif_index: LIF index
* @index: Queue index * @index: Queue index
* @oper: Operation (enum ionic_q_control_oper) * @oper: Operation (enum ionic_q_control_oper)
* @rsvd: reserved byte(s)
*/ */
struct ionic_q_control_cmd { struct ionic_q_control_cmd {
u8 opcode; u8 opcode;
...@@ -1182,7 +1231,7 @@ struct ionic_q_control_cmd { ...@@ -1182,7 +1231,7 @@ struct ionic_q_control_cmd {
typedef struct ionic_admin_comp ionic_q_control_comp; typedef struct ionic_admin_comp ionic_q_control_comp;
enum q_control_oper { enum ionic_q_control_oper {
IONIC_Q_DISABLE = 0, IONIC_Q_DISABLE = 0,
IONIC_Q_ENABLE = 1, IONIC_Q_ENABLE = 1,
IONIC_Q_HANG_RESET = 2, IONIC_Q_HANG_RESET = 2,
...@@ -1216,7 +1265,7 @@ enum ionic_xcvr_state { ...@@ -1216,7 +1265,7 @@ enum ionic_xcvr_state {
IONIC_XCVR_STATE_SPROM_READ_ERR = 4, IONIC_XCVR_STATE_SPROM_READ_ERR = 4,
}; };
/** /*
* enum ionic_xcvr_pid - Supported link modes * enum ionic_xcvr_pid - Supported link modes
*/ */
enum ionic_xcvr_pid { enum ionic_xcvr_pid {
...@@ -1351,6 +1400,7 @@ struct ionic_xcvr_status { ...@@ -1351,6 +1400,7 @@ struct ionic_xcvr_status {
* @fec_type: fec type (enum ionic_port_fec_type) * @fec_type: fec type (enum ionic_port_fec_type)
* @pause_type: pause type (enum ionic_port_pause_type) * @pause_type: pause type (enum ionic_port_pause_type)
* @loopback_mode: loopback mode (enum ionic_port_loopback_mode) * @loopback_mode: loopback mode (enum ionic_port_loopback_mode)
* @words: word access to struct contents
*/ */
union ionic_port_config { union ionic_port_config {
struct { struct {
...@@ -1382,6 +1432,7 @@ union ionic_port_config { ...@@ -1382,6 +1432,7 @@ union ionic_port_config {
* @speed: link speed (in Mbps) * @speed: link speed (in Mbps)
* @link_down_count: number of times link went from up to down * @link_down_count: number of times link went from up to down
* @fec_type: fec type (enum ionic_port_fec_type) * @fec_type: fec type (enum ionic_port_fec_type)
* @rsvd: reserved byte(s)
* @xcvr: transceiver status * @xcvr: transceiver status
*/ */
struct ionic_port_status { struct ionic_port_status {
...@@ -1399,6 +1450,7 @@ struct ionic_port_status { ...@@ -1399,6 +1450,7 @@ struct ionic_port_status {
* @opcode: opcode * @opcode: opcode
* @index: port index * @index: port index
* @ver: Highest version of identify supported by driver * @ver: Highest version of identify supported by driver
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_identify_cmd { struct ionic_port_identify_cmd {
u8 opcode; u8 opcode;
...@@ -1411,6 +1463,7 @@ struct ionic_port_identify_cmd { ...@@ -1411,6 +1463,7 @@ struct ionic_port_identify_cmd {
* struct ionic_port_identify_comp - Port identify command completion * struct ionic_port_identify_comp - Port identify command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @ver: Version of identify returned by device * @ver: Version of identify returned by device
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_identify_comp { struct ionic_port_identify_comp {
u8 status; u8 status;
...@@ -1422,7 +1475,9 @@ struct ionic_port_identify_comp { ...@@ -1422,7 +1475,9 @@ struct ionic_port_identify_comp {
* struct ionic_port_init_cmd - Port initialization command * struct ionic_port_init_cmd - Port initialization command
* @opcode: opcode * @opcode: opcode
* @index: port index * @index: port index
* @rsvd: reserved byte(s)
* @info_pa: destination address for port info (struct ionic_port_info) * @info_pa: destination address for port info (struct ionic_port_info)
* @rsvd2: reserved byte(s)
*/ */
struct ionic_port_init_cmd { struct ionic_port_init_cmd {
u8 opcode; u8 opcode;
...@@ -1435,6 +1490,7 @@ struct ionic_port_init_cmd { ...@@ -1435,6 +1490,7 @@ struct ionic_port_init_cmd {
/** /**
* struct ionic_port_init_comp - Port initialization command completion * struct ionic_port_init_comp - Port initialization command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_init_comp { struct ionic_port_init_comp {
u8 status; u8 status;
...@@ -1445,6 +1501,7 @@ struct ionic_port_init_comp { ...@@ -1445,6 +1501,7 @@ struct ionic_port_init_comp {
* struct ionic_port_reset_cmd - Port reset command * struct ionic_port_reset_cmd - Port reset command
* @opcode: opcode * @opcode: opcode
* @index: port index * @index: port index
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_reset_cmd { struct ionic_port_reset_cmd {
u8 opcode; u8 opcode;
...@@ -1455,6 +1512,7 @@ struct ionic_port_reset_cmd { ...@@ -1455,6 +1512,7 @@ struct ionic_port_reset_cmd {
/** /**
* struct ionic_port_reset_comp - Port reset command completion * struct ionic_port_reset_comp - Port reset command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_reset_comp { struct ionic_port_reset_comp {
u8 status; u8 status;
...@@ -1510,6 +1568,7 @@ enum ionic_port_attr { ...@@ -1510,6 +1568,7 @@ enum ionic_port_attr {
* @opcode: Opcode * @opcode: Opcode
* @index: Port index * @index: Port index
* @attr: Attribute type (enum ionic_port_attr) * @attr: Attribute type (enum ionic_port_attr)
* @rsvd: reserved byte(s)
* @state: Port state * @state: Port state
* @speed: Port speed * @speed: Port speed
* @mtu: Port MTU * @mtu: Port MTU
...@@ -1518,6 +1577,7 @@ enum ionic_port_attr { ...@@ -1518,6 +1577,7 @@ enum ionic_port_attr {
* @pause_type: Port pause type setting * @pause_type: Port pause type setting
* @loopback_mode: Port loopback mode * @loopback_mode: Port loopback mode
* @stats_ctl: Port stats setting * @stats_ctl: Port stats setting
* @rsvd2: reserved byte(s)
*/ */
struct ionic_port_setattr_cmd { struct ionic_port_setattr_cmd {
u8 opcode; u8 opcode;
...@@ -1540,6 +1600,7 @@ struct ionic_port_setattr_cmd { ...@@ -1540,6 +1600,7 @@ struct ionic_port_setattr_cmd {
/** /**
* struct ionic_port_setattr_comp - Port set attr command completion * struct ionic_port_setattr_comp - Port set attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_port_setattr_comp { struct ionic_port_setattr_comp {
...@@ -1553,6 +1614,7 @@ struct ionic_port_setattr_comp { ...@@ -1553,6 +1614,7 @@ struct ionic_port_setattr_comp {
* @opcode: Opcode * @opcode: Opcode
* @index: port index * @index: port index
* @attr: Attribute type (enum ionic_port_attr) * @attr: Attribute type (enum ionic_port_attr)
* @rsvd: reserved byte(s)
*/ */
struct ionic_port_getattr_cmd { struct ionic_port_getattr_cmd {
u8 opcode; u8 opcode;
...@@ -1564,6 +1626,7 @@ struct ionic_port_getattr_cmd { ...@@ -1564,6 +1626,7 @@ struct ionic_port_getattr_cmd {
/** /**
* struct ionic_port_getattr_comp - Port get attr command completion * struct ionic_port_getattr_comp - Port get attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @state: Port state * @state: Port state
* @speed: Port speed * @speed: Port speed
* @mtu: Port MTU * @mtu: Port MTU
...@@ -1571,6 +1634,7 @@ struct ionic_port_getattr_cmd { ...@@ -1571,6 +1634,7 @@ struct ionic_port_getattr_cmd {
* @fec_type: Port FEC type setting * @fec_type: Port FEC type setting
* @pause_type: Port pause type setting * @pause_type: Port pause type setting
* @loopback_mode: Port loopback mode * @loopback_mode: Port loopback mode
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_port_getattr_comp { struct ionic_port_getattr_comp {
...@@ -1593,9 +1657,11 @@ struct ionic_port_getattr_comp { ...@@ -1593,9 +1657,11 @@ struct ionic_port_getattr_comp {
* struct ionic_lif_status - LIF status register * struct ionic_lif_status - LIF status register
* @eid: most recent NotifyQ event id * @eid: most recent NotifyQ event id
* @port_num: port the LIF is connected to * @port_num: port the LIF is connected to
* @rsvd: reserved byte(s)
* @link_status: port status (enum ionic_port_oper_status) * @link_status: port status (enum ionic_port_oper_status)
* @link_speed: speed of link in Mbps * @link_speed: speed of link in Mbps
* @link_down_count: number of times link went from up to down * @link_down_count: number of times link went from up to down
* @rsvd2: reserved byte(s)
*/ */
struct ionic_lif_status { struct ionic_lif_status {
__le64 eid; __le64 eid;
...@@ -1610,7 +1676,9 @@ struct ionic_lif_status { ...@@ -1610,7 +1676,9 @@ struct ionic_lif_status {
/** /**
* struct ionic_lif_reset_cmd - LIF reset command * struct ionic_lif_reset_cmd - LIF reset command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @index: LIF index * @index: LIF index
* @rsvd2: reserved byte(s)
*/ */
struct ionic_lif_reset_cmd { struct ionic_lif_reset_cmd {
u8 opcode; u8 opcode;
...@@ -1643,9 +1711,11 @@ enum ionic_dev_attr { ...@@ -1643,9 +1711,11 @@ enum ionic_dev_attr {
* struct ionic_dev_setattr_cmd - Set Device attributes on the NIC * struct ionic_dev_setattr_cmd - Set Device attributes on the NIC
* @opcode: Opcode * @opcode: Opcode
* @attr: Attribute type (enum ionic_dev_attr) * @attr: Attribute type (enum ionic_dev_attr)
* @rsvd: reserved byte(s)
* @state: Device state (enum ionic_dev_state) * @state: Device state (enum ionic_dev_state)
* @name: The bus info, e.g. PCI slot-device-function, 0 terminated * @name: The bus info, e.g. PCI slot-device-function, 0 terminated
* @features: Device features * @features: Device features
* @rsvd2: reserved byte(s)
*/ */
struct ionic_dev_setattr_cmd { struct ionic_dev_setattr_cmd {
u8 opcode; u8 opcode;
...@@ -1662,7 +1732,9 @@ struct ionic_dev_setattr_cmd { ...@@ -1662,7 +1732,9 @@ struct ionic_dev_setattr_cmd {
/** /**
* struct ionic_dev_setattr_comp - Device set attr command completion * struct ionic_dev_setattr_comp - Device set attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @features: Device features * @features: Device features
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_dev_setattr_comp { struct ionic_dev_setattr_comp {
...@@ -1679,6 +1751,7 @@ struct ionic_dev_setattr_comp { ...@@ -1679,6 +1751,7 @@ struct ionic_dev_setattr_comp {
* struct ionic_dev_getattr_cmd - Get Device attributes from the NIC * struct ionic_dev_getattr_cmd - Get Device attributes from the NIC
* @opcode: opcode * @opcode: opcode
* @attr: Attribute type (enum ionic_dev_attr) * @attr: Attribute type (enum ionic_dev_attr)
* @rsvd: reserved byte(s)
*/ */
struct ionic_dev_getattr_cmd { struct ionic_dev_getattr_cmd {
u8 opcode; u8 opcode;
...@@ -1687,9 +1760,11 @@ struct ionic_dev_getattr_cmd { ...@@ -1687,9 +1760,11 @@ struct ionic_dev_getattr_cmd {
}; };
/** /**
* struct ionic_dev_setattr_comp - Device set attr command completion * struct ionic_dev_getattr_comp - Device set attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @features: Device features * @features: Device features
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_dev_getattr_comp { struct ionic_dev_getattr_comp {
...@@ -1702,7 +1777,7 @@ struct ionic_dev_getattr_comp { ...@@ -1702,7 +1777,7 @@ struct ionic_dev_getattr_comp {
u8 color; u8 color;
}; };
/** /*
* RSS parameters * RSS parameters
*/ */
#define IONIC_RSS_HASH_KEY_SIZE 40 #define IONIC_RSS_HASH_KEY_SIZE 40
...@@ -1726,6 +1801,7 @@ enum ionic_rss_hash_types { ...@@ -1726,6 +1801,7 @@ enum ionic_rss_hash_types {
* @IONIC_LIF_ATTR_RSS: LIF RSS attribute * @IONIC_LIF_ATTR_RSS: LIF RSS attribute
* @IONIC_LIF_ATTR_STATS_CTRL: LIF statistics control attribute * @IONIC_LIF_ATTR_STATS_CTRL: LIF statistics control attribute
* @IONIC_LIF_ATTR_TXSTAMP: LIF TX timestamping mode * @IONIC_LIF_ATTR_TXSTAMP: LIF TX timestamping mode
* @IONIC_LIF_ATTR_MAX: maximum attribute value
*/ */
enum ionic_lif_attr { enum ionic_lif_attr {
IONIC_LIF_ATTR_STATE = 0, IONIC_LIF_ATTR_STATE = 0,
...@@ -1736,6 +1812,7 @@ enum ionic_lif_attr { ...@@ -1736,6 +1812,7 @@ enum ionic_lif_attr {
IONIC_LIF_ATTR_RSS = 5, IONIC_LIF_ATTR_RSS = 5,
IONIC_LIF_ATTR_STATS_CTRL = 6, IONIC_LIF_ATTR_STATS_CTRL = 6,
IONIC_LIF_ATTR_TXSTAMP = 7, IONIC_LIF_ATTR_TXSTAMP = 7,
IONIC_LIF_ATTR_MAX = 255,
}; };
/** /**
...@@ -1749,11 +1826,13 @@ enum ionic_lif_attr { ...@@ -1749,11 +1826,13 @@ enum ionic_lif_attr {
* @mac: Station mac * @mac: Station mac
* @features: Features (enum ionic_eth_hw_features) * @features: Features (enum ionic_eth_hw_features)
* @rss: RSS properties * @rss: RSS properties
* @types: The hash types to enable (see rss_hash_types) * @rss.types: The hash types to enable (see rss_hash_types)
* @key: The hash secret key * @rss.key: The hash secret key
* @addr: Address for the indirection table shared memory * @rss.rsvd: reserved byte(s)
* @rss.addr: Address for the indirection table shared memory
* @stats_ctl: stats control commands (enum ionic_stats_ctl_cmd) * @stats_ctl: stats control commands (enum ionic_stats_ctl_cmd)
* @txstamp: TX Timestamping Mode (enum ionic_txstamp_mode) * @txstamp_mode: TX Timestamping Mode (enum ionic_txstamp_mode)
* @rsvd: reserved byte(s)
*/ */
struct ionic_lif_setattr_cmd { struct ionic_lif_setattr_cmd {
u8 opcode; u8 opcode;
...@@ -1780,8 +1859,10 @@ struct ionic_lif_setattr_cmd { ...@@ -1780,8 +1859,10 @@ struct ionic_lif_setattr_cmd {
/** /**
* struct ionic_lif_setattr_comp - LIF set attr command completion * struct ionic_lif_setattr_comp - LIF set attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @features: features (enum ionic_eth_hw_features) * @features: features (enum ionic_eth_hw_features)
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_lif_setattr_comp { struct ionic_lif_setattr_comp {
...@@ -1800,6 +1881,7 @@ struct ionic_lif_setattr_comp { ...@@ -1800,6 +1881,7 @@ struct ionic_lif_setattr_comp {
* @opcode: Opcode * @opcode: Opcode
* @attr: Attribute type (enum ionic_lif_attr) * @attr: Attribute type (enum ionic_lif_attr)
* @index: LIF index * @index: LIF index
* @rsvd: reserved byte(s)
*/ */
struct ionic_lif_getattr_cmd { struct ionic_lif_getattr_cmd {
u8 opcode; u8 opcode;
...@@ -1811,13 +1893,14 @@ struct ionic_lif_getattr_cmd { ...@@ -1811,13 +1893,14 @@ struct ionic_lif_getattr_cmd {
/** /**
* struct ionic_lif_getattr_comp - LIF get attr command completion * struct ionic_lif_getattr_comp - LIF get attr command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @state: LIF state (enum ionic_lif_state) * @state: LIF state (enum ionic_lif_state)
* @name: The netdev name string, 0 terminated
* @mtu: Mtu * @mtu: Mtu
* @mac: Station mac * @mac: Station mac
* @features: Features (enum ionic_eth_hw_features) * @features: Features (enum ionic_eth_hw_features)
* @txstamp: TX Timestamping Mode (enum ionic_txstamp_mode) * @txstamp_mode: TX Timestamping Mode (enum ionic_txstamp_mode)
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_lif_getattr_comp { struct ionic_lif_getattr_comp {
...@@ -1838,12 +1921,15 @@ struct ionic_lif_getattr_comp { ...@@ -1838,12 +1921,15 @@ struct ionic_lif_getattr_comp {
/** /**
* struct ionic_lif_setphc_cmd - Set LIF PTP Hardware Clock * struct ionic_lif_setphc_cmd - Set LIF PTP Hardware Clock
* @opcode: Opcode * @opcode: Opcode
* @rsvd1: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @rsvd2: reserved byte(s)
* @tick: Hardware stamp tick of an instant in time. * @tick: Hardware stamp tick of an instant in time.
* @nsec: Nanosecond stamp of the same instant. * @nsec: Nanosecond stamp of the same instant.
* @frac: Fractional nanoseconds at the same instant. * @frac: Fractional nanoseconds at the same instant.
* @mult: Cycle to nanosecond multiplier. * @mult: Cycle to nanosecond multiplier.
* @shift: Cycle to nanosecond divisor (power of two). * @shift: Cycle to nanosecond divisor (power of two).
* @rsvd3: reserved byte(s)
*/ */
struct ionic_lif_setphc_cmd { struct ionic_lif_setphc_cmd {
u8 opcode; u8 opcode;
...@@ -1870,6 +1956,7 @@ enum ionic_rx_mode { ...@@ -1870,6 +1956,7 @@ enum ionic_rx_mode {
/** /**
* struct ionic_rx_mode_set_cmd - Set LIF's Rx mode command * struct ionic_rx_mode_set_cmd - Set LIF's Rx mode command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @rx_mode: Rx mode flags: * @rx_mode: Rx mode flags:
* IONIC_RX_MODE_F_UNICAST: Accept known unicast packets * IONIC_RX_MODE_F_UNICAST: Accept known unicast packets
...@@ -1878,6 +1965,7 @@ enum ionic_rx_mode { ...@@ -1878,6 +1965,7 @@ enum ionic_rx_mode {
* IONIC_RX_MODE_F_PROMISC: Accept any packets * IONIC_RX_MODE_F_PROMISC: Accept any packets
* IONIC_RX_MODE_F_ALLMULTI: Accept any multicast packets * IONIC_RX_MODE_F_ALLMULTI: Accept any multicast packets
* IONIC_RX_MODE_F_RDMA_SNIFFER: Sniff RDMA packets * IONIC_RX_MODE_F_RDMA_SNIFFER: Sniff RDMA packets
* @rsvd2: reserved byte(s)
*/ */
struct ionic_rx_mode_set_cmd { struct ionic_rx_mode_set_cmd {
u8 opcode; u8 opcode;
...@@ -1904,13 +1992,14 @@ enum ionic_rx_filter_match_type { ...@@ -1904,13 +1992,14 @@ enum ionic_rx_filter_match_type {
* @qid: Queue ID * @qid: Queue ID
* @match: Rx filter match type (see IONIC_RX_FILTER_MATCH_xxx) * @match: Rx filter match type (see IONIC_RX_FILTER_MATCH_xxx)
* @vlan: VLAN filter * @vlan: VLAN filter
* @vlan: VLAN ID * @vlan.vlan: VLAN ID
* @mac: MAC filter * @mac: MAC filter
* @addr: MAC address (network-byte order) * @mac.addr: MAC address (network-byte order)
* @mac_vlan: MACVLAN filter * @mac_vlan: MACVLAN filter
* @vlan: VLAN ID * @mac_vlan.vlan: VLAN ID
* @addr: MAC address (network-byte order) * @mac_vlan.addr: MAC address (network-byte order)
* @pkt_class: Packet classification filter * @pkt_class: Packet classification filter
* @rsvd: reserved byte(s)
*/ */
struct ionic_rx_filter_add_cmd { struct ionic_rx_filter_add_cmd {
u8 opcode; u8 opcode;
...@@ -1937,8 +2026,10 @@ struct ionic_rx_filter_add_cmd { ...@@ -1937,8 +2026,10 @@ struct ionic_rx_filter_add_cmd {
/** /**
* struct ionic_rx_filter_add_comp - Add LIF Rx filter command completion * struct ionic_rx_filter_add_comp - Add LIF Rx filter command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @filter_id: Filter ID * @filter_id: Filter ID
* @rsvd2: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_rx_filter_add_comp { struct ionic_rx_filter_add_comp {
...@@ -1953,8 +2044,10 @@ struct ionic_rx_filter_add_comp { ...@@ -1953,8 +2044,10 @@ struct ionic_rx_filter_add_comp {
/** /**
* struct ionic_rx_filter_del_cmd - Delete LIF Rx filter command * struct ionic_rx_filter_del_cmd - Delete LIF Rx filter command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @filter_id: Filter ID * @filter_id: Filter ID
* @rsvd2: reserved byte(s)
*/ */
struct ionic_rx_filter_del_cmd { struct ionic_rx_filter_del_cmd {
u8 opcode; u8 opcode;
...@@ -2000,6 +2093,7 @@ enum ionic_vf_link_status { ...@@ -2000,6 +2093,7 @@ enum ionic_vf_link_status {
* @trust: enable VF trust * @trust: enable VF trust
* @linkstate: set link up or down * @linkstate: set link up or down
* @stats_pa: set DMA address for VF stats * @stats_pa: set DMA address for VF stats
* @pad: reserved byte(s)
*/ */
struct ionic_vf_setattr_cmd { struct ionic_vf_setattr_cmd {
u8 opcode; u8 opcode;
...@@ -2031,6 +2125,7 @@ struct ionic_vf_setattr_comp { ...@@ -2031,6 +2125,7 @@ struct ionic_vf_setattr_comp {
* @opcode: Opcode * @opcode: Opcode
* @attr: Attribute type (enum ionic_vf_attr) * @attr: Attribute type (enum ionic_vf_attr)
* @vf_index: VF index * @vf_index: VF index
* @rsvd: reserved byte(s)
*/ */
struct ionic_vf_getattr_cmd { struct ionic_vf_getattr_cmd {
u8 opcode; u8 opcode;
...@@ -2064,8 +2159,8 @@ enum ionic_vf_ctrl_opcode { ...@@ -2064,8 +2159,8 @@ enum ionic_vf_ctrl_opcode {
/** /**
* struct ionic_vf_ctrl_cmd - VF control command * struct ionic_vf_ctrl_cmd - VF control command
* @opcode: Opcode for the command * @opcode: Opcode for the command
* @vf_index: VF Index. It is unused if op START_ALL is used.
* @ctrl_opcode: VF control operation type * @ctrl_opcode: VF control operation type
* @vf_index: VF Index. It is unused if op START_ALL is used.
*/ */
struct ionic_vf_ctrl_cmd { struct ionic_vf_ctrl_cmd {
u8 opcode; u8 opcode;
...@@ -2089,7 +2184,7 @@ struct ionic_vf_ctrl_comp { ...@@ -2089,7 +2184,7 @@ struct ionic_vf_ctrl_comp {
* struct ionic_qos_identify_cmd - QoS identify command * struct ionic_qos_identify_cmd - QoS identify command
* @opcode: opcode * @opcode: opcode
* @ver: Highest version of identify supported by driver * @ver: Highest version of identify supported by driver
* * @rsvd: reserved byte(s)
*/ */
struct ionic_qos_identify_cmd { struct ionic_qos_identify_cmd {
u8 opcode; u8 opcode;
...@@ -2101,6 +2196,7 @@ struct ionic_qos_identify_cmd { ...@@ -2101,6 +2196,7 @@ struct ionic_qos_identify_cmd {
* struct ionic_qos_identify_comp - QoS identify command completion * struct ionic_qos_identify_comp - QoS identify command completion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @ver: Version of identify returned by device * @ver: Version of identify returned by device
* @rsvd: reserved byte(s)
*/ */
struct ionic_qos_identify_comp { struct ionic_qos_identify_comp {
u8 status; u8 status;
...@@ -2118,7 +2214,7 @@ struct ionic_qos_identify_comp { ...@@ -2118,7 +2214,7 @@ struct ionic_qos_identify_comp {
#define IONIC_QOS_ALL_PCP 0xFF #define IONIC_QOS_ALL_PCP 0xFF
#define IONIC_DSCP_BLOCK_SIZE 8 #define IONIC_DSCP_BLOCK_SIZE 8
/** /*
* enum ionic_qos_class * enum ionic_qos_class
*/ */
enum ionic_qos_class { enum ionic_qos_class {
...@@ -2174,6 +2270,7 @@ enum ionic_qos_sched_type { ...@@ -2174,6 +2270,7 @@ enum ionic_qos_sched_type {
* @dot1q_pcp: Dot1q pcp value * @dot1q_pcp: Dot1q pcp value
* @ndscp: Number of valid dscp values in the ip_dscp field * @ndscp: Number of valid dscp values in the ip_dscp field
* @ip_dscp: IP dscp values * @ip_dscp: IP dscp values
* @words: word access to struct contents
*/ */
union ionic_qos_config { union ionic_qos_config {
struct { struct {
...@@ -2219,8 +2316,9 @@ union ionic_qos_config { ...@@ -2219,8 +2316,9 @@ union ionic_qos_config {
* union ionic_qos_identity - QoS identity structure * union ionic_qos_identity - QoS identity structure
* @version: Version of the identify structure * @version: Version of the identify structure
* @type: QoS system type * @type: QoS system type
* @nclasses: Number of usable QoS classes * @rsvd: reserved byte(s)
* @config: Current configuration of classes * @config: Current configuration of classes
* @words: word access to struct contents
*/ */
union ionic_qos_identity { union ionic_qos_identity {
struct { struct {
...@@ -2236,7 +2334,9 @@ union ionic_qos_identity { ...@@ -2236,7 +2334,9 @@ union ionic_qos_identity {
* struct ionic_qos_init_cmd - QoS config init command * struct ionic_qos_init_cmd - QoS config init command
* @opcode: Opcode * @opcode: Opcode
* @group: QoS class id * @group: QoS class id
* @rsvd: reserved byte(s)
* @info_pa: destination address for qos info * @info_pa: destination address for qos info
* @rsvd1: reserved byte(s)
*/ */
struct ionic_qos_init_cmd { struct ionic_qos_init_cmd {
u8 opcode; u8 opcode;
...@@ -2252,6 +2352,7 @@ typedef struct ionic_admin_comp ionic_qos_init_comp; ...@@ -2252,6 +2352,7 @@ typedef struct ionic_admin_comp ionic_qos_init_comp;
* struct ionic_qos_reset_cmd - QoS config reset command * struct ionic_qos_reset_cmd - QoS config reset command
* @opcode: Opcode * @opcode: Opcode
* @group: QoS class id * @group: QoS class id
* @rsvd: reserved byte(s)
*/ */
struct ionic_qos_reset_cmd { struct ionic_qos_reset_cmd {
u8 opcode; u8 opcode;
...@@ -2260,8 +2361,10 @@ struct ionic_qos_reset_cmd { ...@@ -2260,8 +2361,10 @@ struct ionic_qos_reset_cmd {
}; };
/** /**
* struct ionic_qos_clear_port_stats_cmd - Qos config reset command * struct ionic_qos_clear_stats_cmd - Qos config reset command
* @opcode: Opcode * @opcode: Opcode
* @group_bitmap: bitmap of groups to be cleared
* @rsvd: reserved byte(s)
*/ */
struct ionic_qos_clear_stats_cmd { struct ionic_qos_clear_stats_cmd {
u8 opcode; u8 opcode;
...@@ -2274,6 +2377,7 @@ typedef struct ionic_admin_comp ionic_qos_reset_comp; ...@@ -2274,6 +2377,7 @@ typedef struct ionic_admin_comp ionic_qos_reset_comp;
/** /**
* struct ionic_fw_download_cmd - Firmware download command * struct ionic_fw_download_cmd - Firmware download command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @addr: dma address of the firmware buffer * @addr: dma address of the firmware buffer
* @offset: offset of the firmware buffer within the full image * @offset: offset of the firmware buffer within the full image
* @length: number of valid bytes in the firmware buffer * @length: number of valid bytes in the firmware buffer
...@@ -2297,6 +2401,7 @@ typedef struct ionic_admin_comp ionic_fw_download_comp; ...@@ -2297,6 +2401,7 @@ typedef struct ionic_admin_comp ionic_fw_download_comp;
* @IONIC_FW_INSTALL_STATUS: Firmware installation status * @IONIC_FW_INSTALL_STATUS: Firmware installation status
* @IONIC_FW_ACTIVATE_ASYNC: Activate firmware asynchronously * @IONIC_FW_ACTIVATE_ASYNC: Activate firmware asynchronously
* @IONIC_FW_ACTIVATE_STATUS: Firmware activate status * @IONIC_FW_ACTIVATE_STATUS: Firmware activate status
* @IONIC_FW_UPDATE_CLEANUP: Clean up after an interrupted fw update
*/ */
enum ionic_fw_control_oper { enum ionic_fw_control_oper {
IONIC_FW_RESET = 0, IONIC_FW_RESET = 0,
...@@ -2312,8 +2417,10 @@ enum ionic_fw_control_oper { ...@@ -2312,8 +2417,10 @@ enum ionic_fw_control_oper {
/** /**
* struct ionic_fw_control_cmd - Firmware control command * struct ionic_fw_control_cmd - Firmware control command
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @oper: firmware control operation (enum ionic_fw_control_oper) * @oper: firmware control operation (enum ionic_fw_control_oper)
* @slot: slot to activate * @slot: slot to activate
* @rsvd1: reserved byte(s)
*/ */
struct ionic_fw_control_cmd { struct ionic_fw_control_cmd {
u8 opcode; u8 opcode;
...@@ -2326,8 +2433,10 @@ struct ionic_fw_control_cmd { ...@@ -2326,8 +2433,10 @@ struct ionic_fw_control_cmd {
/** /**
* struct ionic_fw_control_comp - Firmware control copletion * struct ionic_fw_control_comp - Firmware control copletion
* @status: Status of the command (enum ionic_status_code) * @status: Status of the command (enum ionic_status_code)
* @rsvd: reserved byte(s)
* @comp_index: Index in the descriptor ring for which this is the completion * @comp_index: Index in the descriptor ring for which this is the completion
* @slot: Slot where the firmware was installed * @slot: Slot where the firmware was installed
* @rsvd1: reserved byte(s)
* @color: Color bit * @color: Color bit
*/ */
struct ionic_fw_control_comp { struct ionic_fw_control_comp {
...@@ -2346,7 +2455,9 @@ struct ionic_fw_control_comp { ...@@ -2346,7 +2455,9 @@ struct ionic_fw_control_comp {
/** /**
* struct ionic_rdma_reset_cmd - Reset RDMA LIF cmd * struct ionic_rdma_reset_cmd - Reset RDMA LIF cmd
* @opcode: opcode * @opcode: opcode
* @rsvd: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @rsvd2: reserved byte(s)
* *
* There is no RDMA specific dev command completion struct. Completion uses * There is no RDMA specific dev command completion struct. Completion uses
* the common struct ionic_admin_comp. Only the status is indicated. * the common struct ionic_admin_comp. Only the status is indicated.
...@@ -2362,6 +2473,7 @@ struct ionic_rdma_reset_cmd { ...@@ -2362,6 +2473,7 @@ struct ionic_rdma_reset_cmd {
/** /**
* struct ionic_rdma_queue_cmd - Create RDMA Queue command * struct ionic_rdma_queue_cmd - Create RDMA Queue command
* @opcode: opcode, 52, 53 * @opcode: opcode, 52, 53
* @rsvd: reserved byte(s)
* @lif_index: LIF index * @lif_index: LIF index
* @qid_ver: (qid | (RDMA version << 24)) * @qid_ver: (qid | (RDMA version << 24))
* @cid: intr, eq_id, or cq_id * @cid: intr, eq_id, or cq_id
...@@ -2369,6 +2481,7 @@ struct ionic_rdma_reset_cmd { ...@@ -2369,6 +2481,7 @@ struct ionic_rdma_reset_cmd {
* @depth_log2: log base two of queue depth * @depth_log2: log base two of queue depth
* @stride_log2: log base two of queue stride * @stride_log2: log base two of queue stride
* @dma_addr: address of the queue memory * @dma_addr: address of the queue memory
* @rsvd2: reserved byte(s)
* *
* The same command struct is used to create an RDMA event queue, completion * The same command struct is used to create an RDMA event queue, completion
* queue, or RDMA admin queue. The cid is an interrupt number for an event * queue, or RDMA admin queue. The cid is an interrupt number for an event
...@@ -2425,6 +2538,7 @@ struct ionic_notifyq_event { ...@@ -2425,6 +2538,7 @@ struct ionic_notifyq_event {
* @ecode: event code = IONIC_EVENT_LINK_CHANGE * @ecode: event code = IONIC_EVENT_LINK_CHANGE
* @link_status: link up/down, with error bits (enum ionic_port_status) * @link_status: link up/down, with error bits (enum ionic_port_status)
* @link_speed: speed of the network link * @link_speed: speed of the network link
* @rsvd: reserved byte(s)
* *
* Sent when the network link state changes between UP and DOWN * Sent when the network link state changes between UP and DOWN
*/ */
...@@ -2442,6 +2556,7 @@ struct ionic_link_change_event { ...@@ -2442,6 +2556,7 @@ struct ionic_link_change_event {
* @ecode: event code = IONIC_EVENT_RESET * @ecode: event code = IONIC_EVENT_RESET
* @reset_code: reset type * @reset_code: reset type
* @state: 0=pending, 1=complete, 2=error * @state: 0=pending, 1=complete, 2=error
* @rsvd: reserved byte(s)
* *
* Sent when the NIC or some subsystem is going to be or * Sent when the NIC or some subsystem is going to be or
* has been reset. * has been reset.
...@@ -2458,6 +2573,7 @@ struct ionic_reset_event { ...@@ -2458,6 +2573,7 @@ struct ionic_reset_event {
* struct ionic_heartbeat_event - Sent periodically by NIC to indicate health * struct ionic_heartbeat_event - Sent periodically by NIC to indicate health
* @eid: event number * @eid: event number
* @ecode: event code = IONIC_EVENT_HEARTBEAT * @ecode: event code = IONIC_EVENT_HEARTBEAT
* @rsvd: reserved byte(s)
*/ */
struct ionic_heartbeat_event { struct ionic_heartbeat_event {
__le64 eid; __le64 eid;
...@@ -2481,6 +2597,7 @@ struct ionic_log_event { ...@@ -2481,6 +2597,7 @@ struct ionic_log_event {
* struct ionic_xcvr_event - Transceiver change event * struct ionic_xcvr_event - Transceiver change event
* @eid: event number * @eid: event number
* @ecode: event code = IONIC_EVENT_XCVR * @ecode: event code = IONIC_EVENT_XCVR
* @rsvd: reserved byte(s)
*/ */
struct ionic_xcvr_event { struct ionic_xcvr_event {
__le64 eid; __le64 eid;
...@@ -2488,7 +2605,7 @@ struct ionic_xcvr_event { ...@@ -2488,7 +2605,7 @@ struct ionic_xcvr_event {
u8 rsvd[54]; u8 rsvd[54];
}; };
/** /*
* struct ionic_port_stats - Port statistics structure * struct ionic_port_stats - Port statistics structure
*/ */
struct ionic_port_stats { struct ionic_port_stats {
...@@ -2646,8 +2763,7 @@ enum ionic_oflow_drop_stats { ...@@ -2646,8 +2763,7 @@ enum ionic_oflow_drop_stats {
IONIC_OFLOW_DROP_MAX, IONIC_OFLOW_DROP_MAX,
}; };
/** /* struct ionic_port_pb_stats - packet buffers system stats
* struct port_pb_stats - packet buffers system stats
* uses ionic_pb_buffer_drop_stats for drop_counts[] * uses ionic_pb_buffer_drop_stats for drop_counts[]
*/ */
struct ionic_port_pb_stats { struct ionic_port_pb_stats {
...@@ -2681,7 +2797,9 @@ struct ionic_port_pb_stats { ...@@ -2681,7 +2797,9 @@ struct ionic_port_pb_stats {
* @pause_type: supported pause types * @pause_type: supported pause types
* @loopback_mode: supported loopback mode * @loopback_mode: supported loopback mode
* @speeds: supported speeds * @speeds: supported speeds
* @rsvd2: reserved byte(s)
* @config: current port configuration * @config: current port configuration
* @words: word access to struct contents
*/ */
union ionic_port_identity { union ionic_port_identity {
struct { struct {
...@@ -2707,7 +2825,8 @@ union ionic_port_identity { ...@@ -2707,7 +2825,8 @@ union ionic_port_identity {
* @status: Port status data * @status: Port status data
* @stats: Port statistics data * @stats: Port statistics data
* @mgmt_stats: Port management statistics data * @mgmt_stats: Port management statistics data
* @port_pb_drop_stats: uplink pb drop stats * @rsvd: reserved byte(s)
* @pb_stats: uplink pb drop stats
*/ */
struct ionic_port_info { struct ionic_port_info {
union ionic_port_config config; union ionic_port_config config;
...@@ -2721,7 +2840,7 @@ struct ionic_port_info { ...@@ -2721,7 +2840,7 @@ struct ionic_port_info {
struct ionic_port_pb_stats pb_stats; struct ionic_port_pb_stats pb_stats;
}; };
/** /*
* struct ionic_lif_stats - LIF statistics structure * struct ionic_lif_stats - LIF statistics structure
*/ */
struct ionic_lif_stats { struct ionic_lif_stats {
...@@ -2983,8 +3102,10 @@ struct ionic_hwstamp_regs { ...@@ -2983,8 +3102,10 @@ struct ionic_hwstamp_regs {
* bit 4-7 - 4 bit generation number, changes on fw restart * bit 4-7 - 4 bit generation number, changes on fw restart
* @fw_heartbeat: Firmware heartbeat counter * @fw_heartbeat: Firmware heartbeat counter
* @serial_num: Serial number * @serial_num: Serial number
* @rsvd_pad1024: reserved byte(s)
* @fw_version: Firmware version * @fw_version: Firmware version
* @hwstamp_regs: Hardware current timestamp registers * @hwstamp: Hardware current timestamp registers
* @words: word access to struct contents
*/ */
union ionic_dev_info_regs { union ionic_dev_info_regs {
#define IONIC_DEVINFO_FWVERS_BUFLEN 32 #define IONIC_DEVINFO_FWVERS_BUFLEN 32
...@@ -3014,7 +3135,9 @@ union ionic_dev_info_regs { ...@@ -3014,7 +3135,9 @@ union ionic_dev_info_regs {
* @done: Done indicator, bit 0 == 1 when command is complete * @done: Done indicator, bit 0 == 1 when command is complete
* @cmd: Opcode-specific command bytes * @cmd: Opcode-specific command bytes
* @comp: Opcode-specific response bytes * @comp: Opcode-specific response bytes
* @rsvd: reserved byte(s)
* @data: Opcode-specific side-data * @data: Opcode-specific side-data
* @words: word access to struct contents
*/ */
union ionic_dev_cmd_regs { union ionic_dev_cmd_regs {
struct { struct {
...@@ -3032,6 +3155,7 @@ union ionic_dev_cmd_regs { ...@@ -3032,6 +3155,7 @@ union ionic_dev_cmd_regs {
* union ionic_dev_regs - Device register format for bar 0 page 0 * union ionic_dev_regs - Device register format for bar 0 page 0
* @info: Device info registers * @info: Device info registers
* @devcmd: Device command registers * @devcmd: Device command registers
* @words: word access to struct contents
*/ */
union ionic_dev_regs { union ionic_dev_regs {
struct { struct {
...@@ -3098,6 +3222,7 @@ union ionic_adminq_comp { ...@@ -3098,6 +3222,7 @@ union ionic_adminq_comp {
* interrupts when armed. * interrupts when armed.
* @qid_lo: Queue destination for the producer index and flags (low bits) * @qid_lo: Queue destination for the producer index and flags (low bits)
* @qid_hi: Queue destination for the producer index and flags (high bits) * @qid_hi: Queue destination for the producer index and flags (high bits)
* @rsvd2: reserved byte(s)
*/ */
struct ionic_doorbell { struct ionic_doorbell {
__le16 p_index; __le16 p_index;
......
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
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7