Garrett D'Amore wrote: > >> >> They're documented in the pci(4) manpage, see >> http://man.freebsd.org/pci/4, and absolutely intended for public >> consumption. >> >> It's been known (ok, quite common) for kernel API/ABI to break across >> major releases, but I'm unaware of any planned work affecting this area. >>
A good clue whom to ask about this is looking at the latest CVS revisions for a related file (pciio.h). You can note from this that FreeBSD is quite aware of interface stability, although they don't document it as much as Sun does and can have cleanup issues to deal with. So, the people to talk to are probably Warner Losh (imp at freebsd.org) and John Baldwin (jhb at freebsd.org). The release engineer (Ken Smith) was consulted here, and Marius did the work. The "MFC after: 5 days" is shorthand for "Move from Current after 5 days", which mean that it went from the head development into the RELENG_7 (version 7 release branch) after 5 days settle time. ---------------------------- revision 1.8 date: 2007/10/24 20:51:44; author: marius; state: Exp; lines: +1 -1 Add ABI backwards compatibility to the FreeBSD 4/5/6 versions of the PCIOCGETCONF, PCIOCREAD and PCIOCWRITE IOCTLs, which was broken with the introduction of PCI domain support. As the size of struct pci_conf_io wasn't changed with that commit, this unfortunately requires the ABI of PCIOCGETCONF to be broken again in order to be able to provide backwards compatibility to the old version of that IOCTL. Requested by: imp Discussed with: re (kensmith) Reviewed by: PCI maintainers (imp, jhb) MFC after: 5 days
