[linux-2.6-block.git] / drivers / pci / bus.c

/*
 *	drivers/pci/bus.c
 *
 * From setup-res.c, by:
 *	Dave Rusling (david.rusling@reo.mts.dec.com)
 *	David Mosberger (davidm@cs.arizona.edu)
 *	David Miller (davem@redhat.com)
 *	Ivan Kokshaysky (ink@jurassic.park.msu.ru)
 */
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/pci.h>
#include <linux/errno.h>
#include <linux/ioport.h>
#include <linux/proc_fs.h>
#include <linux/slab.h>

#include "pci.h"

void pci_add_resource_offset(struct list_head *resources, struct resource *res,
			     resource_size_t offset)
{
	struct resource_entry *entry;

	entry = resource_list_create_entry(res, 0);
	if (!entry) {
		printk(KERN_ERR "PCI: can't add host bridge window %pR\n", res);
		return;
	}

	entry->offset = offset;
	resource_list_add_tail(entry, resources);
}
EXPORT_SYMBOL(pci_add_resource_offset);

void pci_add_resource(struct list_head *resources, struct resource *res)
{
	pci_add_resource_offset(resources, res, 0);
}
EXPORT_SYMBOL(pci_add_resource);

void pci_free_resource_list(struct list_head *resources)
{
	resource_list_free(resources);
}
EXPORT_SYMBOL(pci_free_resource_list);

void pci_bus_add_resource(struct pci_bus *bus, struct resource *res,
			  unsigned int flags)
{
	struct pci_bus_resource *bus_res;

	bus_res = kzalloc(sizeof(struct pci_bus_resource), GFP_KERNEL);
	if (!bus_res) {
		dev_err(&bus->dev, "can't add %pR resource\n", res);
		return;
	}

	bus_res->res = res;
	bus_res->flags = flags;
	list_add_tail(&bus_res->list, &bus->resources);
}

struct resource *pci_bus_resource_n(const struct pci_bus *bus, int n)
{
	struct pci_bus_resource *bus_res;

	if (n < PCI_BRIDGE_RESOURCE_NUM)
		return bus->resource[n];

	n -= PCI_BRIDGE_RESOURCE_NUM;
	list_for_each_entry(bus_res, &bus->resources, list) {
		if (n-- == 0)
			return bus_res->res;
	}
	return NULL;
}
EXPORT_SYMBOL_GPL(pci_bus_resource_n);

void pci_bus_remove_resources(struct pci_bus *bus)
{
	int i;
	struct pci_bus_resource *bus_res, *tmp;

	for (i = 0; i < PCI_BRIDGE_RESOURCE_NUM; i++)
		bus->resource[i] = NULL;

	list_for_each_entry_safe(bus_res, tmp, &bus->resources, list) {
		list_del(&bus_res->list);
		kfree(bus_res);
	}
}

static struct pci_bus_region pci_32_bit = {0, 0xffffffffULL};
#ifdef CONFIG_PCI_BUS_ADDR_T_64BIT
static struct pci_bus_region pci_64_bit = {0,
				(pci_bus_addr_t) 0xffffffffffffffffULL};
static struct pci_bus_region pci_high = {(pci_bus_addr_t) 0x100000000ULL,
				(pci_bus_addr_t) 0xffffffffffffffffULL};
#endif

/*
 * @res contains CPU addresses.  Clip it so the corresponding bus addresses
 * on @bus are entirely within @region.  This is used to control the bus
 * addresses of resources we allocate, e.g., we may need a resource that
 * can be mapped by a 32-bit BAR.
 */
static void pci_clip_resource_to_region(struct pci_bus *bus,
					struct resource *res,
					struct pci_bus_region *region)
{
	struct pci_bus_region r;

	pcibios_resource_to_bus(bus, &r, res);
	if (r.start < region->start)
		r.start = region->start;
	if (r.end > region->end)
		r.end = region->end;

	if (r.end < r.start)
		res->end = res->start - 1;
	else
		pcibios_bus_to_resource(bus, res, &r);
}

