root/drivers/net/ethernet/google/gve/gve_adminq.h
/* SPDX-License-Identifier: (GPL-2.0 OR MIT)
 * Google virtual Ethernet (gve) driver
 *
 * Copyright (C) 2015-2021 Google, Inc.
 */

#ifndef _GVE_ADMINQ_H
#define _GVE_ADMINQ_H

#include <linux/build_bug.h>

/* Admin queue opcodes */
enum gve_adminq_opcodes {
        GVE_ADMINQ_DESCRIBE_DEVICE              = 0x1,
        GVE_ADMINQ_CONFIGURE_DEVICE_RESOURCES   = 0x2,
        GVE_ADMINQ_REGISTER_PAGE_LIST           = 0x3,
        GVE_ADMINQ_UNREGISTER_PAGE_LIST         = 0x4,
        GVE_ADMINQ_CREATE_TX_QUEUE              = 0x5,
        GVE_ADMINQ_CREATE_RX_QUEUE              = 0x6,
        GVE_ADMINQ_DESTROY_TX_QUEUE             = 0x7,
        GVE_ADMINQ_DESTROY_RX_QUEUE             = 0x8,
        GVE_ADMINQ_DECONFIGURE_DEVICE_RESOURCES = 0x9,
        GVE_ADMINQ_CONFIGURE_RSS                = 0xA,
        GVE_ADMINQ_SET_DRIVER_PARAMETER         = 0xB,
        GVE_ADMINQ_REPORT_STATS                 = 0xC,
        GVE_ADMINQ_REPORT_LINK_SPEED            = 0xD,
        GVE_ADMINQ_GET_PTYPE_MAP                = 0xE,
        GVE_ADMINQ_VERIFY_DRIVER_COMPATIBILITY  = 0xF,
        GVE_ADMINQ_QUERY_FLOW_RULES             = 0x10,
        GVE_ADMINQ_REPORT_NIC_TIMESTAMP         = 0x11,
        GVE_ADMINQ_QUERY_RSS                    = 0x12,

        /* For commands that are larger than 56 bytes */
        GVE_ADMINQ_EXTENDED_COMMAND             = 0xFF,
};

/* The normal adminq command is restricted to be 56 bytes at maximum. For the
 * longer adminq command, it is wrapped by GVE_ADMINQ_EXTENDED_COMMAND with
 * inner opcode of gve_adminq_extended_cmd_opcodes specified. The inner command
 * is written in the dma memory allocated by GVE_ADMINQ_EXTENDED_COMMAND.
 */
enum gve_adminq_extended_cmd_opcodes {
        GVE_ADMINQ_CONFIGURE_FLOW_RULE  = 0x101,
};

/* Admin queue status codes */
enum gve_adminq_statuses {
        GVE_ADMINQ_COMMAND_UNSET                        = 0x0,
        GVE_ADMINQ_COMMAND_PASSED                       = 0x1,
        GVE_ADMINQ_COMMAND_ERROR_ABORTED                = 0xFFFFFFF0,
        GVE_ADMINQ_COMMAND_ERROR_ALREADY_EXISTS         = 0xFFFFFFF1,
        GVE_ADMINQ_COMMAND_ERROR_CANCELLED              = 0xFFFFFFF2,
        GVE_ADMINQ_COMMAND_ERROR_DATALOSS               = 0xFFFFFFF3,
        GVE_ADMINQ_COMMAND_ERROR_DEADLINE_EXCEEDED      = 0xFFFFFFF4,
        GVE_ADMINQ_COMMAND_ERROR_FAILED_PRECONDITION    = 0xFFFFFFF5,
        GVE_ADMINQ_COMMAND_ERROR_INTERNAL_ERROR         = 0xFFFFFFF6,
        GVE_ADMINQ_COMMAND_ERROR_INVALID_ARGUMENT       = 0xFFFFFFF7,
        GVE_ADMINQ_COMMAND_ERROR_NOT_FOUND              = 0xFFFFFFF8,
        GVE_ADMINQ_COMMAND_ERROR_OUT_OF_RANGE           = 0xFFFFFFF9,
        GVE_ADMINQ_COMMAND_ERROR_PERMISSION_DENIED      = 0xFFFFFFFA,
        GVE_ADMINQ_COMMAND_ERROR_UNAUTHENTICATED        = 0xFFFFFFFB,
        GVE_ADMINQ_COMMAND_ERROR_RESOURCE_EXHAUSTED     = 0xFFFFFFFC,
        GVE_ADMINQ_COMMAND_ERROR_UNAVAILABLE            = 0xFFFFFFFD,
        GVE_ADMINQ_COMMAND_ERROR_UNIMPLEMENTED          = 0xFFFFFFFE,
        GVE_ADMINQ_COMMAND_ERROR_UNKNOWN_ERROR          = 0xFFFFFFFF,
};

