On Thu, Mar 19, 2009 at 11:05:48AM -0600, Alex Chiang wrote:
> * Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>:
> > On Wed, 18 Mar 2009 16:39:56 -0600 Alex Chiang <achiang@xxxxxx> wrote:
> >
> > > This API is used by the PCI core to rescan a bus and rediscover
> > > newly added devices.
> > >
> > > Over time, it is expected that the various PCI hotplug drivers
> > > will migrate to this interface and away from the old
> > > pci_do_scan_bus() interface.
> > >
> > > ...
> > >
> > > @@ -1195,10 +1195,39 @@ struct pci_bus * __devinit pci_scan_bus_parented(struct device *parent,
> > > EXPORT_SYMBOL(pci_scan_bus_parented);
> > >
> > > #ifdef CONFIG_HOTPLUG
> > > +/**
> > > + * pci_rescan_bus - scan a PCI bus for devices.
> > > + * @bus: PCI bus to scan
> > > + *
> > > + * Scan a PCI bus and child buses for new devices, adds them,
> > > + * and enables them.
> > > + *
> > > + * Returns the max number of subordinate bus discovered.
> > > + */
> > > +unsigned int __devinit pci_rescan_bus(struct pci_bus *bus)
> > > +{
> > > + unsigned int max;
> > > + struct pci_dev *dev;
> > > +
> > > + max = pci_scan_child_bus(bus);
> > > + list_for_each_entry(dev, &bus->devices, bus_list)
> > > + if (dev->hdr_type == PCI_HEADER_TYPE_BRIDGE ||
> > > + dev->hdr_type == PCI_HEADER_TYPE_CARDBUS)
> > > + if (dev->subordinate)
> > > + pci_bus_size_bridges(dev->subordinate);
> > > +
> > > + pci_bus_assign_resources(bus);
> > > + pci_enable_bridges(bus);
> > > + pci_bus_add_devices(bus);
> > > +
> > > + return max;
> > > +}
> > > +
> > > EXPORT_SYMBOL(pci_add_new_bus);
> > > EXPORT_SYMBOL(pci_scan_slot);
> > > EXPORT_SYMBOL(pci_scan_bridge);
> > > EXPORT_SYMBOL_GPL(pci_scan_child_bus);
> > > +EXPORT_SYMBOL_GPL(pci_rescan_bus);
> >
> > uhm, is there any rationale for the seemingly-random mixup of export types
> > in this interface?
>
> History?
>
> I've no clue why we're mixing EXPORT_SYMBOL and EXPORT_SYMBOL_GPL.
I do :)
New PCI core exports were added with _GPL, it's the older ones that were
left at the "normal" level.
> git-blame says that the mishmash existed pre-git.
>
> For my new interface, I thought that EXPORT_SYMBOL_GPL would be
> most appropriate, but maybe not?
Yes it is, pci hotplug exports has always been EXPORT_SYMBOL_GPL(), in
fact I think it was the first in-tree user of this marking.
> What would you like me to do? Make them all the same?
New ones should be _GPL() please.
But please put the export in the proper place, checkpatch.pl will
complain if you do not. Which means you didn't run it on your patches
:)
thanks,
greg k-h
--
To unsubscribe from this list: send the line "unsubscribe linux-pci" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