static int pci_bus_alloc_from_region(struct pci_bus *bus, struct resource *res,
		resource_size_t size, resource_size_t align,
		resource_size_t min, unsigned long type_mask,
		resource_size_t (*alignf)(void *,
					  const struct resource *,
					  resource_size_t,
					  resource_size_t),
		void *alignf_data,
		struct pci_bus_region *region)
{
	int i, ret;
	struct resource *r, avail;
	resource_size_t max;

	type_mask |= IORESOURCE_TYPE_BITS;

	pci_bus_for_each_resource(bus, r, i) {
		resource_size_t min_used = min;

		if (!r)
			continue;

		/* type_mask must match */
		if ((res->flags ^ r->flags) & type_mask)
			continue;

		/* We cannot allocate a non-prefetching resource
		   from a pre-fetching area */
		if ((r->flags & IORESOURCE_PREFETCH) &&
		    !(res->flags & IORESOURCE_PREFETCH))
			continue;

		avail = *r;
		pci_clip_resource_to_region(bus, &avail, region);

		/*
		 * "min" is typically PCIBIOS_MIN_IO or PCIBIOS_MIN_MEM to
		 * protect badly documented motherboard resources, but if
		 * this is an already-configured bridge window, its start
		 * overrides "min".
		 */
		if (avail.start)
			min_used = avail.start;

		max = avail.end;

		/* Ok, try it out.. */
		ret = allocate_resource(r, res, size, min_used, max,
					align, alignf, alignf_data);
		if (ret == 0)
			return 0;
	}
	return -ENOMEM;
}

/**
 * pci_bus_alloc_resource - allocate a resource from a parent bus
 * @bus: PCI bus
 * @res: resource to allocate
 * @size: size of resource to allocate
 * @align: alignment of resource to allocate
 * @min: minimum /proc/iomem address to allocate
 * @type_mask: IORESOURCE_* type flags
 * @alignf: resource alignment function
 * @alignf_data: data argument for resource alignment function
 *
 * Given the PCI bus a device resides on, the size, minimum address,
 * alignment and type, try to find an acceptable resource allocation
 * for a specific device resource.
 */
int pci_bus_alloc_resource(struct pci_bus *bus, struct resource *res,
		resource_size_t size, resource_size_t align,
		resource_size_t min, unsigned long type_mask,
		resource_size_t (*alignf)(void *,
					  const struct resource *,
					  resource_size_t,
					  resource_size_t),
		void *alignf_data)
{
#ifdef CONFIG_PCI_BUS_ADDR_T_64BIT
	int rc;

	if (res->flags & IORESOURCE_MEM_64) {
		rc = pci_bus_alloc_from_region(bus, res, size, align, min,
					       type_mask, alignf, alignf_data,
					       &pci_high);
		if (rc == 0)
			return 0;

		return pci_bus_alloc_from_region(bus, res, size, align, min,
						 type_mask, alignf, alignf_data,
						 &pci_64_bit);
	}
#endif

	return pci_bus_alloc_from_region(bus, res, size, align, min,
					 type_mask, alignf, alignf_data,
					 &pci_32_bit);
}
EXPORT_SYMBOL(pci_bus_alloc_resource);

/*
 * The @idx resource of @dev should be a PCI-PCI bridge window.  If this
 * resource fits inside a window of an upstream bridge, do nothing.  If it
 * overlaps an upstream window but extends outside it, clip the resource so
 * it fits completely inside.
 */
bool pci_bus_clip_resource(struct pci_dev *dev, int idx)
{
	struct pci_bus *bus = dev->bus;
	struct resource *res = &dev->resource[idx];
	struct resource orig_res = *res;
	struct resource *r;
	int i;

	pci_bus_for_each_resource(bus, r, i) {
		resource_size_t start, end;

		if (!r)
			continue;

		if (resource_type(res) != resource_type(r))
			continue;

		start = max(r->start, res->start);
		end = min(r->end, res->end);

		if (start > end)
			continue;	/* no overlap */

		if (res->start == start && res->end == end)
			return false;	/* no change */

		res->start = start;
		res->end = end;
		res->flags &= ~IORESOURCE_UNSET;
		orig_res.flags &= ~IORESOURCE_UNSET;
		dev_printk(KERN_DEBUG, &dev->dev, "%pR clipped to %pR\n",
				 &orig_res, res);

		return true;
	}

	return false;
}

