Release 4.11 drivers/pci/hotplug/pci_hotplug_core.c

/*
 * PCI HotPlug Controller Core
 *
 * Copyright (C) 2001-2002 Greg Kroah-Hartman (greg@kroah.com)
 * Copyright (C) 2001-2002 IBM Corp.
 *
 * All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or (at
 * your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
 * NON INFRINGEMENT.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 * Send feedback to <kristen.c.accardi@intel.com>
 *
 * Authors:
 *   Greg Kroah-Hartman <greg@kroah.com>
 *   Scott Murray <scottm@somanetworks.com>
 */

#include <linux/module.h>	/* try_module_get & module_put */
#include <linux/moduleparam.h>
#include <linux/kernel.h>
#include <linux/types.h>
#include <linux/list.h>
#include <linux/kobject.h>
#include <linux/sysfs.h>
#include <linux/pagemap.h>
#include <linux/init.h>
#include <linux/mount.h>
#include <linux/namei.h>
#include <linux/mutex.h>
#include <linux/pci.h>
#include <linux/pci_hotplug.h>
#include <linux/uaccess.h>
#include "../pci.h"
#include "cpci_hotplug.h"


#define MY_NAME	"pci_hotplug"


#define dbg(fmt, arg...) do { if (debug) printk(KERN_DEBUG "%s: %s: " fmt, MY_NAME, __func__, ## arg); } while (0)

#define err(format, arg...) printk(KERN_ERR "%s: " format, MY_NAME, ## arg)

#define info(format, arg...) printk(KERN_INFO "%s: " format, MY_NAME, ## arg)

#define warn(format, arg...) printk(KERN_WARNING "%s: " format, MY_NAME, ## arg)

/* local variables */

static bool debug;

static LIST_HEAD(pci_hotplug_slot_list);
static DEFINE_MUTEX(pci_hp_mutex);

/* Weee, fun with macros... */

