STRUCT MOST_INTERFACE(9)

💅 struct most_interface(9) — Kernel API Manual, but make it make sense 🎀

okay bestie, this is the struct most_interface(9) page from the Kernel API Manual, and it’s giving “interface instance description” with main-character energy ✨ Let’s get into it.

💖 NAME 💖

struct most_interface — Interface instance description. Literally that’s the name, no cap 🫶

✨ SYNOPSIS ✨

       struct most_interface {
           struct device *dev;
           struct device *driver_dev;
           struct module *mod;
           enum most_interface_type interface;
           const char *description;
           unsigned int num_channels;
           struct most_channel_capability *channel_vector;
           void *(*dma_alloc)(struct mbo *mbo, u32 size);
           void (*dma_free)(struct mbo *mbo, u32 size);
           int (*configure)(struct most_interface *iface, int channel_idx,
       struct most_channel_config *channel_config);
           int (*enqueue)(struct most_interface *iface, int channel_idx, struct
       mbo *mbo);
           int (*poison_channel)(struct most_interface *iface, int
       channel_idx);
           void (*request_netinfo)(struct most_interface *iface, int
       channel_idx, void (*on_netinfo)(struct most_interface *iface, unsigned
       char link_stat, unsigned char *mac_addr));
           void *priv;
           struct interface_private *p;
        };

🫶 Members 🫶

• dev — the actual device ✨
• driver_dev — struct device for calling snd_card_new
• mod — module
• interface — Interface type. ost_interface_type.
• description — PRELIMINARY. Unique description of the device instance from point of view of the interface in free text form (ASCII). It may be a hexadecimal presentation of the memory address for the MediaLB IP or USB device ID with USB properties for USB interface, etc.
• num_channels — Number of channels and size of the channel_vector.
• channel_vector — Properties of the channels. Array index represents channel ID by the driver.
• dma_alloc — Callback to interface driver to allocation DMA memory. (yes, that’s the exact wording, bestie 🫶)
• dma_free — Callback to interface driver to free a DMA memory allocation.
• configure — Callback to change data type for the channel of the interface instance. May be zero if the instance of the interface is not configurable. Parameter channel_config describes direction and data type for the channel, configured by the higher level. The content of (and then the sentence just… ends 😭 iconic in a tragic way)
• enqueue — Delivers MBO to the HDM for processing. After HDM completes Rx- or Tx- operation the processed MBO shall be returned back to the MostCore using completion routine. The reason to get the MBO delivered from the MostCore after the channel is poisoned is the re-opening of the channel by the application. In this case the HDM shall hold MBOs and service the channel as usual. The HDM must be able to hold at least one MBO for each channel. The callback returns a negative value on error, otherwise 0.
• poison_channel — Informs HDM about closing the channel. The HDM shall cancel all transfers and synchronously or asynchronously return all enqueued for this channel MBOs using the completion routine. The callback returns a negative value on error, otherwise 0.
• request_netinfo — triggers retrieving of network info from the HDM by means of "Message exchange over MDP/MEP" The call of the function request_netinfo with the parameter on_netinfo as NULL prohibits use of the previously obtained function pointer.
• priv — Private field used by mostcore to store context information.
• p — struct interface_private pointer

🌈 Description 🌈

Describes an interface of a MOST device the core driver is bound to. This structure is allocated and initialized in the HDM. MostCore may not modify this structure. So hands off, bestie — that’s the rule 💅

🦋 SEE ALSO 🦋

Kernel file ./include/linux/most.h plus these cross-reference besties:

• enum most_interface_type(9)
• enum most_channel_direction(9)
• enum most_channel_data_type(9)
• struct most_channel_capability(9)
• struct most_channel_config(9)
• struct most_component(9)
• most_register_interface(9)
• most_deregister_interface(9)
• most_stop_enqueue(9)
• most_resume_enqueue(9)

source ./include/linux • date October 2026 • page struct most_interface(9) — that’s the footer, bestie, mwah 💋✨