drivers/net/ethernet/google/gve/gve_adminq.h

File Facts

System

Linux kernel

Corpus path

drivers/net/ethernet/google/gve/gve_adminq.h

Extension

.h

Size

18230 bytes

Lines

661

Domain

Driver Families

Bucket

drivers/net

Inferred role

Driver Families: implementation source

Status

source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/build_bug.h

Detected Declarations

• struct gve_adminq_describe_device
• struct gve_device_descriptor
• struct gve_device_option
• struct gve_device_option_gqi_rda
• struct gve_device_option_gqi_qpl
• struct gve_device_option_dqo_rda
• struct gve_device_option_dqo_qpl
• struct gve_device_option_jumbo_frames
• struct gve_device_option_buffer_sizes
• struct gve_device_option_modify_ring
• struct gve_device_option_flow_steering
• struct gve_device_option_rss_config
• struct gve_device_option_nic_timestamp
• struct gve_adminq_extended_command
• struct gve_driver_info
• struct gve_adminq_verify_driver_compatibility
• struct gve_adminq_configure_device_resources
• struct gve_adminq_register_page_list
• struct gve_adminq_unregister_page_list
• struct gve_adminq_create_tx_queue
• struct gve_adminq_create_rx_queue
• struct gve_queue_resources
• struct gve_adminq_destroy_tx_queue
• struct gve_adminq_destroy_rx_queue
• struct gve_adminq_set_driver_parameter
• struct gve_adminq_report_stats
• struct gve_adminq_report_link_speed
• struct gve_adminq_report_nic_ts
• struct gve_nic_ts_report
• struct stats
• struct gve_stats_report
• struct gve_ptype_entry
• struct gve_ptype_map
• struct gve_adminq_get_ptype_map
• struct gve_adminq_flow_rule
• struct gve_adminq_configure_flow_rule
• struct gve_query_flow_rules_descriptor
• struct gve_adminq_queried_flow_rule
• struct gve_adminq_query_flow_rules
• struct gve_adminq_configure_rss
• struct gve_query_rss_descriptor
• struct gve_adminq_query_rss
• struct gve_ptype_lut
• enum gve_adminq_opcodes
• enum gve_adminq_extended_cmd_opcodes
• enum gve_adminq_statuses
• enum gve_dev_opt_id
• enum gve_dev_opt_req_feat_mask

Annotated Snippet

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;

Annotation

• Immediate include surface: `linux/build_bug.h`.
• Detected declarations: `struct gve_adminq_describe_device`, `struct gve_device_descriptor`, `struct gve_device_option`, `struct gve_device_option_gqi_rda`, `struct gve_device_option_gqi_qpl`, `struct gve_device_option_dqo_rda`, `struct gve_device_option_dqo_qpl`, `struct gve_device_option_jumbo_frames`, `struct gve_device_option_buffer_sizes`, `struct gve_device_option_modify_ring`.
• Atlas domain: Driver Families / drivers/net.
• Implementation status: source implementation candidate.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.