#define GET_STATUS(name, type)	\
static int get_##name(struct hotplug_slot *slot, type *value)           \
{                                                                       \
        struct hotplug_slot_ops *ops = slot->ops;                       \
        int retval = 0;                                                 \
        if (!try_module_get(ops->owner))                                \
                return -ENODEV;                                         \
        if (ops->get_##name)                                            \
                retval = ops->get_##name(slot, value);                  \
        else                                                            \
                *value = slot->info->name;                              \
        module_put(ops->owner);                                         \
        return retval;                                                  \
}

GET_STATUS(power_status, u8)
GET_STATUS(attention_status, u8)
GET_STATUS(latch_status, u8)
GET_STATUS(adapter_status, u8)



static ssize_t power_read_file(struct pci_slot *pci_slot, char *buf)
{
	int retval;
	u8 value;

	retval = get_power_status(pci_slot->hotplug, &value);
	if (retval)
		return retval;

	return sprintf(buf, "%d\n", value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
30
60.00%
1
20.00%
Stanley Wang
12
24.00%
1
20.00%
Alexander Chiang
3
6.00%
1
20.00%
Ryan Desfosses
3
6.00%
1
20.00%
Yijing Wang
2
4.00%
1
20.00%
Total
50
100.00%
5
100.00%



static ssize_t power_write_file(struct pci_slot *pci_slot, const char *buf,
				size_t count)
{
	struct hotplug_slot *slot = pci_slot->hotplug;
	unsigned long lpower;
	u8 power;
	int retval = 0;

	lpower = simple_strtoul(buf, NULL, 10);
	power = (u8)(lpower & 0xff);
	dbg("power = %d\n", power);

	if (!try_module_get(slot->ops->owner)) {
		retval = -ENODEV;
		goto exit;
	}
	switch (power) {
	case 0:
		if (slot->ops->disable_slot)
			retval = slot->ops->disable_slot(slot);
		break;

	case 1:
		if (slot->ops->enable_slot)
			retval = slot->ops->enable_slot(slot);
		break;

	default:
		err("Illegal value specified for power\n");
		retval = -EINVAL;
	}
	module_put(slot->ops->owner);

exit:
	if (retval)
		return retval;
	return count;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
130
74.29%
1
20.00%
Greg Kroah-Hartman
32
18.29%
2
40.00%
Alexander Chiang
11
6.29%
1
20.00%
Stanley Wang
2
1.14%
1
20.00%
Total
175
100.00%
5
100.00%


static struct pci_slot_attribute hotplug_slot_attr_power = {
	.attr = {.name = "power", .mode = S_IFREG | S_IRUGO | S_IWUSR},
	.show = power_read_file,
	.store = power_write_file
};



static ssize_t attention_read_file(struct pci_slot *pci_slot, char *buf)
{
	int retval;
	u8 value;

	retval = get_attention_status(pci_slot->hotplug, &value);
	if (retval)
		return retval;

	return sprintf(buf, "%d\n", value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
23
46.00%
1
20.00%
Stanley Wang
19
38.00%
1
20.00%
Ryan Desfosses
3
6.00%
1
20.00%
Alexander Chiang
3
6.00%
1
20.00%
Yijing Wang
2
4.00%
1
20.00%
Total
50
100.00%
5
100.00%



static ssize_t attention_write_file(struct pci_slot *pci_slot, const char *buf,
				    size_t count)
{
	struct hotplug_slot_ops *ops = pci_slot->hotplug->ops;
	unsigned long lattention;
	u8 attention;
	int retval = 0;

	lattention = simple_strtoul(buf, NULL, 10);
	attention = (u8)(lattention & 0xff);
	dbg(" - attention = %d\n", attention);

	if (!try_module_get(ops->owner)) {
		retval = -ENODEV;
		goto exit;
	}
	if (ops->set_attention_status)
		retval = ops->set_attention_status(pci_slot->hotplug, attention);
	module_put(ops->owner);

exit:
	if (retval)
		return retval;
	return count;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
94
72.87%
1
16.67%
Greg Kroah-Hartman
15
11.63%
1
16.67%
Alexander Chiang
13
10.08%
1
16.67%
Yijing Wang
3
2.33%
1
16.67%
Christoph Hellwig
2
1.55%
1
16.67%
Stanley Wang
2
1.55%
1
16.67%
Total
129
100.00%
6
100.00%


static struct pci_slot_attribute hotplug_slot_attr_attention = {
	.attr = {.name = "attention", .mode = S_IFREG | S_IRUGO | S_IWUSR},
	.show = attention_read_file,
	.store = attention_write_file
};



static ssize_t latch_read_file(struct pci_slot *pci_slot, char *buf)
{
	int retval;
	u8 value;

	retval = get_latch_status(pci_slot->hotplug, &value);
	if (retval)
		return retval;

	return sprintf(buf, "%d\n", value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
23
46.00%
1
20.00%
Stanley Wang
19
38.00%
1
20.00%
Alexander Chiang
3
6.00%
1
20.00%
Ryan Desfosses
3
6.00%
1
20.00%
Yijing Wang
2
4.00%
1
20.00%
Total
50
100.00%
5
100.00%


static struct pci_slot_attribute hotplug_slot_attr_latch = {
	.attr = {.name = "latch", .mode = S_IFREG | S_IRUGO},
	.show = latch_read_file,
};



static ssize_t presence_read_file(struct pci_slot *pci_slot, char *buf)
{
	int retval;
	u8 value;

	retval = get_adapter_status(pci_slot->hotplug, &value);
	if (retval)
		return retval;

	return sprintf(buf, "%d\n", value);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
40
80.00%
1
20.00%
Ryan Desfosses
3
6.00%
1
20.00%
Alexander Chiang
3
6.00%
1
20.00%
Yijing Wang
2
4.00%
1
20.00%
Stanley Wang
2
4.00%
1
20.00%
Total
50
100.00%
5
100.00%


static struct pci_slot_attribute hotplug_slot_attr_presence = {
	.attr = {.name = "adapter", .mode = S_IFREG | S_IRUGO},
	.show = presence_read_file,
};



static ssize_t test_write_file(struct pci_slot *pci_slot, const char *buf,
			       size_t count)
{
	struct hotplug_slot *slot = pci_slot->hotplug;
	unsigned long ltest;
	u32 test;
	int retval = 0;

	ltest = simple_strtoul(buf, NULL, 10);
	test = (u32)(ltest & 0xffffffff);
	dbg("test = %d\n", test);

	if (!try_module_get(slot->ops->owner)) {
		retval = -ENODEV;
		goto exit;
	}
	if (slot->ops->hardware_test)
		retval = slot->ops->hardware_test(slot, test);
	module_put(slot->ops->owner);

exit:
	if (retval)
		return retval;
	return count;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
65
48.87%
1
16.67%
Greg Kroah-Hartman
53
39.85%
2
33.33%
Alexander Chiang
11
8.27%
1
16.67%
Christoph Hellwig
2
1.50%
1
16.67%
Stanley Wang
2
1.50%
1
16.67%
Total
133
100.00%
6
100.00%


static struct pci_slot_attribute hotplug_slot_attr_test = {
	.attr = {.name = "test", .mode = S_IFREG | S_IRUGO | S_IWUSR},
	.store = test_write_file
};



static bool has_power_file(struct pci_slot *pci_slot)
{
	struct hotplug_slot *slot = pci_slot->hotplug;

	if ((!slot) || (!slot->ops))
		return false;
	if ((slot->ops->enable_slot) ||
	    (slot->ops->disable_slot) ||
	    (slot->ops->get_power_status))
		return true;
	return false;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
48
69.57%
2
33.33%
Alexander Chiang
11
15.94%
1
16.67%
Stanley Wang
5
7.25%
1
16.67%
Kenji Kaneshige
4
5.80%
1
16.67%
Linus Torvalds
1
1.45%
1
16.67%
Total
69
100.00%
6
100.00%



static bool has_attention_file(struct pci_slot *pci_slot)
{
	struct hotplug_slot *slot = pci_slot->hotplug;

	if ((!slot) || (!slot->ops))
		return false;
	if ((slot->ops->set_attention_status) ||
	    (slot->ops->get_attention_status))
		return true;
	return false;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
44
72.13%
2
33.33%
Alexander Chiang
11
18.03%
1
16.67%
Kenji Kaneshige
4
6.56%
1
16.67%
Stanley Wang
1
1.64%
1
16.67%
Linus Torvalds
1
1.64%
1
16.67%
Total
61
100.00%
6
100.00%



static bool has_latch_file(struct pci_slot *pci_slot)
{
	struct hotplug_slot *slot = pci_slot->hotplug;

	if ((!slot) || (!slot->ops))
		return false;
	if (slot->ops->get_latch_status)
		return true;
	return false;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
34
66.67%
2
33.33%
Alexander Chiang
11
21.57%
1
16.67%
Kenji Kaneshige
4
7.84%
1
16.67%
Linus Torvalds
1
1.96%
1
16.67%
Stanley Wang
1
1.96%
1
16.67%
Total
51
100.00%
6
100.00%



static bool has_adapter_file(struct pci_slot *pci_slot)
{
	struct hotplug_slot *slot = pci_slot->hotplug;

	if ((!slot) || (!slot->ops))
		return false;
	if (slot->ops->get_adapter_status)
		return true;
	return false;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Takayoshi Kouchi
32
62.75%
1
25.00%
Alexander Chiang
8
15.69%
1
25.00%
Greg Kroah-Hartman
7
13.73%
1
25.00%
Kenji Kaneshige
4
7.84%
1
25.00%
Total
51
100.00%
4
100.00%



static bool has_test_file(struct pci_slot *pci_slot)
{
	struct hotplug_slot *slot = pci_slot->hotplug;

	if ((!slot) || (!slot->ops))
		return false;
	if (slot->ops->hardware_test)
		return true;
	return false;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
28
54.90%
1
20.00%
Alexander Chiang
11
21.57%
1
20.00%
Stanley Wang
6
11.76%
1
20.00%
Kenji Kaneshige
4
7.84%
1
20.00%
Linus Torvalds
2
3.92%
1
20.00%
Total
51
100.00%
5
100.00%



static int fs_add_slot(struct pci_slot *pci_slot)
{
	int retval = 0;

	/* Create symbolic link to the hotplug driver module */
	pci_hp_create_module_link(pci_slot);

	if (has_power_file(pci_slot)) {
		retval = sysfs_create_file(&pci_slot->kobj,
					   &hotplug_slot_attr_power.attr);
		if (retval)
			goto exit_power;
	}

	if (has_attention_file(pci_slot)) {
		retval = sysfs_create_file(&pci_slot->kobj,
					   &hotplug_slot_attr_attention.attr);
		if (retval)
			goto exit_attention;
	}

	if (has_latch_file(pci_slot)) {
		retval = sysfs_create_file(&pci_slot->kobj,
					   &hotplug_slot_attr_latch.attr);
		if (retval)
			goto exit_latch;
	}

	if (has_adapter_file(pci_slot)) {
		retval = sysfs_create_file(&pci_slot->kobj,
					   &hotplug_slot_attr_presence.attr);
		if (retval)
			goto exit_adapter;
	}

	if (has_test_file(pci_slot)) {
		retval = sysfs_create_file(&pci_slot->kobj,
					   &hotplug_slot_attr_test.attr);
		if (retval)
			goto exit_test;
	}

	goto exit;

exit_test:
	if (has_adapter_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj,
				  &hotplug_slot_attr_presence.attr);
exit_adapter:
	if (has_latch_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);
exit_latch:
	if (has_attention_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj,
				  &hotplug_slot_attr_attention.attr);
exit_attention:
	if (has_power_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);
exit_power:
	pci_hp_remove_module_link(pci_slot);
exit:
	return retval;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
216
77.14%
2
25.00%
Yijing Wang
21
7.50%
1
12.50%
Takayoshi Kouchi
16
5.71%
1
12.50%
Alexander Chiang
14
5.00%
1
12.50%
Kenji Kaneshige
9
3.21%
1
12.50%
Linus Torvalds
2
0.71%
1
12.50%
Stanley Wang
2
0.71%
1
12.50%
Total
280
100.00%
8
100.00%



static void fs_remove_slot(struct pci_slot *pci_slot)
{
	if (has_power_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);

	if (has_attention_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj,
				  &hotplug_slot_attr_attention.attr);

	if (has_latch_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);

	if (has_adapter_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj,
				  &hotplug_slot_attr_presence.attr);

	if (has_test_file(pci_slot))
		sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_test.attr);

	pci_hp_remove_module_link(pci_slot);
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
54
46.55%
1
16.67%
Stanley Wang
25
21.55%
1
16.67%
Linus Torvalds
20
17.24%
1
16.67%
Yijing Wang
12
10.34%
1
16.67%
Kenji Kaneshige
4
3.45%
1
16.67%
Alexander Chiang
1
0.86%
1
16.67%
Total
116
100.00%
6
100.00%



static struct hotplug_slot *get_slot_from_name(const char *name)
{
	struct hotplug_slot *slot;

	list_for_each_entry(slot, &pci_hotplug_slot_list, slot_list) {
		if (strcmp(hotplug_slot_name(slot), name) == 0)
			return slot;
	}
	return NULL;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
35
72.92%
1
20.00%
Alexander Chiang
5
10.42%
2
40.00%
Geliang Tang
4
8.33%
1
20.00%
Kenji Kaneshige
4
8.33%
1
20.00%
Total
48
100.00%
5
100.00%

/**
 * __pci_hp_register - register a hotplug_slot with the PCI hotplug subsystem
 * @bus: bus this slot is on
 * @slot: pointer to the &struct hotplug_slot to register
 * @devnr: device number
 * @name: name registered with kobject core
 * @owner: caller module owner
 * @mod_name: caller module name
 *
 * Registers a hotplug slot with the pci hotplug subsystem, which will allow
 * userspace interaction to the slot.
 *
 * Returns 0 if successful, anything else for an error.
 */


int __pci_hp_register(struct hotplug_slot *slot, struct pci_bus *bus,
		      int devnr, const char *name,
		      struct module *owner, const char *mod_name)
{
	int result;
	struct pci_slot *pci_slot;

	if (slot == NULL)
		return -ENODEV;
	if ((slot->info == NULL) || (slot->ops == NULL))
		return -EINVAL;
	if (slot->release == NULL) {
		dbg("Why are you trying to register a hotplug slot without a proper release function?\n");
		return -EINVAL;
	}

	slot->ops->owner = owner;
	slot->ops->mod_name = mod_name;

	mutex_lock(&pci_hp_mutex);
	/*
         * No problems if we call this interface from both ACPI_PCI_SLOT
         * driver and call it here again. If we've already created the
         * pci_slot, the interface will simply bump the refcount.
         */
	pci_slot = pci_create_slot(bus, devnr, name, slot);
	if (IS_ERR(pci_slot)) {
		result = PTR_ERR(pci_slot);
		goto out;
	}

	slot->pci_slot = pci_slot;
	pci_slot->hotplug = slot;

	list_add(&slot->slot_list, &pci_hotplug_slot_list);

	result = fs_add_slot(pci_slot);
	kobject_uevent(&pci_slot->kobj, KOBJ_ADD);
	dbg("Added slot %s to the list\n", name);
out:
	mutex_unlock(&pci_hp_mutex);
	return result;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
72
35.12%
1
7.14%
Kenji Kaneshige
50
24.39%
3
21.43%
Alexander Chiang
46
22.44%
5
35.71%
Greg Kroah-Hartman
36
17.56%
4
28.57%
Ryan Desfosses
1
0.49%
1
7.14%
Total
205
100.00%
14
100.00%


EXPORT_SYMBOL_GPL(__pci_hp_register);

/**
 * pci_hp_deregister - deregister a hotplug_slot with the PCI hotplug subsystem
 * @slot: pointer to the &struct hotplug_slot to deregister
 *
 * The @slot must have been registered with the pci hotplug subsystem
 * previously with a call to pci_hp_register().
 *
 * Returns 0 if successful, anything else for an error.
 */


int pci_hp_deregister(struct hotplug_slot *slot)
{
	struct hotplug_slot *temp;
	struct pci_slot *pci_slot;

	if (!slot)
		return -ENODEV;

	mutex_lock(&pci_hp_mutex);
	temp = get_slot_from_name(hotplug_slot_name(slot));
	if (temp != slot) {
		mutex_unlock(&pci_hp_mutex);
		return -ENODEV;
	}

	list_del(&slot->slot_list);

	pci_slot = slot->pci_slot;
	fs_remove_slot(pci_slot);
	dbg("Removed slot %s from the list\n", hotplug_slot_name(slot));

	slot->release(slot);
	pci_slot->hotplug = NULL;
	pci_destroy_slot(pci_slot);
	mutex_unlock(&pci_hp_mutex);

	return 0;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
53
44.54%
1
16.67%
Alexander Chiang
29
24.37%
2
33.33%
Kenji Kaneshige
20
16.81%
1
16.67%
Yijing Wang
14
11.76%
1
16.67%
Stanley Wang
3
2.52%
1
16.67%
Total
119
100.00%
6
100.00%


EXPORT_SYMBOL_GPL(pci_hp_deregister);

/**
 * pci_hp_change_slot_info - changes the slot's information structure in the core
 * @slot: pointer to the slot whose info has changed
 * @info: pointer to the info copy into the slot's info structure
 *
 * @slot must have been registered with the pci
 * hotplug subsystem previously with a call to pci_hp_register().
 *
 * Returns 0 if successful, anything else for an error.
 */


int pci_hp_change_slot_info(struct hotplug_slot *slot,
			    struct hotplug_slot_info *info)
{
	if (!slot || !info)
		return -ENODEV;

	memcpy(slot->info, info, sizeof(struct hotplug_slot_info));

	return 0;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
25
55.56%
2
40.00%
Linus Torvalds
15
33.33%
1
20.00%
Yijing Wang
3
6.67%
1
20.00%
Alexander Chiang
2
4.44%
1
20.00%
Total
45
100.00%
5
100.00%


EXPORT_SYMBOL_GPL(pci_hp_change_slot_info);



static int __init pci_hotplug_init(void)
{
	int result;

	result = cpci_hotplug_init(debug);
	if (result) {
		err("cpci_hotplug_init with error %d\n", result);
		return result;
	}

	return result;
}
Contributors
Person
Tokens
Prop
Commits
CommitProp
Greg Kroah-Hartman
20
52.63%
1
33.33%
Linus Torvalds
15
39.47%
1
33.33%
Ryan Desfosses
3
7.89%
1
33.33%
Total
38
100.00%
3
100.00%


device_initcall(pci_hotplug_init);

/*
 * not really modular, but the easiest way to keep compat with existing
 * bootargs behaviour is to continue using module_param here.
 */
module_param(debug, bool, 0644);
MODULE_PARM_DESC(debug, "Debugging mode enabled or not");
Overall Contributors
Person
Tokens
Prop
Commits
CommitProp
Linus Torvalds
726
34.23%
2
4.88%
Greg Kroah-Hartman
626
29.51%
13
31.71%
Stanley Wang
282
13.30%
1
2.44%
Alexander Chiang
204
9.62%
6
14.63%
Kenji Kaneshige
112
5.28%
4
9.76%
Yijing Wang
63
2.97%
1
2.44%
Takayoshi Kouchi
48
2.26%
1
2.44%
Ryan Desfosses
32
1.51%
3
7.32%
Rolf Eike Beer
6
0.28%
1
2.44%
Christoph Hellwig
4
0.19%
1
2.44%
Björn Helgaas
4
0.19%
2
4.88%
Geliang Tang
4
0.19%
1
2.44%
Bogicevic Sasa
4
0.19%
1
2.44%
Paul Gortmaker
3
0.14%
1
2.44%
Rusty Russell
2
0.09%
2
4.88%
Randy Dunlap
1
0.05%
1
2.44%
Total
2121
100.00%
41
100.00%
Directory: drivers/pci/hotplug

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.