void __weak pcibios_resource_survey_bus(struct pci_bus *bus) { }

void __weak pcibios_bus_add_device(struct pci_dev *pdev) { }

/**
 * pci_bus_add_device - start driver for a single device
 * @dev: device to add
 *
 * This adds add sysfs entries and start device drivers
 */
void pci_bus_add_device(struct pci_dev *dev)
{
	int retval;

	/*
	 * Can not put in pci_device_add yet because resources
	 * are not assigned yet for some devices.
	 */
	pcibios_bus_add_device(dev);
	pci_fixup_device(pci_fixup_final, dev);
	pci_create_sysfs_dev_files(dev);
	pci_proc_attach_device(dev);

	dev->match_driver = true;
	retval = device_attach(&dev->dev);
	if (retval < 0 && retval != -EPROBE_DEFER) {
		dev_warn(&dev->dev, "device attach failed (%d)\n", retval);
		pci_proc_detach_device(dev);
		pci_remove_sysfs_dev_files(dev);
		return;
	}

	dev->is_added = 1;
}
EXPORT_SYMBOL_GPL(pci_bus_add_device);

/**
 * pci_bus_add_devices - start driver for PCI devices
 * @bus: bus to check for new devices
 *
 * Start driver for PCI devices and add some sysfs entries.
 */
void pci_bus_add_devices(const struct pci_bus *bus)
{
	struct pci_dev *dev;
	struct pci_bus *child;

	list_for_each_entry(dev, &bus->devices, bus_list) {
		/* Skip already-added devices */
		if (dev->is_added)
			continue;
		pci_bus_add_device(dev);
	}

	list_for_each_entry(dev, &bus->devices, bus_list) {
		/* Skip if device attach failed */
		if (!dev->is_added)
			continue;
		child = dev->subordinate;
		if (child)
			pci_bus_add_devices(child);
	}
}
EXPORT_SYMBOL(pci_bus_add_devices);

/** pci_walk_bus - walk devices on/under bus, calling callback.
 *  @top      bus whose devices should be walked
 *  @cb       callback to be called for each device found
 *  @userdata arbitrary pointer to be passed to callback.
 *
 *  Walk the given bus, including any bridged devices
 *  on buses under this bus.  Call the provided callback
 *  on each device found.
 *
 *  We check the return of @cb each time. If it returns anything
 *  other than 0, we break out.
 *
 */
void pci_walk_bus(struct pci_bus *top, int (*cb)(struct pci_dev *, void *),
		  void *userdata)
{
	struct pci_dev *dev;
	struct pci_bus *bus;
	struct list_head *next;
	int retval;

	bus = top;
	down_read(&pci_bus_sem);
	next = top->devices.next;
	for (;;) {
		if (next == &bus->devices) {
			/* end of this bus, go up or finish */
			if (bus == top)
				break;
			next = bus->self->bus_list.next;
			bus = bus->self->bus;
			continue;
		}
		dev = list_entry(next, struct pci_dev, bus_list);
		if (dev->subordinate) {
			/* this is a pci-pci bridge, do its devices next */
			next = dev->subordinate->devices.next;
			bus = dev->subordinate;
		} else
			next = dev->bus_list.next;

		retval = cb(dev, userdata);
		if (retval)
			break;
	}
	up_read(&pci_bus_sem);
}
EXPORT_SYMBOL_GPL(pci_walk_bus);

struct pci_bus *pci_bus_get(struct pci_bus *bus)
{
	if (bus)
		get_device(&bus->dev);
	return bus;
}
EXPORT_SYMBOL(pci_bus_get);

void pci_bus_put(struct pci_bus *bus)
{
	if (bus)
		put_device(&bus->dev);
}
EXPORT_SYMBOL(pci_bus_put);
Commit	Line	Data
1da177e4 LT	1	/*
	2	* drivers/pci/bus.c
	3	*
	4	* From setup-res.c, by:
	5	* Dave Rusling (david.rusling@reo.mts.dec.com)
	6	* David Mosberger (davidm@cs.arizona.edu)
	7	* David Miller (davem@redhat.com)
	8	* Ivan Kokshaysky (ink@jurassic.park.msu.ru)
	9	*/
	10	#include <linux/module.h>
	11	#include <linux/kernel.h>
	12	#include <linux/pci.h>
	13	#include <linux/errno.h>
	14	#include <linux/ioport.h>
	15	#include <linux/proc_fs.h>