#define GVE_ADMINQ_DEVICE_DESCRIPTOR_VERSION 1

/* All AdminQ command structs should be naturally packed. The static_assert
 * calls make sure this is the case at compile time.
 */

struct gve_adminq_describe_device {
        __be64 device_descriptor_addr;
        __be32 device_descriptor_version;
        __be32 available_length;
};

static_assert(sizeof(struct gve_adminq_describe_device) == 16);

struct gve_device_descriptor {
        __be64 max_registered_pages;
        __be16 reserved1;
        __be16 tx_queue_entries;
        __be16 rx_queue_entries;
        __be16 default_num_queues;
        __be16 mtu;
        __be16 counters;
        __be16 tx_pages_per_qpl;
        __be16 rx_pages_per_qpl;
        u8  mac[ETH_ALEN];
        __be16 num_device_options;
        __be16 total_length;
        u8  reserved2[6];
};

static_assert(sizeof(struct gve_device_descriptor) == 40);

struct gve_device_option {
        __be16 option_id;
        __be16 option_length;
        __be32 required_features_mask;
};

static_assert(sizeof(struct gve_device_option) == 8);

struct gve_device_option_gqi_rda {
        __be32 supported_features_mask;
};

static_assert(sizeof(struct gve_device_option_gqi_rda) == 4);

struct gve_device_option_gqi_qpl {
        __be32 supported_features_mask;
};

static_assert(sizeof(struct gve_device_option_gqi_qpl) == 4);

struct gve_device_option_dqo_rda {
        __be32 supported_features_mask;
        __be32 reserved;
};

static_assert(sizeof(struct gve_device_option_dqo_rda) == 8);

struct gve_device_option_dqo_qpl {
        __be32 supported_features_mask;
        __be16 tx_pages_per_qpl;
        __be16 rx_pages_per_qpl;
};

static_assert(sizeof(struct gve_device_option_dqo_qpl) == 8);

struct gve_device_option_jumbo_frames {
        __be32 supported_features_mask;
        __be16 max_mtu;
        u8 padding[2];
};

static_assert(sizeof(struct gve_device_option_jumbo_frames) == 8);

struct gve_device_option_buffer_sizes {
        /* GVE_SUP_BUFFER_SIZES_MASK bit should be set */
        __be32 supported_features_mask;
        __be16 packet_buffer_size;
        __be16 header_buffer_size;
};

static_assert(sizeof(struct gve_device_option_buffer_sizes) == 8);

struct gve_device_option_modify_ring {
        __be32 supported_featured_mask;
        __be16 max_rx_ring_size;
        __be16 max_tx_ring_size;
        __be16 min_rx_ring_size;
        __be16 min_tx_ring_size;
};

static_assert(sizeof(struct gve_device_option_modify_ring) == 12);

struct gve_device_option_flow_steering {
        __be32 supported_features_mask;
        __be32 reserved;
        __be32 max_flow_rules;
};

static_assert(sizeof(struct gve_device_option_flow_steering) == 12);

struct gve_device_option_rss_config {
        __be32 supported_features_mask;
        __be16 hash_key_size;
        __be16 hash_lut_size;
};

static_assert(sizeof(struct gve_device_option_rss_config) == 8);

struct gve_device_option_nic_timestamp {
        __be32 supported_features_mask;
};

static_assert(sizeof(struct gve_device_option_nic_timestamp) == 4);

/* Terminology:
 *
 * RDA - Raw DMA Addressing - Buffers associated with SKBs are directly DMA
 *       mapped and read/updated by the device.
 *
 * QPL - Queue Page Lists - Driver uses bounce buffers which are DMA mapped with
 *       the device for read/write and data is copied from/to SKBs.
 */
