xref: /linux/arch/s390/include/asm/ccwgroup.h (revision b889fcf63cb62e7fdb7816565e28f44dbe4a76a5)
1 #ifndef S390_CCWGROUP_H
2 #define S390_CCWGROUP_H
3 
4 struct ccw_device;
5 struct ccw_driver;
6 
7 /**
8  * struct ccwgroup_device - ccw group device
9  * @state: online/offline state
10  * @count: number of attached slave devices
11  * @dev: embedded device structure
12  * @cdev: variable number of slave devices, allocated as needed
13  */
14 struct ccwgroup_device {
15 	enum {
16 		CCWGROUP_OFFLINE,
17 		CCWGROUP_ONLINE,
18 	} state;
19 /* private: */
20 	atomic_t onoff;
21 	struct mutex reg_mutex;
22 /* public: */
23 	unsigned int count;
24 	struct device	dev;
25 	struct ccw_device *cdev[0];
26 };
27 
28 /**
29  * struct ccwgroup_driver - driver for ccw group devices
30  * @setup: function called during device creation to setup the device
31  * @remove: function called on remove
32  * @set_online: function called when device is set online
33  * @set_offline: function called when device is set offline
34  * @shutdown: function called when device is shut down
35  * @prepare: prepare for pm state transition
36  * @complete: undo work done in @prepare
37  * @freeze: callback for freezing during hibernation snapshotting
38  * @thaw: undo work done in @freeze
39  * @restore: callback for restoring after hibernation
40  * @driver: embedded driver structure
41  */
42 struct ccwgroup_driver {
43 	int (*setup) (struct ccwgroup_device *);
44 	void (*remove) (struct ccwgroup_device *);
45 	int (*set_online) (struct ccwgroup_device *);
46 	int (*set_offline) (struct ccwgroup_device *);
47 	void (*shutdown)(struct ccwgroup_device *);
48 	int (*prepare) (struct ccwgroup_device *);
49 	void (*complete) (struct ccwgroup_device *);
50 	int (*freeze)(struct ccwgroup_device *);
51 	int (*thaw) (struct ccwgroup_device *);
52 	int (*restore)(struct ccwgroup_device *);
53 
54 	struct device_driver driver;
55 };
56 
57 extern int  ccwgroup_driver_register   (struct ccwgroup_driver *cdriver);
58 extern void ccwgroup_driver_unregister (struct ccwgroup_driver *cdriver);
59 int ccwgroup_create_dev(struct device *root, struct ccwgroup_driver *gdrv,
60 			int num_devices, const char *buf);
61 
62 extern int ccwgroup_set_online(struct ccwgroup_device *gdev);
63 extern int ccwgroup_set_offline(struct ccwgroup_device *gdev);
64 
65 extern int ccwgroup_probe_ccwdev(struct ccw_device *cdev);
66 extern void ccwgroup_remove_ccwdev(struct ccw_device *cdev);
67 
68 #define to_ccwgroupdev(x) container_of((x), struct ccwgroup_device, dev)
69 #define to_ccwgroupdrv(x) container_of((x), struct ccwgroup_driver, driver)
70 #endif
71