Module virtio

VirtIO ASM bindings.

Complete bindings for VirtIO device initialization and virtqueue operations.

Reference

NETWORK_IMPL_GUIDE.md §2.2.2, §4

Modules

• device
  VirtIO device operations.
• notify
  Notification operations.
• queue
  Virtqueue operations.
• rx
  RX operations.
• tx
  TX operations.

Functions

• asm_virtio_get_device_id 🔒 ^⚠
  Get VirtIO device ID (1 = net, 2 = block, etc.).
• asm_virtio_get_status 🔒 ^⚠
  Get VirtIO device status.
• asm_virtio_get_version 🔒 ^⚠
  Get VirtIO device version (2 = modern).
• asm_virtio_read_features 🔒 ^⚠
  Read device feature bits (64-bit, handles feature_sel).
• asm_virtio_read_mac 🔒 ^⚠
  Read MAC address from config space. Returns 0 on success, 1 if MAC feature not negotiated.
• asm_virtio_reset 🔒 ^⚠
  Reset VirtIO device (write 0 to status, wait for completion). Returns 0 on success, 1 on timeout.
• asm_virtio_set_status 🔒 ^⚠
  Set VirtIO device status.
• asm_virtio_verify_magic 🔒 ^⚠
  Verify VirtIO magic value (0x74726976 = “virt”). Returns 1 if valid, 0 if not.
• asm_virtio_write_features 🔒 ^⚠
  Write driver-accepted feature bits.
• asm_vq_disable 🔒 ^⚠
  Disable selected queue.
• asm_vq_enable 🔒 ^⚠
  Enable selected queue.
• asm_vq_get_max_size 🔒 ^⚠
  Get maximum queue size for selected queue.
• asm_vq_init_desc 🔒 ^⚠
  Initialize a single descriptor.
• asm_vq_init_desc_chain 🔒 ^⚠
  Initialize descriptor chain (for multi-descriptor buffers).
• asm_vq_is_ready 🔒 ^⚠
  Check if queue is ready.
• asm_vq_notify 🔒 ^⚠
  Notify device about queue activity (uses vq.notify_addr).
• asm_vq_notify_direct 🔒 ^⚠
  Direct notify with explicit address.
• asm_vq_poll_rx 🔒 ^⚠
  Poll for received packet. Returns 0 if no packet, 1 if packet ready (result populated).
• asm_vq_poll_tx_complete 🔒 ^⚠
  Poll TX completion. Returns buffer index (0-0xFFFE) or 0xFFFFFFFF if no completion.
• asm_vq_rx_pending 🔒 ^⚠
  Get number of pending RX packets.
• asm_vq_select 🔒 ^⚠
  Select virtqueue by index.
• asm_vq_set_desc 🔒 ^⚠
  Set descriptor table address.
• asm_vq_set_device 🔒 ^⚠
  Set device (used) ring address.
• asm_vq_set_driver 🔒 ^⚠
  Set driver (available) ring address.
• asm_vq_set_notify_addr 🔒 ^⚠
  Set notify address in VirtqueueState.
• asm_vq_set_size 🔒 ^⚠
  Set queue size for selected queue.
• asm_vq_setup 🔒 ^⚠
  Full queue setup helper.
• asm_vq_should_notify 🔒 ^⚠
  Check if notification is needed (event suppression).
• asm_vq_submit_rx 🔒 ^⚠
  Submit buffer to RX queue. Returns 0 on success, 1 if queue full.
• asm_vq_submit_tx 🔒 ^⚠
  Submit buffer to TX queue. Returns 0 on success, 1 if queue full.
• asm_vq_tx_avail_slots 🔒 ^⚠
  Get number of available TX slots.