5a0e3ad6	16	#include <linux/slab.h>
1da177e4 LT	17
	18	#include "pci.h"
	19
0efd5aab BH	20	void pci_add_resource_offset(struct list_head resources, struct resource res,
0efd5aab BH	21	resource_size_t offset)
45ca9e97	22	{
14d76b68	23	struct resource_entry *entry;
45ca9e97	24
14d76b68 JL	25	entry = resource_list_create_entry(res, 0);
14d76b68 JL	26	if (!entry) {
0efd5aab	27	printk(KERN_ERR "PCI: can't add host bridge window %pR\n", res);
45ca9e97 BH	28	return;
	29	}
	30
14d76b68 JL	31	entry->offset = offset;
14d76b68 JL	32	resource_list_add_tail(entry, resources);
0efd5aab BH	33	}
	34	EXPORT_SYMBOL(pci_add_resource_offset);
	35
	36	void pci_add_resource(struct list_head resources, struct resource res)
	37	{
	38	pci_add_resource_offset(resources, res, 0);
45ca9e97 BH	39	}
	40	EXPORT_SYMBOL(pci_add_resource);
	41
	42	void pci_free_resource_list(struct list_head *resources)
	43	{
14d76b68	44	resource_list_free(resources);
45ca9e97 BH	45	}
	46	EXPORT_SYMBOL(pci_free_resource_list);
	47
2fe2abf8 BH	48	void pci_bus_add_resource(struct pci_bus bus, struct resource res,
	49	unsigned int flags)
	50	{
	51	struct pci_bus_resource *bus_res;
	52
	53	bus_res = kzalloc(sizeof(struct pci_bus_resource), GFP_KERNEL);
	54	if (!bus_res) {
	55	dev_err(&bus->dev, "can't add %pR resource\n", res);
	56	return;
	57	}
	58
	59	bus_res->res = res;
	60	bus_res->flags = flags;
	61	list_add_tail(&bus_res->list, &bus->resources);
	62	}
	63
	64	struct resource pci_bus_resource_n(const struct pci_bus bus, int n)
	65	{
	66	struct pci_bus_resource *bus_res;
	67
	68	if (n < PCI_BRIDGE_RESOURCE_NUM)
	69	return bus->resource[n];
	70
	71	n -= PCI_BRIDGE_RESOURCE_NUM;
	72	list_for_each_entry(bus_res, &bus->resources, list) {
	73	if (n-- == 0)
	74	return bus_res->res;
	75	}
	76	return NULL;
	77	}
	78	EXPORT_SYMBOL_GPL(pci_bus_resource_n);
	79
	80	void pci_bus_remove_resources(struct pci_bus *bus)
	81	{
2fe2abf8	82	int i;
817a2685	83	struct pci_bus_resource bus_res, tmp;
2fe2abf8 BH	84
2fe2abf8 BH	85	for (i = 0; i < PCI_BRIDGE_RESOURCE_NUM; i++)
7736a05a	86	bus->resource[i] = NULL;
2fe2abf8	87
817a2685 YL	88	list_for_each_entry_safe(bus_res, tmp, &bus->resources, list) {
	89	list_del(&bus_res->list);
	90	kfree(bus_res);
	91	}
2fe2abf8 BH	92	}
2fe2abf8 BH	93
f75b99d5	94	static struct pci_bus_region pci_32_bit = {0, 0xffffffffULL};
3a9ad0b4	95	#ifdef CONFIG_PCI_BUS_ADDR_T_64BIT
f75b99d5	96	static struct pci_bus_region pci_64_bit = {0,
3a9ad0b4 YL	97	(pci_bus_addr_t) 0xffffffffffffffffULL};
	98	static struct pci_bus_region pci_high = {(pci_bus_addr_t) 0x100000000ULL,
	99	(pci_bus_addr_t) 0xffffffffffffffffULL};
