PCI_IOV_UNINIT(9)

✨ PCI_IOV_UNINIT(9) ✨

Kernel Developer's Manual Β· the SR-IOV shutdown queen πŸ’…


🌸 NAME 🌸

PCI_IOV_UNINIT β€” disable SR-IOV on a PF device


πŸŽ€ SYNOPSIS πŸŽ€

#include <sys/bus.h>
#include <dev/pci/pci_iov.h>

void
PCI_IOV_UNINIT(device_t dev);

πŸ¦‹ DESCRIPTION πŸ¦‹

okay bestie so PCI_IOV_UNINIT() is a method, right? And it gets called by the PCI Single-Root I/O Virtualization (SR-IOV) infrastructure whenever the user is like "okay actually turn SR-IOV off on this Physical Function (PF)". Basically the user said no more, and the infra comes knocking on your driver's door. πŸšͺ✨

When this method gets called, the PF driver must:

  • release any SR-IOV-related resources that it has allocated πŸ—‘οΈ
  • disable any device-specific SR-IOV configuration in the device β›”

that's it, that's the job. no cap.

πŸ’€ real talk though: this method will only be called following a successful call to PCI_IOV_INIT(9). So if init didn't slay, don't expect this one to show up.

and one more thing β€” it is not guaranteed that PCI_IOV_ADD_VF(9) will have been called for any Virtual Function (VF) after the call to PCI_IOV_INIT(9) and before the call to PCI_IOV_UNINIT. so like… zero VFs, one VF, who knows. you gotta be ready either way. 🫢


🌈 SEE ALSO 🌈


πŸ‘‘ AUTHORS πŸ‘‘

This manual page was written by Ryan Stone <rstone@FreeBSD.org>. iconic of him honestly. πŸ’–


okay that's the whole page bestie, go forth and uninit responsibly ✨

this lil page came from the Debian edition, dated May 28, 2015 β€” mwah, mwah, bye πŸ’…πŸŽ€

πŸ“¦ where this page comes from