enum gve_dev_opt_id {
        GVE_DEV_OPT_ID_GQI_RAW_ADDRESSING       = 0x1,
        GVE_DEV_OPT_ID_GQI_RDA                  = 0x2,
        GVE_DEV_OPT_ID_GQI_QPL                  = 0x3,
        GVE_DEV_OPT_ID_DQO_RDA                  = 0x4,
        GVE_DEV_OPT_ID_MODIFY_RING              = 0x6,
        GVE_DEV_OPT_ID_DQO_QPL                  = 0x7,
        GVE_DEV_OPT_ID_JUMBO_FRAMES             = 0x8,
        GVE_DEV_OPT_ID_BUFFER_SIZES             = 0xa,
        GVE_DEV_OPT_ID_FLOW_STEERING            = 0xb,
        GVE_DEV_OPT_ID_NIC_TIMESTAMP            = 0xd,
        GVE_DEV_OPT_ID_RSS_CONFIG               = 0xe,
};

enum gve_dev_opt_req_feat_mask {
        GVE_DEV_OPT_REQ_FEAT_MASK_GQI_RAW_ADDRESSING    = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_GQI_RDA               = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_GQI_QPL               = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_DQO_RDA               = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_JUMBO_FRAMES          = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_DQO_QPL               = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_BUFFER_SIZES          = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_MODIFY_RING           = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_FLOW_STEERING         = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_RSS_CONFIG            = 0x0,
        GVE_DEV_OPT_REQ_FEAT_MASK_NIC_TIMESTAMP         = 0x0,
};

enum gve_sup_feature_mask {
        GVE_SUP_MODIFY_RING_MASK        = 1 << 0,
        GVE_SUP_JUMBO_FRAMES_MASK       = 1 << 2,
        GVE_SUP_BUFFER_SIZES_MASK       = 1 << 4,
        GVE_SUP_FLOW_STEERING_MASK      = 1 << 5,
        GVE_SUP_RSS_CONFIG_MASK         = 1 << 7,
        GVE_SUP_NIC_TIMESTAMP_MASK      = 1 << 8,
};

#define GVE_DEV_OPT_LEN_GQI_RAW_ADDRESSING 0x0

#define GVE_VERSION_STR_LEN 128

enum gve_driver_capbility {
        gve_driver_capability_gqi_qpl = 0,
        gve_driver_capability_gqi_rda = 1,
        gve_driver_capability_dqo_qpl = 2, /* reserved for future use */
        gve_driver_capability_dqo_rda = 3,
        gve_driver_capability_alt_miss_compl = 4,
        gve_driver_capability_flexible_buffer_size = 5,
        gve_driver_capability_flexible_rss_size = 6,
};

#define GVE_CAP1(a) BIT((int)a)
#define GVE_CAP2(a) BIT(((int)a) - 64)
#define GVE_CAP3(a) BIT(((int)a) - 128)
#define GVE_CAP4(a) BIT(((int)a) - 192)

#define GVE_DRIVER_CAPABILITY_FLAGS1 \
        (GVE_CAP1(gve_driver_capability_gqi_qpl) | \
         GVE_CAP1(gve_driver_capability_gqi_rda) | \
         GVE_CAP1(gve_driver_capability_dqo_rda) | \
         GVE_CAP1(gve_driver_capability_alt_miss_compl) | \
         GVE_CAP1(gve_driver_capability_flexible_buffer_size) | \
         GVE_CAP1(gve_driver_capability_flexible_rss_size))

#define GVE_DRIVER_CAPABILITY_FLAGS2 0x0
#define GVE_DRIVER_CAPABILITY_FLAGS3 0x0
#define GVE_DRIVER_CAPABILITY_FLAGS4 0x0

struct gve_adminq_extended_command {
        __be32 inner_opcode;
        __be32 inner_length;
        __be64 inner_command_addr;
};

static_assert(sizeof(struct gve_adminq_extended_command) == 16);

struct gve_driver_info {
        u8 os_type;     /* 0x01 = Linux */
        u8 driver_major;
        u8 driver_minor;
        u8 driver_sub;
        __be32 os_version_major;
        __be32 os_version_minor;
        __be32 os_version_sub;
        __be64 driver_capability_flags[4];
        u8 os_version_str1[GVE_VERSION_STR_LEN];
        u8 os_version_str2[GVE_VERSION_STR_LEN];
};

struct gve_adminq_verify_driver_compatibility {
        __be64 driver_info_len;
        __be64 driver_info_addr;
};

static_assert(sizeof(struct gve_adminq_verify_driver_compatibility) == 16);

struct gve_adminq_configure_device_resources {
        __be64 counter_array;
        __be64 irq_db_addr;
        __be32 num_counters;
        __be32 num_irq_dbs;
        __be32 irq_db_stride;
        __be32 ntfy_blk_msix_base_idx;
        u8 queue_format;
        u8 padding[7];
};