f75b99d5 YL	100	#endif
	101
	102	/*
	103	* @res contains CPU addresses. Clip it so the corresponding bus addresses
	104	* on @bus are entirely within @region. This is used to control the bus
	105	* addresses of resources we allocate, e.g., we may need a resource that
	106	* can be mapped by a 32-bit BAR.
1da177e4	107	*/
f75b99d5 YL	108	static void pci_clip_resource_to_region(struct pci_bus *bus,
	109	struct resource *res,
	110	struct pci_bus_region *region)
	111	{
	112	struct pci_bus_region r;
	113
	114	pcibios_resource_to_bus(bus, &r, res);
	115	if (r.start < region->start)
	116	r.start = region->start;
	117	if (r.end > region->end)
	118	r.end = region->end;
	119
	120	if (r.end < r.start)
	121	res->end = res->start - 1;
	122	else
	123	pcibios_bus_to_resource(bus, res, &r);
	124	}
	125
	126	static int pci_bus_alloc_from_region(struct pci_bus bus, struct resource res,
e31dd6e4	127	resource_size_t size, resource_size_t align,
664c2848	128	resource_size_t min, unsigned long type_mask,
b26b2d49	129	resource_size_t (alignf)(void ,
3b7a17fc	130	const struct resource *,
b26b2d49 DB	131	resource_size_t,
b26b2d49 DB	132	resource_size_t),
f75b99d5 YL	133	void *alignf_data,
f75b99d5 YL	134	struct pci_bus_region *region)
1da177e4	135	{
f75b99d5 YL	136	int i, ret;
	137	struct resource *r, avail;
	138	resource_size_t max;
1da177e4	139
aa11fc58	140	type_mask \|= IORESOURCE_TYPE_BITS;
1da177e4	141
6db45b76	142	pci_bus_for_each_resource(bus, r, i) {
3460baa6 CB	143	resource_size_t min_used = min;
3460baa6 CB	144
6db45b76 BH	145	if (!r)
	146	continue;
	147
1da177e4 LT	148	/* type_mask must match */
	149	if ((res->flags ^ r->flags) & type_mask)
	150	continue;
	151
	152	/* We cannot allocate a non-prefetching resource
	153	from a pre-fetching area */
	154	if ((r->flags & IORESOURCE_PREFETCH) &&
	155	!(res->flags & IORESOURCE_PREFETCH))
	156	continue;
	157
f75b99d5 YL	158	avail = *r;
f75b99d5 YL	159	pci_clip_resource_to_region(bus, &avail, region);
f75b99d5	160
36e097a8 BH	161	/*
	162	* "min" is typically PCIBIOS_MIN_IO or PCIBIOS_MIN_MEM to
	163	* protect badly documented motherboard resources, but if
	164	* this is an already-configured bridge window, its start
	165	* overrides "min".
	166	*/
f75b99d5	167	if (avail.start)
3460baa6	168	min_used = avail.start;
f75b99d5 YL	169
f75b99d5 YL	170	max = avail.end;
36e097a8	171
1da177e4	172	/* Ok, try it out.. */
3460baa6	173	ret = allocate_resource(r, res, size, min_used, max,
36e097a8	174	align, alignf, alignf_data);
1da177e4	175	if (ret == 0)
f75b99d5	176	return 0;
1da177e4	177	}
f75b99d5 YL	178	return -ENOMEM;
	179	}
	180
	181	/**
	182	* pci_bus_alloc_resource - allocate a resource from a parent bus
	183	* @bus: PCI bus
	184	* @res: resource to allocate
	185	* @size: size of resource to allocate
	186	* @align: alignment of resource to allocate
	187	* @min: minimum /proc/iomem address to allocate
	188	* @type_mask: IORESOURCE_* type flags
	189	* @alignf: resource alignment function
	190	* @alignf_data: data argument for resource alignment function
	191	*
	192	* Given the PCI bus a device resides on, the size, minimum address,
	193	* alignment and type, try to find an acceptable resource allocation
	194	* for a specific device resource.
	195	*/
