aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/pci/hotplug/pcihp_skeleton.c
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /drivers/pci/hotplug/pcihp_skeleton.c
Linux-2.6.12-rc2v2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'drivers/pci/hotplug/pcihp_skeleton.c')
-rw-r--r--drivers/pci/hotplug/pcihp_skeleton.c375
1 files changed, 375 insertions, 0 deletions
diff --git a/drivers/pci/hotplug/pcihp_skeleton.c b/drivers/pci/hotplug/pcihp_skeleton.c
new file mode 100644
index 000000000000..6605d6bda529
--- /dev/null
+++ b/drivers/pci/hotplug/pcihp_skeleton.c
@@ -0,0 +1,375 @@
1/*
2 * PCI Hot Plug Controller Skeleton Driver - 0.2
3 *
4 * Copyright (C) 2001,2003 Greg Kroah-Hartman (greg@kroah.com)
5 * Copyright (C) 2001,2003 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 * This driver is to be used as a skeleton driver to be show how to interface
25 * with the pci hotplug core easily.
26 *
27 * Send feedback to <greg@kroah.com>
28 *
29 */
30
31#include <linux/config.h>
32#include <linux/module.h>
33#include <linux/moduleparam.h>
34#include <linux/kernel.h>
35#include <linux/slab.h>
36#include <linux/pci.h>
37#include <linux/init.h>
38#include "pci_hotplug.h"
39
40struct slot {
41 u8 number;
42 struct hotplug_slot *hotplug_slot;
43 struct list_head slot_list;
44};
45
46static LIST_HEAD(slot_list);
47
48#define MY_NAME "pcihp_skeleton"
49
50#define dbg(format, arg...) \
51 do { \
52 if (debug) \
53 printk (KERN_DEBUG "%s: " format "\n", \
54 MY_NAME , ## arg); \
55 } while (0)
56#define err(format, arg...) printk(KERN_ERR "%s: " format "\n", MY_NAME , ## arg)
57#define info(format, arg...) printk(KERN_INFO "%s: " format "\n", MY_NAME , ## arg)
58#define warn(format, arg...) printk(KERN_WARNING "%s: " format "\n", MY_NAME , ## arg)
59
60
61
62/* local variables */
63static int debug;
64static int num_slots;
65
66#define DRIVER_VERSION "0.3"
67#define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>"
68#define DRIVER_DESC "Hot Plug PCI Controller Skeleton Driver"
69
70MODULE_AUTHOR(DRIVER_AUTHOR);
71MODULE_DESCRIPTION(DRIVER_DESC);
72MODULE_LICENSE("GPL");
73module_param(debug, bool, 0644);
74MODULE_PARM_DESC(debug, "Debugging mode enabled or not");
75
76static int enable_slot (struct hotplug_slot *slot);
77static int disable_slot (struct hotplug_slot *slot);
78static int set_attention_status (struct hotplug_slot *slot, u8 value);
79static int hardware_test (struct hotplug_slot *slot, u32 value);
80static int get_power_status (struct hotplug_slot *slot, u8 *value);
81static int get_attention_status (struct hotplug_slot *slot, u8 *value);
82static int get_latch_status (struct hotplug_slot *slot, u8 *value);
83static int get_adapter_status (struct hotplug_slot *slot, u8 *value);
84
85static struct hotplug_slot_ops skel_hotplug_slot_ops = {
86 .owner = THIS_MODULE,
87 .enable_slot = enable_slot,
88 .disable_slot = disable_slot,
89 .set_attention_status = set_attention_status,
90 .hardware_test = hardware_test,
91 .get_power_status = get_power_status,
92 .get_attention_status = get_attention_status,
93 .get_latch_status = get_latch_status,
94 .get_adapter_status = get_adapter_status,
95};
96
97static int enable_slot(struct hotplug_slot *hotplug_slot)
98{
99 struct slot *slot = hotplug_slot->private;
100 int retval = 0;
101
102 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
103
104 /*
105 * Fill in code here to enable the specified slot
106 */
107
108 return retval;
109}
110
111
112static int disable_slot(struct hotplug_slot *hotplug_slot)
113{
114 struct slot *slot = hotplug_slot->private;
115 int retval = 0;
116
117 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
118
119 /*
120 * Fill in code here to disable the specified slot
121 */
122
123 return retval;
124}
125
126static int set_attention_status(struct hotplug_slot *hotplug_slot, u8 status)
127{
128 struct slot *slot = hotplug_slot->private;
129 int retval = 0;
130
131 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
132
133 switch (status) {
134 case 0:
135 /*
136 * Fill in code here to turn light off
137 */
138 break;
139
140 case 1:
141 default:
142 /*
143 * Fill in code here to turn light on
144 */
145 break;
146 }
147
148 return retval;
149}
150
151static int hardware_test(struct hotplug_slot *hotplug_slot, u32 value)
152{
153 struct slot *slot = hotplug_slot->private;
154 int retval = 0;
155
156 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
157
158 switch (value) {
159 case 0:
160 /* Specify a test here */
161 break;
162 case 1:
163 /* Specify another test here */
164 break;
165 }
166
167 return retval;
168}
169
170static int get_power_status(struct hotplug_slot *hotplug_slot, u8 *value)
171{
172 struct slot *slot = hotplug_slot->private;
173 int retval = 0;
174
175 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
176
177 /*
178 * Fill in logic to get the current power status of the specific
179 * slot and store it in the *value location.
180 */
181
182 return retval;
183}
184
185static int get_attention_status(struct hotplug_slot *hotplug_slot, u8 *value)
186{
187 struct slot *slot = hotplug_slot->private;
188 int retval = 0;
189
190 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
191
192 /*
193 * Fill in logic to get the current attention status of the specific
194 * slot and store it in the *value location.
195 */
196
197 return retval;
198}
199
200static int get_latch_status(struct hotplug_slot *hotplug_slot, u8 *value)
201{
202 struct slot *slot = hotplug_slot->private;
203 int retval = 0;
204
205 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
206
207 /*
208 * Fill in logic to get the current latch status of the specific
209 * slot and store it in the *value location.
210 */
211
212 return retval;
213}
214
215static int get_adapter_status(struct hotplug_slot *hotplug_slot, u8 *value)
216{
217 struct slot *slot = hotplug_slot->private;
218 int retval = 0;
219
220 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
221
222 /*
223 * Fill in logic to get the current adapter status of the specific
224 * slot and store it in the *value location.
225 */
226
227 return retval;
228}
229
230static void release_slot(struct hotplug_slot *hotplug_slot)
231{
232 struct slot *slot = hotplug_slot->private;
233
234 dbg("%s - physical_slot = %s\n", __FUNCTION__, hotplug_slot->name);
235 kfree(slot->hotplug_slot->info);
236 kfree(slot->hotplug_slot->name);
237 kfree(slot->hotplug_slot);
238 kfree(slot);
239}
240
241#define SLOT_NAME_SIZE 10
242static void make_slot_name(struct slot *slot)
243{
244 /*
245 * Stupid way to make a filename out of the slot name.
246 * replace this if your hardware provides a better way to name slots.
247 */
248 snprintf(slot->hotplug_slot->name, SLOT_NAME_SIZE, "%d", slot->number);
249}
250
251/**
252 * init_slots - initialize 'struct slot' structures for each slot
253 *
254 */
255static int __init init_slots(void)
256{
257 struct slot *slot;
258 struct hotplug_slot *hotplug_slot;
259 struct hotplug_slot_info *info;
260 char *name;
261 int retval = -ENOMEM;
262 int i;
263
264 /*
265 * Create a structure for each slot, and register that slot
266 * with the pci_hotplug subsystem.
267 */
268 for (i = 0; i < num_slots; ++i) {
269 slot = kmalloc(sizeof(struct slot), GFP_KERNEL);
270 if (!slot)
271 goto error;
272 memset(slot, 0, sizeof(struct slot));
273
274 hotplug_slot = kmalloc(sizeof(struct hotplug_slot),
275 GFP_KERNEL);
276 if (!hotplug_slot)
277 goto error_slot;
278 memset(hotplug_slot, 0, sizeof (struct hotplug_slot));
279 slot->hotplug_slot = hotplug_slot;
280
281 info = kmalloc(sizeof(struct hotplug_slot_info), GFP_KERNEL);
282 if (!info)
283 goto error_hpslot;
284 memset(info, 0, sizeof (struct hotplug_slot_info));
285 hotplug_slot->info = info;
286
287 name = kmalloc(SLOT_NAME_SIZE, GFP_KERNEL);
288 if (!name)
289 goto error_info;
290 hotplug_slot->name = name;
291
292 slot->number = i;
293
294 hotplug_slot->private = slot;
295 hotplug_slot->release = &release_slot;
296 make_slot_name(slot);
297 hotplug_slot->ops = &skel_hotplug_slot_ops;
298
299 /*
300 * Initilize the slot info structure with some known
301 * good values.
302 */
303 info->power_status = get_power_status(slot);
304 info->attention_status = get_attention_status(slot);
305 info->latch_status = get_latch_status(slot);
306 info->adapter_status = get_adapter_status(slot);
307
308 dbg("registering slot %d\n", i);
309 retval = pci_hp_register(slot->hotplug_slot);
310 if (retval) {
311 err("pci_hp_register failed with error %d\n", retval);
312 goto error_name;
313 }
314
315 /* add slot to our internal list */
316 list_add(&slot->slot_list, &slot_list);
317 }
318
319 return 0;
320error_name:
321 kfree(name);
322error_info:
323 kfree(info);
324error_hpslot:
325 kfree(hotplug_slot);
326error_slot:
327 kfree(slot);
328error:
329 return retval;
330}
331
332static void __exit cleanup_slots(void)
333{
334 struct list_head *tmp;
335 struct list_head *next;
336 struct slot *slot;
337
338 /*
339 * Unregister all of our slots with the pci_hotplug subsystem.
340 * Memory will be freed in release_slot() callback after slot's
341 * lifespan is finished.
342 */
343 list_for_each_safe(tmp, next, &slot_list) {
344 slot = list_entry(tmp, struct slot, slot_list);
345 list_del(&slot->slot_list);
346 pci_hp_deregister(slot->hotplug_slot);
347 }
348}
349
350static int __init pcihp_skel_init(void)
351{
352 int retval;
353
354 info(DRIVER_DESC " version: " DRIVER_VERSION "\n");
355 /*
356 * Do specific initialization stuff for your driver here
357 * Like initializing your controller hardware (if any) and
358 * determining the number of slots you have in the system
359 * right now.
360 */
361 num_slots = 5;
362
363 return init_slots();
364}
365
366static void __exit pcihp_skel_exit(void)
367{
368 /*
369 * Clean everything up.
370 */
371 cleanup_slots();
372}
373
374module_init(pcihp_skel_init);
375module_exit(pcihp_skel_exit);