FreeBSD manual

download PDF document: iflib_link_intr_deferred.9.pdf

IFLIBDI(9) FreeBSD Kernel Developer's Manual IFLIBDI(9) NAME iflibdi - Device Independent Configuration Functions SYNOPSIS #include <ifdi_if.h> Device Independent Functions int iflib_device_attach(device_t dev); int iflib_device_detach(device_t dev); int iflib_device_suspend(device_t dev); int iflib_device_resume(device_t dev); int iflib_device_register(device_t dev, void *softc, if_shared_ctx_t sctx, if_ctx_t *ctxp); int iflib_device_deregister(if_ctx_t ctx); int iflib_irq_alloc(if_ctx_t ctx, if_irq_t irq_info, int rid, driver_filter_t filter, void *filter_arg, driver_intr_t handler, void *arg, char *name); int iflib_irq_alloc_generic(if_ctx_t ctx, if_irq_t irq, int rid, intr_type_t type, driver_filter_t *filter, void *filter_arg, int qid, char *name); void iflib_led_create(if_ctx_t ctx); void iflib_tx_intr_deferred(if_ctx_t ctx, int txqid); void iflib_rx_intr_deferred(if_ctx_t ctx, int rxqid); void iflib_link_intr_deferred(if_ctx_t ctx); void iflib_link_state_change(if_ctx_t ctx, int linkstate); void iflib_add_int_delay_sysctl(if_ctx_t ctx, const char *, const char *, if_int_delay_info_t, int, int); Global Variables extern struct if_txrx used to hold packets while the interface is in the process of sending another. The receive queue is used to receive packets that are awaiting processing. The if_ctx_t Structure The fields of struct if_ctx_t are as follows: if_softc (void) A pointer to the driver's private state block. ifc_dev (device_t) The underlying device structure. ifc_ip (if_t) A link back to the interface structure ifc_cpus (cpuset_t) ifc_mutex (struct mtx) Mutex lock used to maintain data integrity ifc_mtx_name (char *) The name of the mutex ifc_txqs (iflib_txq_t) Device independent transmit queue maintained internally by iflib ifc_rxqs (iflib_rxq_t) Device independent receive queue maintained internally by iflib ifc_qsets (iflib_qset_t) Output queue that contains a single transmit (ifc_txq_t) and receive (ifc_rxq_t) queue ifc_if_flags (uint32_t) Flags describing the operational parameter of the interface ifc_in_detach (int) ifc_link_state (int) Describes the current link state of the Ethernet interface. Its possible values are either active or inactive. ifc_link_irq (int) ifc_vlan_attach_event (eventhandler_tag) ifc_vlan_detach_event (eventhandler_tag) ifc_pause_frames (int) ifc_watchdog_events (int) ifc_mac (uint8_t) ifc_msix_mem (struct resource *) ifc_legacy_irq (struct if_irq) ifc_media (struct ifmedia) ifc_txrx (struct if_txrx) FUNCTIONS The above named functions are found exclusively in iflib. They are independent of the underlying hardware type or configuration. Device Independent Functions iflib_device_attach() Function initiates a device registration with the iflib framework. It calls the iflib_register function, which is responsible for allocating and initializing the if_ctx_t structure. iflib_device_detach() Shutdown and detach the device. Unregister vlan events, drain any dependent tasks, and release irq, pci, and msix memory. iflib_device_suspend() Suspend a device by calling the device dependent suspend function and bus_generic_suspend. iflib_device_resume() Resume a device by calling the device dependent resume function, the iflib_init_locked function, and bus_generic_resume. iflib_device_register() Register a device with the iflib framework. Allocate and initialize the if_ctx_t structure. Setup and initialize the MSI or MSI/X interrupt queues if necessary. Allocate memory for queues and qset structure setup. iflib_irq_alloc() Allocate an interrupt resource for a given rid value with an associated filter and handler function. iflib_irq_alloc_generic() Performs the same function as iflib_device_irq_alloc along with the additional functionality of adding a taskgroup. The data fields and callback function are determined by the type of interrupt, such as IFLIB_INTR_TX, IFLIB_INTR_RX, and IFLIB_INTR_ADMIN. iflib_led_create() Calls led_create to initialize the ctx->ifc_led_dev field iflib_tx_intr_deferred() Calls GROUPTASK_ENQUEUE to enqueue the transfer queues ift_task. iflib_rx_intr_deferred() Calls GROUPTASK_ENQUEUE to enqueue the receive queues ifr_task. iflib_link_intr_deferred() Calls GROUPTASK_ENQUEUE to enqueue the link task iflib_link_state_change() Change the interface link status to either LINK_STATE_UP or LINK_STATE_DOWN as specified by the second argument to the function. The link is down. iflib_add_int_delay_sysctl() Modifies settings to user defined values for a given set of variables. SEE ALSO iflibdd(9), iflibtxrx(9) AUTHORS This manual page was written by Nicole Graziano FreeBSD 14.0-RELEASE-p11 May 21, 2019 FreeBSD 14.0-RELEASE-p11