d56dbf5b	196	int pci_bus_alloc_resource(struct pci_bus bus, struct resource res,
f75b99d5	197	resource_size_t size, resource_size_t align,
664c2848	198	resource_size_t min, unsigned long type_mask,
f75b99d5 YL	199	resource_size_t (alignf)(void ,
	200	const struct resource *,
	201	resource_size_t,
	202	resource_size_t),
	203	void *alignf_data)
	204	{
3a9ad0b4	205	#ifdef CONFIG_PCI_BUS_ADDR_T_64BIT
d56dbf5b YL	206	int rc;
	207
	208	if (res->flags & IORESOURCE_MEM_64) {
	209	rc = pci_bus_alloc_from_region(bus, res, size, align, min,
	210	type_mask, alignf, alignf_data,
	211	&pci_high);
	212	if (rc == 0)
	213	return 0;
	214
f75b99d5 YL	215	return pci_bus_alloc_from_region(bus, res, size, align, min,
	216	type_mask, alignf, alignf_data,
	217	&pci_64_bit);
1da177e4	218	}
f75b99d5 YL	219	#endif
	220
	221	return pci_bus_alloc_from_region(bus, res, size, align, min,
	222	type_mask, alignf, alignf_data,
	223	&pci_32_bit);
1da177e4	224	}
b7fe9434	225	EXPORT_SYMBOL(pci_bus_alloc_resource);
1da177e4	226
0f7e7aee YL	227	/*
	228	* The @idx resource of @dev should be a PCI-PCI bridge window. If this
	229	* resource fits inside a window of an upstream bridge, do nothing. If it
	230	* overlaps an upstream window but extends outside it, clip the resource so
	231	* it fits completely inside.
	232	*/
	233	bool pci_bus_clip_resource(struct pci_dev *dev, int idx)
	234	{
	235	struct pci_bus *bus = dev->bus;
	236	struct resource *res = &dev->resource[idx];
	237	struct resource orig_res = *res;
	238	struct resource *r;
	239	int i;
	240
	241	pci_bus_for_each_resource(bus, r, i) {
	242	resource_size_t start, end;
	243
	244	if (!r)
	245	continue;
	246
	247	if (resource_type(res) != resource_type(r))
	248	continue;
	249
	250	start = max(r->start, res->start);
	251	end = min(r->end, res->end);
	252
	253	if (start > end)
	254	continue; /* no overlap */
	255
	256	if (res->start == start && res->end == end)
	257	return false; /* no change */
	258
	259	res->start = start;
	260	res->end = end;
b838b39e BH	261	res->flags &= ~IORESOURCE_UNSET;
b838b39e BH	262	orig_res.flags &= ~IORESOURCE_UNSET;
0f7e7aee YL	263	dev_printk(KERN_DEBUG, &dev->dev, "%pR clipped to %pR\n",
	264	&orig_res, res);
	265
	266	return true;
	267	}
	268
	269	return false;
	270	}
	271