static_assert(sizeof(struct gve_adminq_configure_device_resources) == 40);

struct gve_adminq_register_page_list {
        __be32 page_list_id;
        __be32 num_pages;
        __be64 page_address_list_addr;
        __be64 page_size;
};

static_assert(sizeof(struct gve_adminq_register_page_list) == 24);

struct gve_adminq_unregister_page_list {
        __be32 page_list_id;
};

static_assert(sizeof(struct gve_adminq_unregister_page_list) == 4);

#define GVE_RAW_ADDRESSING_QPL_ID 0xFFFFFFFF

struct gve_adminq_create_tx_queue {
        __be32 queue_id;
        __be32 reserved;
        __be64 queue_resources_addr;
        __be64 tx_ring_addr;
        __be32 queue_page_list_id;
        __be32 ntfy_id;
        __be64 tx_comp_ring_addr;
        __be16 tx_ring_size;
        __be16 tx_comp_ring_size;
        u8 padding[4];
};

static_assert(sizeof(struct gve_adminq_create_tx_queue) == 48);

struct gve_adminq_create_rx_queue {
        __be32 queue_id;
        __be32 index;
        __be32 reserved;
        __be32 ntfy_id;
        __be64 queue_resources_addr;
        __be64 rx_desc_ring_addr;
        __be64 rx_data_ring_addr;
        __be32 queue_page_list_id;
        __be16 rx_ring_size;
        __be16 packet_buffer_size;
        __be16 rx_buff_ring_size;
        u8 enable_rsc;
        u8 padding1;
        __be16 header_buffer_size;
        u8 padding2[2];
};

static_assert(sizeof(struct gve_adminq_create_rx_queue) == 56);

/* Queue resources that are shared with the device */
struct gve_queue_resources {
        union {
                struct {
                        __be32 db_index;        /* Device -> Guest */
                        __be32 counter_index;   /* Device -> Guest */
                };
                u8 reserved[64];
        };
};

static_assert(sizeof(struct gve_queue_resources) == 64);

struct gve_adminq_destroy_tx_queue {
        __be32 queue_id;
};

static_assert(sizeof(struct gve_adminq_destroy_tx_queue) == 4);

struct gve_adminq_destroy_rx_queue {
        __be32 queue_id;
};

static_assert(sizeof(struct gve_adminq_destroy_rx_queue) == 4);

/* GVE Set Driver Parameter Types */
enum gve_set_driver_param_types {
        GVE_SET_PARAM_MTU       = 0x1,
};

struct gve_adminq_set_driver_parameter {
        __be32 parameter_type;
        u8 reserved[4];
        __be64 parameter_value;
};

static_assert(sizeof(struct gve_adminq_set_driver_parameter) == 16);

struct gve_adminq_report_stats {
        __be64 stats_report_len;
        __be64 stats_report_addr;
        __be64 interval;
};

static_assert(sizeof(struct gve_adminq_report_stats) == 24);

struct gve_adminq_report_link_speed {
        __be64 link_speed_address;
};

static_assert(sizeof(struct gve_adminq_report_link_speed) == 8);

struct gve_adminq_report_nic_ts {
        __be64 nic_ts_report_len;
        __be64 nic_ts_report_addr;
};

static_assert(sizeof(struct gve_adminq_report_nic_ts) == 16);

struct gve_nic_ts_report {
        __be64 nic_timestamp; /* NIC clock in nanoseconds */
        __be64 reserved1;
        __be64 reserved2;
        __be64 reserved3;
        __be64 reserved4;
};

struct stats {
        __be32 stat_name;
        __be32 queue_id;
        __be64 value;
};

static_assert(sizeof(struct stats) == 16);

struct gve_stats_report {
        __be64 written_count;
        struct stats stats[];
};

static_assert(sizeof(struct gve_stats_report) == 8);

enum gve_stat_names {
        // stats from gve
        TX_WAKE_CNT                     = 1,
        TX_STOP_CNT                     = 2,
        TX_FRAMES_SENT                  = 3,
        TX_BYTES_SENT                   = 4,
        TX_LAST_COMPLETION_PROCESSED    = 5,
        RX_NEXT_EXPECTED_SEQUENCE       = 6,
        RX_BUFFERS_POSTED               = 7,
        TX_TIMEOUT_CNT                  = 8,
        // stats from NIC
        RX_QUEUE_DROP_CNT               = 65,
        RX_NO_BUFFERS_POSTED            = 66,
        RX_DROPS_PACKET_OVER_MRU        = 67,
        RX_DROPS_INVALID_CHECKSUM       = 68,
};

