Loading...
1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * PCI HotPlug Controller Core
4 *
5 * Copyright (C) 2001-2002 Greg Kroah-Hartman (greg@kroah.com)
6 * Copyright (C) 2001-2002 IBM Corp.
7 *
8 * All rights reserved.
9 *
10 * Send feedback to <kristen.c.accardi@intel.com>
11 *
12 * Authors:
13 * Greg Kroah-Hartman <greg@kroah.com>
14 * Scott Murray <scottm@somanetworks.com>
15 */
16
17#include <linux/module.h> /* try_module_get & module_put */
18#include <linux/moduleparam.h>
19#include <linux/kernel.h>
20#include <linux/types.h>
21#include <linux/list.h>
22#include <linux/kobject.h>
23#include <linux/sysfs.h>
24#include <linux/pagemap.h>
25#include <linux/init.h>
26#include <linux/mount.h>
27#include <linux/namei.h>
28#include <linux/mutex.h>
29#include <linux/pci.h>
30#include <linux/pci_hotplug.h>
31#include <linux/uaccess.h>
32#include "../pci.h"
33#include "cpci_hotplug.h"
34
35#define MY_NAME "pci_hotplug"
36
37#define dbg(fmt, arg...) do { if (debug) printk(KERN_DEBUG "%s: %s: " fmt, MY_NAME, __func__, ## arg); } while (0)
38#define err(format, arg...) printk(KERN_ERR "%s: " format, MY_NAME, ## arg)
39#define info(format, arg...) printk(KERN_INFO "%s: " format, MY_NAME, ## arg)
40#define warn(format, arg...) printk(KERN_WARNING "%s: " format, MY_NAME, ## arg)
41
42/* local variables */
43static bool debug;
44
45static LIST_HEAD(pci_hotplug_slot_list);
46static DEFINE_MUTEX(pci_hp_mutex);
47
48/* Weee, fun with macros... */
49#define GET_STATUS(name, type) \
50static int get_##name(struct hotplug_slot *slot, type *value) \
51{ \
52 const struct hotplug_slot_ops *ops = slot->ops; \
53 int retval = 0; \
54 if (!try_module_get(slot->owner)) \
55 return -ENODEV; \
56 if (ops->get_##name) \
57 retval = ops->get_##name(slot, value); \
58 module_put(slot->owner); \
59 return retval; \
60}
61
62GET_STATUS(power_status, u8)
63GET_STATUS(attention_status, u8)
64GET_STATUS(latch_status, u8)
65GET_STATUS(adapter_status, u8)
66
67static ssize_t power_read_file(struct pci_slot *pci_slot, char *buf)
68{
69 int retval;
70 u8 value;
71
72 retval = get_power_status(pci_slot->hotplug, &value);
73 if (retval)
74 return retval;
75
76 return sysfs_emit(buf, "%d\n", value);
77}
78
79static ssize_t power_write_file(struct pci_slot *pci_slot, const char *buf,
80 size_t count)
81{
82 struct hotplug_slot *slot = pci_slot->hotplug;
83 unsigned long lpower;
84 u8 power;
85 int retval = 0;
86
87 lpower = simple_strtoul(buf, NULL, 10);
88 power = (u8)(lpower & 0xff);
89 dbg("power = %d\n", power);
90
91 if (!try_module_get(slot->owner)) {
92 retval = -ENODEV;
93 goto exit;
94 }
95 switch (power) {
96 case 0:
97 if (slot->ops->disable_slot)
98 retval = slot->ops->disable_slot(slot);
99 break;
100
101 case 1:
102 if (slot->ops->enable_slot)
103 retval = slot->ops->enable_slot(slot);
104 break;
105
106 default:
107 err("Illegal value specified for power\n");
108 retval = -EINVAL;
109 }
110 module_put(slot->owner);
111
112exit:
113 if (retval)
114 return retval;
115 return count;
116}
117
118static struct pci_slot_attribute hotplug_slot_attr_power = {
119 .attr = {.name = "power", .mode = S_IFREG | S_IRUGO | S_IWUSR},
120 .show = power_read_file,
121 .store = power_write_file
122};
123
124static ssize_t attention_read_file(struct pci_slot *pci_slot, char *buf)
125{
126 int retval;
127 u8 value;
128
129 retval = get_attention_status(pci_slot->hotplug, &value);
130 if (retval)
131 return retval;
132
133 return sysfs_emit(buf, "%d\n", value);
134}
135
136static ssize_t attention_write_file(struct pci_slot *pci_slot, const char *buf,
137 size_t count)
138{
139 struct hotplug_slot *slot = pci_slot->hotplug;
140 const struct hotplug_slot_ops *ops = slot->ops;
141 unsigned long lattention;
142 u8 attention;
143 int retval = 0;
144
145 lattention = simple_strtoul(buf, NULL, 10);
146 attention = (u8)(lattention & 0xff);
147 dbg(" - attention = %d\n", attention);
148
149 if (!try_module_get(slot->owner)) {
150 retval = -ENODEV;
151 goto exit;
152 }
153 if (ops->set_attention_status)
154 retval = ops->set_attention_status(slot, attention);
155 module_put(slot->owner);
156
157exit:
158 if (retval)
159 return retval;
160 return count;
161}
162
163static struct pci_slot_attribute hotplug_slot_attr_attention = {
164 .attr = {.name = "attention", .mode = S_IFREG | S_IRUGO | S_IWUSR},
165 .show = attention_read_file,
166 .store = attention_write_file
167};
168
169static ssize_t latch_read_file(struct pci_slot *pci_slot, char *buf)
170{
171 int retval;
172 u8 value;
173
174 retval = get_latch_status(pci_slot->hotplug, &value);
175 if (retval)
176 return retval;
177
178 return sysfs_emit(buf, "%d\n", value);
179}
180
181static struct pci_slot_attribute hotplug_slot_attr_latch = {
182 .attr = {.name = "latch", .mode = S_IFREG | S_IRUGO},
183 .show = latch_read_file,
184};
185
186static ssize_t presence_read_file(struct pci_slot *pci_slot, char *buf)
187{
188 int retval;
189 u8 value;
190
191 retval = get_adapter_status(pci_slot->hotplug, &value);
192 if (retval)
193 return retval;
194
195 return sysfs_emit(buf, "%d\n", value);
196}
197
198static struct pci_slot_attribute hotplug_slot_attr_presence = {
199 .attr = {.name = "adapter", .mode = S_IFREG | S_IRUGO},
200 .show = presence_read_file,
201};
202
203static ssize_t test_write_file(struct pci_slot *pci_slot, const char *buf,
204 size_t count)
205{
206 struct hotplug_slot *slot = pci_slot->hotplug;
207 unsigned long ltest;
208 u32 test;
209 int retval = 0;
210
211 ltest = simple_strtoul(buf, NULL, 10);
212 test = (u32)(ltest & 0xffffffff);
213 dbg("test = %d\n", test);
214
215 if (!try_module_get(slot->owner)) {
216 retval = -ENODEV;
217 goto exit;
218 }
219 if (slot->ops->hardware_test)
220 retval = slot->ops->hardware_test(slot, test);
221 module_put(slot->owner);
222
223exit:
224 if (retval)
225 return retval;
226 return count;
227}
228
229static struct pci_slot_attribute hotplug_slot_attr_test = {
230 .attr = {.name = "test", .mode = S_IFREG | S_IRUGO | S_IWUSR},
231 .store = test_write_file
232};
233
234static bool has_power_file(struct pci_slot *pci_slot)
235{
236 struct hotplug_slot *slot = pci_slot->hotplug;
237
238 if ((!slot) || (!slot->ops))
239 return false;
240 if ((slot->ops->enable_slot) ||
241 (slot->ops->disable_slot) ||
242 (slot->ops->get_power_status))
243 return true;
244 return false;
245}
246
247static bool has_attention_file(struct pci_slot *pci_slot)
248{
249 struct hotplug_slot *slot = pci_slot->hotplug;
250
251 if ((!slot) || (!slot->ops))
252 return false;
253 if ((slot->ops->set_attention_status) ||
254 (slot->ops->get_attention_status))
255 return true;
256 return false;
257}
258
259static bool has_latch_file(struct pci_slot *pci_slot)
260{
261 struct hotplug_slot *slot = pci_slot->hotplug;
262
263 if ((!slot) || (!slot->ops))
264 return false;
265 if (slot->ops->get_latch_status)
266 return true;
267 return false;
268}
269
270static bool has_adapter_file(struct pci_slot *pci_slot)
271{
272 struct hotplug_slot *slot = pci_slot->hotplug;
273
274 if ((!slot) || (!slot->ops))
275 return false;
276 if (slot->ops->get_adapter_status)
277 return true;
278 return false;
279}
280
281static bool has_test_file(struct pci_slot *pci_slot)
282{
283 struct hotplug_slot *slot = pci_slot->hotplug;
284
285 if ((!slot) || (!slot->ops))
286 return false;
287 if (slot->ops->hardware_test)
288 return true;
289 return false;
290}
291
292static int fs_add_slot(struct pci_slot *pci_slot)
293{
294 int retval = 0;
295
296 /* Create symbolic link to the hotplug driver module */
297 pci_hp_create_module_link(pci_slot);
298
299 if (has_power_file(pci_slot)) {
300 retval = sysfs_create_file(&pci_slot->kobj,
301 &hotplug_slot_attr_power.attr);
302 if (retval)
303 goto exit_power;
304 }
305
306 if (has_attention_file(pci_slot)) {
307 retval = sysfs_create_file(&pci_slot->kobj,
308 &hotplug_slot_attr_attention.attr);
309 if (retval)
310 goto exit_attention;
311 }
312
313 if (has_latch_file(pci_slot)) {
314 retval = sysfs_create_file(&pci_slot->kobj,
315 &hotplug_slot_attr_latch.attr);
316 if (retval)
317 goto exit_latch;
318 }
319
320 if (has_adapter_file(pci_slot)) {
321 retval = sysfs_create_file(&pci_slot->kobj,
322 &hotplug_slot_attr_presence.attr);
323 if (retval)
324 goto exit_adapter;
325 }
326
327 if (has_test_file(pci_slot)) {
328 retval = sysfs_create_file(&pci_slot->kobj,
329 &hotplug_slot_attr_test.attr);
330 if (retval)
331 goto exit_test;
332 }
333
334 goto exit;
335
336exit_test:
337 if (has_adapter_file(pci_slot))
338 sysfs_remove_file(&pci_slot->kobj,
339 &hotplug_slot_attr_presence.attr);
340exit_adapter:
341 if (has_latch_file(pci_slot))
342 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);
343exit_latch:
344 if (has_attention_file(pci_slot))
345 sysfs_remove_file(&pci_slot->kobj,
346 &hotplug_slot_attr_attention.attr);
347exit_attention:
348 if (has_power_file(pci_slot))
349 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);
350exit_power:
351 pci_hp_remove_module_link(pci_slot);
352exit:
353 return retval;
354}
355
356static void fs_remove_slot(struct pci_slot *pci_slot)
357{
358 if (has_power_file(pci_slot))
359 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);
360
361 if (has_attention_file(pci_slot))
362 sysfs_remove_file(&pci_slot->kobj,
363 &hotplug_slot_attr_attention.attr);
364
365 if (has_latch_file(pci_slot))
366 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);
367
368 if (has_adapter_file(pci_slot))
369 sysfs_remove_file(&pci_slot->kobj,
370 &hotplug_slot_attr_presence.attr);
371
372 if (has_test_file(pci_slot))
373 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_test.attr);
374
375 pci_hp_remove_module_link(pci_slot);
376}
377
378static struct hotplug_slot *get_slot_from_name(const char *name)
379{
380 struct hotplug_slot *slot;
381
382 list_for_each_entry(slot, &pci_hotplug_slot_list, slot_list) {
383 if (strcmp(hotplug_slot_name(slot), name) == 0)
384 return slot;
385 }
386 return NULL;
387}
388
389/**
390 * __pci_hp_register - register a hotplug_slot with the PCI hotplug subsystem
391 * @bus: bus this slot is on
392 * @slot: pointer to the &struct hotplug_slot to register
393 * @devnr: device number
394 * @name: name registered with kobject core
395 * @owner: caller module owner
396 * @mod_name: caller module name
397 *
398 * Prepares a hotplug slot for in-kernel use and immediately publishes it to
399 * user space in one go. Drivers may alternatively carry out the two steps
400 * separately by invoking pci_hp_initialize() and pci_hp_add().
401 *
402 * Returns 0 if successful, anything else for an error.
403 */
404int __pci_hp_register(struct hotplug_slot *slot, struct pci_bus *bus,
405 int devnr, const char *name,
406 struct module *owner, const char *mod_name)
407{
408 int result;
409
410 result = __pci_hp_initialize(slot, bus, devnr, name, owner, mod_name);
411 if (result)
412 return result;
413
414 result = pci_hp_add(slot);
415 if (result)
416 pci_hp_destroy(slot);
417
418 return result;
419}
420EXPORT_SYMBOL_GPL(__pci_hp_register);
421
422/**
423 * __pci_hp_initialize - prepare hotplug slot for in-kernel use
424 * @slot: pointer to the &struct hotplug_slot to initialize
425 * @bus: bus this slot is on
426 * @devnr: slot number
427 * @name: name registered with kobject core
428 * @owner: caller module owner
429 * @mod_name: caller module name
430 *
431 * Allocate and fill in a PCI slot for use by a hotplug driver. Once this has
432 * been called, the driver may invoke hotplug_slot_name() to get the slot's
433 * unique name. The driver must be prepared to handle a ->reset_slot callback
434 * from this point on.
435 *
436 * Returns 0 on success or a negative int on error.
437 */
438int __pci_hp_initialize(struct hotplug_slot *slot, struct pci_bus *bus,
439 int devnr, const char *name, struct module *owner,
440 const char *mod_name)
441{
442 struct pci_slot *pci_slot;
443
444 if (slot == NULL)
445 return -ENODEV;
446 if (slot->ops == NULL)
447 return -EINVAL;
448
449 slot->owner = owner;
450 slot->mod_name = mod_name;
451
452 /*
453 * No problems if we call this interface from both ACPI_PCI_SLOT
454 * driver and call it here again. If we've already created the
455 * pci_slot, the interface will simply bump the refcount.
456 */
457 pci_slot = pci_create_slot(bus, devnr, name, slot);
458 if (IS_ERR(pci_slot))
459 return PTR_ERR(pci_slot);
460
461 slot->pci_slot = pci_slot;
462 pci_slot->hotplug = slot;
463 return 0;
464}
465EXPORT_SYMBOL_GPL(__pci_hp_initialize);
466
467/**
468 * pci_hp_add - publish hotplug slot to user space
469 * @slot: pointer to the &struct hotplug_slot to publish
470 *
471 * Make a hotplug slot's sysfs interface available and inform user space of its
472 * addition by sending a uevent. The hotplug driver must be prepared to handle
473 * all &struct hotplug_slot_ops callbacks from this point on.
474 *
475 * Returns 0 on success or a negative int on error.
476 */
477int pci_hp_add(struct hotplug_slot *slot)
478{
479 struct pci_slot *pci_slot = slot->pci_slot;
480 int result;
481
482 result = fs_add_slot(pci_slot);
483 if (result)
484 return result;
485
486 kobject_uevent(&pci_slot->kobj, KOBJ_ADD);
487 mutex_lock(&pci_hp_mutex);
488 list_add(&slot->slot_list, &pci_hotplug_slot_list);
489 mutex_unlock(&pci_hp_mutex);
490 dbg("Added slot %s to the list\n", hotplug_slot_name(slot));
491 return 0;
492}
493EXPORT_SYMBOL_GPL(pci_hp_add);
494
495/**
496 * pci_hp_deregister - deregister a hotplug_slot with the PCI hotplug subsystem
497 * @slot: pointer to the &struct hotplug_slot to deregister
498 *
499 * The @slot must have been registered with the pci hotplug subsystem
500 * previously with a call to pci_hp_register().
501 *
502 * Returns 0 if successful, anything else for an error.
503 */
504void pci_hp_deregister(struct hotplug_slot *slot)
505{
506 pci_hp_del(slot);
507 pci_hp_destroy(slot);
508}
509EXPORT_SYMBOL_GPL(pci_hp_deregister);
510
511/**
512 * pci_hp_del - unpublish hotplug slot from user space
513 * @slot: pointer to the &struct hotplug_slot to unpublish
514 *
515 * Remove a hotplug slot's sysfs interface.
516 *
517 * Returns 0 on success or a negative int on error.
518 */
519void pci_hp_del(struct hotplug_slot *slot)
520{
521 struct hotplug_slot *temp;
522
523 if (WARN_ON(!slot))
524 return;
525
526 mutex_lock(&pci_hp_mutex);
527 temp = get_slot_from_name(hotplug_slot_name(slot));
528 if (WARN_ON(temp != slot)) {
529 mutex_unlock(&pci_hp_mutex);
530 return;
531 }
532
533 list_del(&slot->slot_list);
534 mutex_unlock(&pci_hp_mutex);
535 dbg("Removed slot %s from the list\n", hotplug_slot_name(slot));
536 fs_remove_slot(slot->pci_slot);
537}
538EXPORT_SYMBOL_GPL(pci_hp_del);
539
540/**
541 * pci_hp_destroy - remove hotplug slot from in-kernel use
542 * @slot: pointer to the &struct hotplug_slot to destroy
543 *
544 * Destroy a PCI slot used by a hotplug driver. Once this has been called,
545 * the driver may no longer invoke hotplug_slot_name() to get the slot's
546 * unique name. The driver no longer needs to handle a ->reset_slot callback
547 * from this point on.
548 *
549 * Returns 0 on success or a negative int on error.
550 */
551void pci_hp_destroy(struct hotplug_slot *slot)
552{
553 struct pci_slot *pci_slot = slot->pci_slot;
554
555 slot->pci_slot = NULL;
556 pci_slot->hotplug = NULL;
557 pci_destroy_slot(pci_slot);
558}
559EXPORT_SYMBOL_GPL(pci_hp_destroy);
560
561static int __init pci_hotplug_init(void)
562{
563 int result;
564
565 result = cpci_hotplug_init(debug);
566 if (result) {
567 err("cpci_hotplug_init with error %d\n", result);
568 return result;
569 }
570
571 return result;
572}
573device_initcall(pci_hotplug_init);
574
575/*
576 * not really modular, but the easiest way to keep compat with existing
577 * bootargs behaviour is to continue using module_param here.
578 */
579module_param(debug, bool, 0644);
580MODULE_PARM_DESC(debug, "Debugging mode enabled or not");
1/*
2 * PCI HotPlug Controller Core
3 *
4 * Copyright (C) 2001-2002 Greg Kroah-Hartman (greg@kroah.com)
5 * Copyright (C) 2001-2002 IBM Corp.
6 *
7 * All rights reserved.
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or (at
12 * your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
17 * NON INFRINGEMENT. See the GNU General Public License for more
18 * details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 *
24 * Send feedback to <kristen.c.accardi@intel.com>
25 *
26 */
27
28#include <linux/module.h>
29#include <linux/moduleparam.h>
30#include <linux/kernel.h>
31#include <linux/types.h>
32#include <linux/list.h>
33#include <linux/kobject.h>
34#include <linux/sysfs.h>
35#include <linux/pagemap.h>
36#include <linux/init.h>
37#include <linux/mount.h>
38#include <linux/namei.h>
39#include <linux/mutex.h>
40#include <linux/pci.h>
41#include <linux/pci_hotplug.h>
42#include <asm/uaccess.h>
43#include "../pci.h"
44#include "cpci_hotplug.h"
45
46#define MY_NAME "pci_hotplug"
47
48#define dbg(fmt, arg...) do { if (debug) printk(KERN_DEBUG "%s: %s: " fmt, MY_NAME, __func__, ## arg); } while (0)
49#define err(format, arg...) printk(KERN_ERR "%s: " format, MY_NAME, ## arg)
50#define info(format, arg...) printk(KERN_INFO "%s: " format, MY_NAME, ## arg)
51#define warn(format, arg...) printk(KERN_WARNING "%s: " format, MY_NAME, ## arg)
52
53
54/* local variables */
55static bool debug;
56
57#define DRIVER_VERSION "0.5"
58#define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>, Scott Murray <scottm@somanetworks.com>"
59#define DRIVER_DESC "PCI Hot Plug PCI Core"
60
61
62static LIST_HEAD(pci_hotplug_slot_list);
63static DEFINE_MUTEX(pci_hp_mutex);
64
65/* Weee, fun with macros... */
66#define GET_STATUS(name, type) \
67static int get_##name(struct hotplug_slot *slot, type *value) \
68{ \
69 struct hotplug_slot_ops *ops = slot->ops; \
70 int retval = 0; \
71 if (!try_module_get(ops->owner)) \
72 return -ENODEV; \
73 if (ops->get_##name) \
74 retval = ops->get_##name(slot, value); \
75 else \
76 *value = slot->info->name; \
77 module_put(ops->owner); \
78 return retval; \
79}
80
81GET_STATUS(power_status, u8)
82GET_STATUS(attention_status, u8)
83GET_STATUS(latch_status, u8)
84GET_STATUS(adapter_status, u8)
85
86static ssize_t power_read_file(struct pci_slot *pci_slot, char *buf)
87{
88 int retval;
89 u8 value;
90
91 retval = get_power_status(pci_slot->hotplug, &value);
92 if (retval)
93 return retval;
94
95 return sprintf(buf, "%d\n", value);
96}
97
98static ssize_t power_write_file(struct pci_slot *pci_slot, const char *buf,
99 size_t count)
100{
101 struct hotplug_slot *slot = pci_slot->hotplug;
102 unsigned long lpower;
103 u8 power;
104 int retval = 0;
105
106 lpower = simple_strtoul(buf, NULL, 10);
107 power = (u8)(lpower & 0xff);
108 dbg("power = %d\n", power);
109
110 if (!try_module_get(slot->ops->owner)) {
111 retval = -ENODEV;
112 goto exit;
113 }
114 switch (power) {
115 case 0:
116 if (slot->ops->disable_slot)
117 retval = slot->ops->disable_slot(slot);
118 break;
119
120 case 1:
121 if (slot->ops->enable_slot)
122 retval = slot->ops->enable_slot(slot);
123 break;
124
125 default:
126 err("Illegal value specified for power\n");
127 retval = -EINVAL;
128 }
129 module_put(slot->ops->owner);
130
131exit:
132 if (retval)
133 return retval;
134 return count;
135}
136
137static struct pci_slot_attribute hotplug_slot_attr_power = {
138 .attr = {.name = "power", .mode = S_IFREG | S_IRUGO | S_IWUSR},
139 .show = power_read_file,
140 .store = power_write_file
141};
142
143static ssize_t attention_read_file(struct pci_slot *pci_slot, char *buf)
144{
145 int retval;
146 u8 value;
147
148 retval = get_attention_status(pci_slot->hotplug, &value);
149 if (retval)
150 return retval;
151
152 return sprintf(buf, "%d\n", value);
153}
154
155static ssize_t attention_write_file(struct pci_slot *pci_slot, const char *buf,
156 size_t count)
157{
158 struct hotplug_slot_ops *ops = pci_slot->hotplug->ops;
159 unsigned long lattention;
160 u8 attention;
161 int retval = 0;
162
163 lattention = simple_strtoul(buf, NULL, 10);
164 attention = (u8)(lattention & 0xff);
165 dbg(" - attention = %d\n", attention);
166
167 if (!try_module_get(ops->owner)) {
168 retval = -ENODEV;
169 goto exit;
170 }
171 if (ops->set_attention_status)
172 retval = ops->set_attention_status(pci_slot->hotplug, attention);
173 module_put(ops->owner);
174
175exit:
176 if (retval)
177 return retval;
178 return count;
179}
180
181static struct pci_slot_attribute hotplug_slot_attr_attention = {
182 .attr = {.name = "attention", .mode = S_IFREG | S_IRUGO | S_IWUSR},
183 .show = attention_read_file,
184 .store = attention_write_file
185};
186
187static ssize_t latch_read_file(struct pci_slot *pci_slot, char *buf)
188{
189 int retval;
190 u8 value;
191
192 retval = get_latch_status(pci_slot->hotplug, &value);
193 if (retval)
194 return retval;
195
196 return sprintf(buf, "%d\n", value);
197}
198
199static struct pci_slot_attribute hotplug_slot_attr_latch = {
200 .attr = {.name = "latch", .mode = S_IFREG | S_IRUGO},
201 .show = latch_read_file,
202};
203
204static ssize_t presence_read_file(struct pci_slot *pci_slot, char *buf)
205{
206 int retval;
207 u8 value;
208
209 retval = get_adapter_status(pci_slot->hotplug, &value);
210 if (retval)
211 return retval;
212
213 return sprintf(buf, "%d\n", value);
214}
215
216static struct pci_slot_attribute hotplug_slot_attr_presence = {
217 .attr = {.name = "adapter", .mode = S_IFREG | S_IRUGO},
218 .show = presence_read_file,
219};
220
221static ssize_t test_write_file(struct pci_slot *pci_slot, const char *buf,
222 size_t count)
223{
224 struct hotplug_slot *slot = pci_slot->hotplug;
225 unsigned long ltest;
226 u32 test;
227 int retval = 0;
228
229 ltest = simple_strtoul(buf, NULL, 10);
230 test = (u32)(ltest & 0xffffffff);
231 dbg("test = %d\n", test);
232
233 if (!try_module_get(slot->ops->owner)) {
234 retval = -ENODEV;
235 goto exit;
236 }
237 if (slot->ops->hardware_test)
238 retval = slot->ops->hardware_test(slot, test);
239 module_put(slot->ops->owner);
240
241exit:
242 if (retval)
243 return retval;
244 return count;
245}
246
247static struct pci_slot_attribute hotplug_slot_attr_test = {
248 .attr = {.name = "test", .mode = S_IFREG | S_IRUGO | S_IWUSR},
249 .store = test_write_file
250};
251
252static bool has_power_file(struct pci_slot *pci_slot)
253{
254 struct hotplug_slot *slot = pci_slot->hotplug;
255
256 if ((!slot) || (!slot->ops))
257 return false;
258 if ((slot->ops->enable_slot) ||
259 (slot->ops->disable_slot) ||
260 (slot->ops->get_power_status))
261 return true;
262 return false;
263}
264
265static bool has_attention_file(struct pci_slot *pci_slot)
266{
267 struct hotplug_slot *slot = pci_slot->hotplug;
268
269 if ((!slot) || (!slot->ops))
270 return false;
271 if ((slot->ops->set_attention_status) ||
272 (slot->ops->get_attention_status))
273 return true;
274 return false;
275}
276
277static bool has_latch_file(struct pci_slot *pci_slot)
278{
279 struct hotplug_slot *slot = pci_slot->hotplug;
280
281 if ((!slot) || (!slot->ops))
282 return false;
283 if (slot->ops->get_latch_status)
284 return true;
285 return false;
286}
287
288static bool has_adapter_file(struct pci_slot *pci_slot)
289{
290 struct hotplug_slot *slot = pci_slot->hotplug;
291
292 if ((!slot) || (!slot->ops))
293 return false;
294 if (slot->ops->get_adapter_status)
295 return true;
296 return false;
297}
298
299static bool has_test_file(struct pci_slot *pci_slot)
300{
301 struct hotplug_slot *slot = pci_slot->hotplug;
302
303 if ((!slot) || (!slot->ops))
304 return false;
305 if (slot->ops->hardware_test)
306 return true;
307 return false;
308}
309
310static int fs_add_slot(struct pci_slot *pci_slot)
311{
312 int retval = 0;
313
314 /* Create symbolic link to the hotplug driver module */
315 pci_hp_create_module_link(pci_slot);
316
317 if (has_power_file(pci_slot)) {
318 retval = sysfs_create_file(&pci_slot->kobj,
319 &hotplug_slot_attr_power.attr);
320 if (retval)
321 goto exit_power;
322 }
323
324 if (has_attention_file(pci_slot)) {
325 retval = sysfs_create_file(&pci_slot->kobj,
326 &hotplug_slot_attr_attention.attr);
327 if (retval)
328 goto exit_attention;
329 }
330
331 if (has_latch_file(pci_slot)) {
332 retval = sysfs_create_file(&pci_slot->kobj,
333 &hotplug_slot_attr_latch.attr);
334 if (retval)
335 goto exit_latch;
336 }
337
338 if (has_adapter_file(pci_slot)) {
339 retval = sysfs_create_file(&pci_slot->kobj,
340 &hotplug_slot_attr_presence.attr);
341 if (retval)
342 goto exit_adapter;
343 }
344
345 if (has_test_file(pci_slot)) {
346 retval = sysfs_create_file(&pci_slot->kobj,
347 &hotplug_slot_attr_test.attr);
348 if (retval)
349 goto exit_test;
350 }
351
352 goto exit;
353
354exit_test:
355 if (has_adapter_file(pci_slot))
356 sysfs_remove_file(&pci_slot->kobj,
357 &hotplug_slot_attr_presence.attr);
358exit_adapter:
359 if (has_latch_file(pci_slot))
360 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);
361exit_latch:
362 if (has_attention_file(pci_slot))
363 sysfs_remove_file(&pci_slot->kobj,
364 &hotplug_slot_attr_attention.attr);
365exit_attention:
366 if (has_power_file(pci_slot))
367 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);
368exit_power:
369 pci_hp_remove_module_link(pci_slot);
370exit:
371 return retval;
372}
373
374static void fs_remove_slot(struct pci_slot *pci_slot)
375{
376 if (has_power_file(pci_slot))
377 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_power.attr);
378
379 if (has_attention_file(pci_slot))
380 sysfs_remove_file(&pci_slot->kobj,
381 &hotplug_slot_attr_attention.attr);
382
383 if (has_latch_file(pci_slot))
384 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_latch.attr);
385
386 if (has_adapter_file(pci_slot))
387 sysfs_remove_file(&pci_slot->kobj,
388 &hotplug_slot_attr_presence.attr);
389
390 if (has_test_file(pci_slot))
391 sysfs_remove_file(&pci_slot->kobj, &hotplug_slot_attr_test.attr);
392
393 pci_hp_remove_module_link(pci_slot);
394}
395
396static struct hotplug_slot *get_slot_from_name(const char *name)
397{
398 struct hotplug_slot *slot;
399
400 list_for_each_entry(slot, &pci_hotplug_slot_list, slot_list) {
401 if (strcmp(hotplug_slot_name(slot), name) == 0)
402 return slot;
403 }
404 return NULL;
405}
406
407/**
408 * __pci_hp_register - register a hotplug_slot with the PCI hotplug subsystem
409 * @bus: bus this slot is on
410 * @slot: pointer to the &struct hotplug_slot to register
411 * @devnr: device number
412 * @name: name registered with kobject core
413 * @owner: caller module owner
414 * @mod_name: caller module name
415 *
416 * Registers a hotplug slot with the pci hotplug subsystem, which will allow
417 * userspace interaction to the slot.
418 *
419 * Returns 0 if successful, anything else for an error.
420 */
421int __pci_hp_register(struct hotplug_slot *slot, struct pci_bus *bus,
422 int devnr, const char *name,
423 struct module *owner, const char *mod_name)
424{
425 int result;
426 struct pci_slot *pci_slot;
427
428 if (slot == NULL)
429 return -ENODEV;
430 if ((slot->info == NULL) || (slot->ops == NULL))
431 return -EINVAL;
432 if (slot->release == NULL) {
433 dbg("Why are you trying to register a hotplug slot without a proper release function?\n");
434 return -EINVAL;
435 }
436
437 slot->ops->owner = owner;
438 slot->ops->mod_name = mod_name;
439
440 mutex_lock(&pci_hp_mutex);
441 /*
442 * No problems if we call this interface from both ACPI_PCI_SLOT
443 * driver and call it here again. If we've already created the
444 * pci_slot, the interface will simply bump the refcount.
445 */
446 pci_slot = pci_create_slot(bus, devnr, name, slot);
447 if (IS_ERR(pci_slot)) {
448 result = PTR_ERR(pci_slot);
449 goto out;
450 }
451
452 slot->pci_slot = pci_slot;
453 pci_slot->hotplug = slot;
454
455 list_add(&slot->slot_list, &pci_hotplug_slot_list);
456
457 result = fs_add_slot(pci_slot);
458 kobject_uevent(&pci_slot->kobj, KOBJ_ADD);
459 dbg("Added slot %s to the list\n", name);
460out:
461 mutex_unlock(&pci_hp_mutex);
462 return result;
463}
464EXPORT_SYMBOL_GPL(__pci_hp_register);
465
466/**
467 * pci_hp_deregister - deregister a hotplug_slot with the PCI hotplug subsystem
468 * @slot: pointer to the &struct hotplug_slot to deregister
469 *
470 * The @slot must have been registered with the pci hotplug subsystem
471 * previously with a call to pci_hp_register().
472 *
473 * Returns 0 if successful, anything else for an error.
474 */
475int pci_hp_deregister(struct hotplug_slot *slot)
476{
477 struct hotplug_slot *temp;
478 struct pci_slot *pci_slot;
479
480 if (!slot)
481 return -ENODEV;
482
483 mutex_lock(&pci_hp_mutex);
484 temp = get_slot_from_name(hotplug_slot_name(slot));
485 if (temp != slot) {
486 mutex_unlock(&pci_hp_mutex);
487 return -ENODEV;
488 }
489
490 list_del(&slot->slot_list);
491
492 pci_slot = slot->pci_slot;
493 fs_remove_slot(pci_slot);
494 dbg("Removed slot %s from the list\n", hotplug_slot_name(slot));
495
496 slot->release(slot);
497 pci_slot->hotplug = NULL;
498 pci_destroy_slot(pci_slot);
499 mutex_unlock(&pci_hp_mutex);
500
501 return 0;
502}
503EXPORT_SYMBOL_GPL(pci_hp_deregister);
504
505/**
506 * pci_hp_change_slot_info - changes the slot's information structure in the core
507 * @slot: pointer to the slot whose info has changed
508 * @info: pointer to the info copy into the slot's info structure
509 *
510 * @slot must have been registered with the pci
511 * hotplug subsystem previously with a call to pci_hp_register().
512 *
513 * Returns 0 if successful, anything else for an error.
514 */
515int pci_hp_change_slot_info(struct hotplug_slot *slot,
516 struct hotplug_slot_info *info)
517{
518 if (!slot || !info)
519 return -ENODEV;
520
521 memcpy(slot->info, info, sizeof(struct hotplug_slot_info));
522
523 return 0;
524}
525EXPORT_SYMBOL_GPL(pci_hp_change_slot_info);
526
527static int __init pci_hotplug_init(void)
528{
529 int result;
530
531 result = cpci_hotplug_init(debug);
532 if (result) {
533 err("cpci_hotplug_init with error %d\n", result);
534 return result;
535 }
536
537 info(DRIVER_DESC " version: " DRIVER_VERSION "\n");
538 return result;
539}
540
541static void __exit pci_hotplug_exit(void)
542{
543 cpci_hotplug_exit();
544}
545
546module_init(pci_hotplug_init);
547module_exit(pci_hotplug_exit);
548
549MODULE_AUTHOR(DRIVER_AUTHOR);
550MODULE_DESCRIPTION(DRIVER_DESC);
551MODULE_LICENSE("GPL");
552module_param(debug, bool, 0644);
553MODULE_PARM_DESC(debug, "Debugging mode enabled or not");