3c449ed0 YL	272	void __weak pcibios_resource_survey_bus(struct pci_bus *bus) { }
3c449ed0 YL	273
7b77061f WY	274	void __weak pcibios_bus_add_device(struct pci_dev *pdev) { }
7b77061f WY	275
1da177e4	276	/**
4f535093	277	* pci_bus_add_device - start driver for a single device
1da177e4 LT	278	* @dev: device to add
1da177e4 LT	279	*
4f535093	280	* This adds add sysfs entries and start device drivers
1da177e4	281	*/
c893d133	282	void pci_bus_add_device(struct pci_dev *dev)
1da177e4	283	{
b19441af	284	int retval;
735bff10	285
4f535093 YL	286	/*
	287	* Can not put in pci_device_add yet because resources
	288	* are not assigned yet for some devices.
	289	*/
7b77061f	290	pcibios_bus_add_device(dev);
e253aaf0	291	pci_fixup_device(pci_fixup_final, dev);
4f535093	292	pci_create_sysfs_dev_files(dev);
ef37702e	293	pci_proc_attach_device(dev);
1da177e4	294
58d9a38f YL	295	dev->match_driver = true;
58d9a38f YL	296	retval = device_attach(&dev->dev);
9a2a5a63	297	if (retval < 0 && retval != -EPROBE_DEFER) {
ab1a187b BH	298	dev_warn(&dev->dev, "device attach failed (%d)\n", retval);
	299	pci_proc_detach_device(dev);
	300	pci_remove_sysfs_dev_files(dev);
	301	return;
	302	}
58d9a38f	303
8a1bc901	304	dev->is_added = 1;
876e501a	305	}
b7fe9434	306	EXPORT_SYMBOL_GPL(pci_bus_add_device);
876e501a	307
1da177e4	308	/**
4f535093	309	* pci_bus_add_devices - start driver for PCI devices
1da177e4 LT	310	* @bus: bus to check for new devices
1da177e4 LT	311	*
4f535093	312	* Start driver for PCI devices and add some sysfs entries.
1da177e4	313	*/
c48f1670	314	void pci_bus_add_devices(const struct pci_bus *bus)
1da177e4 LT	315	{
1da177e4 LT	316	struct pci_dev *dev;
3fa16fdb	317	struct pci_bus *child;
1da177e4 LT	318
1da177e4 LT	319	list_for_each_entry(dev, &bus->devices, bus_list) {
8a1bc901 GKH	320	/* Skip already-added devices */
8a1bc901 GKH	321	if (dev->is_added)
1da177e4	322	continue;
c893d133	323	pci_bus_add_device(dev);
1da177e4 LT	324	}
	325
	326	list_for_each_entry(dev, &bus->devices, bus_list) {
1e398eae LW	327	/* Skip if device attach failed */
	328	if (!dev->is_added)
	329	continue;
3fa16fdb	330	child = dev->subordinate;
981cf9ea JL	331	if (child)
981cf9ea JL	332	pci_bus_add_devices(child);
1da177e4 LT	333	}
1da177e4 LT	334	}
b7fe9434	335	EXPORT_SYMBOL(pci_bus_add_devices);
1da177e4	336
cecf4864 PM	337	/** pci_walk_bus - walk devices on/under bus, calling callback.
	338	* @top bus whose devices should be walked
	339	* @cb callback to be called for each device found
	340	* @userdata arbitrary pointer to be passed to callback.
	341	*
	342	* Walk the given bus, including any bridged devices
	343	* on buses under this bus. Call the provided callback
	344	* on each device found.
70298c6e ZY	345	*
	346	* We check the return of @cb each time. If it returns anything
	347	* other than 0, we break out.
	348	*
cecf4864	349	*/
70298c6e	350	void pci_walk_bus(struct pci_bus top, int (cb)(struct pci_dev , void ),
cecf4864 PM	351	void *userdata)
	352	{
	353	struct pci_dev *dev;
	354	struct pci_bus *bus;
	355	struct list_head *next;
70298c6e	356	int retval;
cecf4864 PM	357
cecf4864 PM	358	bus = top;
d71374da	359	down_read(&pci_bus_sem);
cecf4864 PM	360	next = top->devices.next;
	361	for (;;) {
	362	if (next == &bus->devices) {
	363	/* end of this bus, go up or finish */
	364	if (bus == top)
	365	break;
	366	next = bus->self->bus_list.next;
	367	bus = bus->self->bus;
	368	continue;
	369	}
	370	dev = list_entry(next, struct pci_dev, bus_list);
cecf4864 PM	371	if (dev->subordinate) {
	372	/* this is a pci-pci bridge, do its devices next */
	373	next = dev->subordinate->devices.next;
	374	bus = dev->subordinate;
	375	} else
	376	next = dev->bus_list.next;
cecf4864	377
70298c6e	378	retval = cb(dev, userdata);
70298c6e ZY	379	if (retval)
70298c6e ZY	380	break;
cecf4864	381	}
d71374da	382	up_read(&pci_bus_sem);
cecf4864	383	}
7c94def8	384	EXPORT_SYMBOL_GPL(pci_walk_bus);
cecf4864	385
fe830ef6 JL	386	struct pci_bus pci_bus_get(struct pci_bus bus)
	387	{
	388	if (bus)
	389	get_device(&bus->dev);
	390	return bus;
	391	}
	392	EXPORT_SYMBOL(pci_bus_get);
	393
	394	void pci_bus_put(struct pci_bus *bus)
	395	{
	396	if (bus)
	397	put_device(&bus->dev);
	398	}
	399	EXPORT_SYMBOL(pci_bus_put);
	400