enum gve_l3_type {
        /* Must be zero so zero initialized LUT is unknown. */
        GVE_L3_TYPE_UNKNOWN = 0,
        GVE_L3_TYPE_OTHER,
        GVE_L3_TYPE_IPV4,
        GVE_L3_TYPE_IPV6,
};

enum gve_l4_type {
        /* Must be zero so zero initialized LUT is unknown. */
        GVE_L4_TYPE_UNKNOWN = 0,
        GVE_L4_TYPE_OTHER,
        GVE_L4_TYPE_TCP,
        GVE_L4_TYPE_UDP,
        GVE_L4_TYPE_ICMP,
        GVE_L4_TYPE_SCTP,
};

/* These are control path types for PTYPE which are the same as the data path
 * types.
 */
struct gve_ptype_entry {
        u8 l3_type;
        u8 l4_type;
};

struct gve_ptype_map {
        struct gve_ptype_entry ptypes[GVE_NUM_PTYPES]; /* PTYPES are always 10 bits. */
};

struct gve_adminq_get_ptype_map {
        __be64 ptype_map_len;
        __be64 ptype_map_addr;
};

/* Flow-steering related definitions */
enum gve_adminq_flow_rule_cfg_opcode {
        GVE_FLOW_RULE_CFG_ADD   = 0,
        GVE_FLOW_RULE_CFG_DEL   = 1,
        GVE_FLOW_RULE_CFG_RESET = 2,
};

enum gve_adminq_flow_rule_query_opcode {
        GVE_FLOW_RULE_QUERY_RULES       = 0,
        GVE_FLOW_RULE_QUERY_IDS         = 1,
        GVE_FLOW_RULE_QUERY_STATS       = 2,
};

enum gve_adminq_flow_type {
        GVE_FLOW_TYPE_TCPV4,
        GVE_FLOW_TYPE_UDPV4,
        GVE_FLOW_TYPE_SCTPV4,
        GVE_FLOW_TYPE_AHV4,
        GVE_FLOW_TYPE_ESPV4,
        GVE_FLOW_TYPE_TCPV6,
        GVE_FLOW_TYPE_UDPV6,
        GVE_FLOW_TYPE_SCTPV6,
        GVE_FLOW_TYPE_AHV6,
        GVE_FLOW_TYPE_ESPV6,
};

/* Flow-steering command */
struct gve_adminq_flow_rule {
        __be16 flow_type;
        __be16 action; /* RX queue id */
        struct gve_flow_spec key;
        struct gve_flow_spec mask;
};

struct gve_adminq_configure_flow_rule {
        __be16 opcode;
        u8 padding[2];
        struct gve_adminq_flow_rule rule;
        __be32 location;
};

static_assert(sizeof(struct gve_adminq_configure_flow_rule) == 92);

struct gve_query_flow_rules_descriptor {
        __be32 num_flow_rules;
        __be32 max_flow_rules;
        __be32 num_queried_rules;
        __be32 total_length;
};

struct gve_adminq_queried_flow_rule {
        __be32 location;
        struct gve_adminq_flow_rule flow_rule;
};

struct gve_adminq_query_flow_rules {
        __be16 opcode;
        u8 padding[2];
        __be32 starting_rule_id;
        __be64 available_length; /* The dma memory length that the driver allocated */
        __be64 rule_descriptor_addr; /* The dma memory address */
};

static_assert(sizeof(struct gve_adminq_query_flow_rules) == 24);

enum gve_rss_hash_type {
        GVE_RSS_HASH_IPV4,
        GVE_RSS_HASH_TCPV4,
        GVE_RSS_HASH_IPV6,
        GVE_RSS_HASH_IPV6_EX,
        GVE_RSS_HASH_TCPV6,
        GVE_RSS_HASH_TCPV6_EX,
        GVE_RSS_HASH_UDPV4,
        GVE_RSS_HASH_UDPV6,
        GVE_RSS_HASH_UDPV6_EX,
};

struct gve_adminq_configure_rss {
        __be16 hash_types;
        u8 hash_alg;
        u8 reserved;
        __be16 hash_key_size;
        __be16 hash_lut_size;
        __be64 hash_key_addr;
        __be64 hash_lut_addr;
};

static_assert(sizeof(struct gve_adminq_configure_rss) == 24);

