cregit-Linux how code gets into the kernel

Release 4.7 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>
 *
 */

#include <linux/module.h>
#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 <asm/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;


#define DRIVER_VERSION	"0.5"

#define DRIVER_AUTHOR	"Greg Kroah-Hartman <greg@kroah.com>, Scott Murray <scottm@somanetworks.com>"

#define DRIVER_DESC	"PCI Hot Plug PCI Core"


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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds3060.00%120.00%
stanley wangstanley wang1224.00%120.00%
alex chiangalex chiang36.00%120.00%
ryan desfossesryan desfosses36.00%120.00%
wang yijingwang yijing24.00%120.00%
Total50100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds13074.29%120.00%
greg kroah-hartmangreg kroah-hartman3218.29%240.00%
alex chiangalex chiang116.29%120.00%
stanley wangstanley wang21.14%120.00%
Total175100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds2346.00%120.00%
stanley wangstanley wang1938.00%120.00%
ryan desfossesryan desfosses36.00%120.00%
alex chiangalex chiang36.00%120.00%
wang yijingwang yijing24.00%120.00%
Total50100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds9472.87%116.67%
greg kroah-hartmangreg kroah-hartman1511.63%116.67%
alex chiangalex chiang1310.08%116.67%
wang yijingwang yijing32.33%116.67%
christoph hellwigchristoph hellwig21.55%116.67%
stanley wangstanley wang21.55%116.67%
Total129100.00%6100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds2346.00%120.00%
stanley wangstanley wang1938.00%120.00%
alex chiangalex chiang36.00%120.00%
ryan desfossesryan desfosses36.00%120.00%
wang yijingwang yijing24.00%120.00%
Total50100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds4080.00%120.00%
alex chiangalex chiang36.00%120.00%
ryan desfossesryan desfosses36.00%120.00%
wang yijingwang yijing24.00%120.00%
stanley wangstanley wang24.00%120.00%
Total50100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds6548.87%116.67%
greg kroah-hartmangreg kroah-hartman5339.85%233.33%
alex chiangalex chiang118.27%116.67%
stanley wangstanley wang21.50%116.67%
christoph hellwigchristoph hellwig21.50%116.67%
Total133100.00%6100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman4869.57%233.33%
alex chiangalex chiang1115.94%116.67%
stanley wangstanley wang57.25%116.67%
kenji kaneshigekenji kaneshige45.80%116.67%
linus torvaldslinus torvalds11.45%116.67%
Total69100.00%6100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman4472.13%233.33%
alex chiangalex chiang1118.03%116.67%
kenji kaneshigekenji kaneshige46.56%116.67%
linus torvaldslinus torvalds11.64%116.67%
stanley wangstanley wang11.64%116.67%
Total61100.00%6100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman3466.67%233.33%
alex chiangalex chiang1121.57%116.67%
kenji kaneshigekenji kaneshige47.84%116.67%
linus torvaldslinus torvalds11.96%116.67%
stanley wangstanley wang11.96%116.67%
Total51100.00%6100.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

PersonTokensPropCommitsCommitProp
takayoshi kouchi*takayoshi kouchi*3262.75%125.00%
alex chiangalex chiang815.69%125.00%
greg kroah-hartmangreg kroah-hartman713.73%125.00%
kenji kaneshigekenji kaneshige47.84%125.00%
Total51100.00%4100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman2854.90%120.00%
alex chiangalex chiang1121.57%120.00%
stanley wangstanley wang611.76%120.00%
kenji kaneshigekenji kaneshige47.84%120.00%
linus torvaldslinus torvalds23.92%120.00%
Total51100.00%5100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman21677.14%225.00%
wang yijingwang yijing217.50%112.50%
takayoshi kouchi*takayoshi kouchi*165.71%112.50%
alex chiangalex chiang145.00%112.50%
kenji kaneshigekenji kaneshige93.21%112.50%
stanley wangstanley wang20.71%112.50%
linus torvaldslinus torvalds20.71%112.50%
Total280100.00%8100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman5446.55%116.67%
stanley wangstanley wang2521.55%116.67%
linus torvaldslinus torvalds2017.24%116.67%
wang yijingwang yijing1210.34%116.67%
kenji kaneshigekenji kaneshige43.45%116.67%
alex chiangalex chiang10.86%116.67%
Total116100.00%6100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds3572.92%120.00%
alex chiangalex chiang510.42%240.00%
geliang tanggeliang tang48.33%120.00%
kenji kaneshigekenji kaneshige48.33%120.00%
Total48100.00%5100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds7235.12%17.14%
kenji kaneshigekenji kaneshige5024.39%321.43%
alex chiangalex chiang4622.44%535.71%
greg kroah-hartmangreg kroah-hartman3617.56%428.57%
ryan desfossesryan desfosses10.49%17.14%
Total205100.00%14100.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

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds5344.54%116.67%
alex chiangalex chiang2924.37%233.33%
kenji kaneshigekenji kaneshige2016.81%116.67%
wang yijingwang yijing1411.76%116.67%
stanley wangstanley wang32.52%116.67%
Total119100.00%6100.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

PersonTokensPropCommitsCommitProp
greg kroah-hartmangreg kroah-hartman2555.56%240.00%
linus torvaldslinus torvalds1533.33%120.00%
wang yijingwang yijing36.67%120.00%
alex chiangalex chiang24.44%120.00%
Total45100.00%5100.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; } info(DRIVER_DESC " version: " DRIVER_VERSION "\n"); return result; }

Contributors

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds2350.00%133.33%
greg kroah-hartmangreg kroah-hartman2043.48%133.33%
ryan desfossesryan desfosses36.52%133.33%
Total46100.00%3100.00%


static void __exit pci_hotplug_exit(void) { cpci_hotplug_exit(); }

Contributors

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds975.00%150.00%
stanley wangstanley wang325.00%150.00%
Total12100.00%2100.00%

module_init(pci_hotplug_init); module_exit(pci_hotplug_exit); MODULE_AUTHOR(DRIVER_AUTHOR); MODULE_DESCRIPTION(DRIVER_DESC); MODULE_LICENSE("GPL"); module_param(debug, bool, 0644); MODULE_PARM_DESC(debug, "Debugging mode enabled or not");

Overall Contributors

PersonTokensPropCommitsCommitProp
linus torvaldslinus torvalds77335.61%12.56%
greg kroah-hartmangreg kroah-hartman62928.97%1333.33%
stanley wangstanley wang28513.13%12.56%
alex chiangalex chiang2049.40%615.38%
kenji kaneshigekenji kaneshige1125.16%410.26%
wang yijingwang yijing632.90%12.56%
takayoshi kouchi*takayoshi kouchi*482.21%12.56%
ryan desfossesryan desfosses321.47%37.69%
rolf eike beerrolf eike beer60.28%12.56%
bogicevic sasabogicevic sasa40.18%12.56%
geliang tanggeliang tang40.18%12.56%
christoph hellwigchristoph hellwig40.18%12.56%
bjorn helgaasbjorn helgaas30.14%12.56%
rusty russellrusty russell20.09%25.13%
kristen carlson accardikristen carlson accardi10.05%12.56%
randy dunlaprandy dunlap10.05%12.56%
Total2171100.00%39100.00%
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
{% endraw %}