struct gve_query_rss_descriptor {
        __be32 total_length;
        __be16 hash_types;
        u8 hash_alg;
        u8 reserved;
};

struct gve_adminq_query_rss {
        __be64 available_length;
        __be64 rss_descriptor_addr;
};

static_assert(sizeof(struct gve_adminq_query_rss) == 16);

union gve_adminq_command {
        struct {
                __be32 opcode;
                __be32 status;
                union {
                        struct gve_adminq_configure_device_resources
                                                configure_device_resources;
                        struct gve_adminq_create_tx_queue create_tx_queue;
                        struct gve_adminq_create_rx_queue create_rx_queue;
                        struct gve_adminq_destroy_tx_queue destroy_tx_queue;
                        struct gve_adminq_destroy_rx_queue destroy_rx_queue;
                        struct gve_adminq_describe_device describe_device;
                        struct gve_adminq_register_page_list reg_page_list;
                        struct gve_adminq_unregister_page_list unreg_page_list;
                        struct gve_adminq_set_driver_parameter set_driver_param;
                        struct gve_adminq_report_stats report_stats;
                        struct gve_adminq_report_link_speed report_link_speed;
                        struct gve_adminq_get_ptype_map get_ptype_map;
                        struct gve_adminq_verify_driver_compatibility
                                                verify_driver_compatibility;
                        struct gve_adminq_query_flow_rules query_flow_rules;
                        struct gve_adminq_configure_rss configure_rss;
                        struct gve_adminq_query_rss query_rss;
                        struct gve_adminq_report_nic_ts report_nic_ts;
                        struct gve_adminq_extended_command extended_command;
                };
        };
        u8 reserved[64];
};

static_assert(sizeof(union gve_adminq_command) == 64);

int gve_adminq_alloc(struct device *dev, struct gve_priv *priv);
void gve_adminq_free(struct device *dev, struct gve_priv *priv);
void gve_adminq_release(struct gve_priv *priv);
int gve_adminq_describe_device(struct gve_priv *priv);
int gve_adminq_configure_device_resources(struct gve_priv *priv,
                                          dma_addr_t counter_array_bus_addr,
                                          u32 num_counters,
                                          dma_addr_t db_array_bus_addr,
                                          u32 num_ntfy_blks);
int gve_adminq_deconfigure_device_resources(struct gve_priv *priv);
int gve_adminq_create_tx_queues(struct gve_priv *priv, u32 start_id, u32 num_queues);
int gve_adminq_destroy_tx_queues(struct gve_priv *priv, u32 start_id, u32 num_queues);
int gve_adminq_create_single_rx_queue(struct gve_priv *priv, u32 queue_index);
int gve_adminq_create_rx_queues(struct gve_priv *priv, u32 num_queues);
int gve_adminq_destroy_single_rx_queue(struct gve_priv *priv, u32 queue_index);
int gve_adminq_destroy_rx_queues(struct gve_priv *priv, u32 queue_id);
int gve_adminq_register_page_list(struct gve_priv *priv,
                                  struct gve_queue_page_list *qpl);
int gve_adminq_unregister_page_list(struct gve_priv *priv, u32 page_list_id);
int gve_adminq_report_stats(struct gve_priv *priv, u64 stats_report_len,
                            dma_addr_t stats_report_addr, u64 interval);
int gve_adminq_verify_driver_compatibility(struct gve_priv *priv,
                                           u64 driver_info_len,
                                           dma_addr_t driver_info_addr);
int gve_adminq_report_link_speed(struct gve_priv *priv);
int gve_adminq_add_flow_rule(struct gve_priv *priv, struct gve_adminq_flow_rule *rule, u32 loc);
int gve_adminq_del_flow_rule(struct gve_priv *priv, u32 loc);
int gve_adminq_reset_flow_rules(struct gve_priv *priv);
int gve_adminq_query_flow_rules(struct gve_priv *priv, u16 query_opcode, u32 starting_loc);
int gve_adminq_configure_rss(struct gve_priv *priv, struct ethtool_rxfh_param *rxfh);
int gve_adminq_query_rss_config(struct gve_priv *priv, struct ethtool_rxfh_param *rxfh);
int gve_adminq_report_nic_ts(struct gve_priv *priv,
                             dma_addr_t nic_ts_report_addr);

struct gve_ptype_lut;
int gve_adminq_get_ptype_map_dqo(struct gve_priv *priv,
                                 struct gve_ptype_lut *ptype_lut);

#endif /* _GVE_ADMINQ_H */