1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef S390_CCWGROUP_H
3 #define S390_CCWGROUP_H
4
5 struct ccw_device;
6 struct ccw_driver;
7
8 /**
9 * struct ccwgroup_device - ccw group device
10 * @state: online/offline state
11 * @count: number of attached slave devices
12 * @dev: embedded device structure
13 * @cdev: variable number of slave devices, allocated as needed
14 * @ungroup_work: work to be done when a ccwgroup notifier has action
15 * type %BUS_NOTIFY_UNBIND_DRIVER
16 */
17 struct ccwgroup_device {
18 enum {
19 CCWGROUP_OFFLINE,
20 CCWGROUP_ONLINE,
21 } state;
22 /* private: */
23 atomic_t onoff;
24 struct mutex reg_mutex;
25 /* public: */
26 unsigned int count;
27 struct device dev;
28 struct work_struct ungroup_work;
29 struct ccw_device *cdev[0];
30 };
31
32 /**
33 * struct ccwgroup_driver - driver for ccw group devices
34 * @setup: function called during device creation to setup the device
35 * @remove: function called on remove
36 * @set_online: function called when device is set online
37 * @set_offline: function called when device is set offline
38 * @shutdown: function called when device is shut down
39 * @prepare: prepare for pm state transition
40 * @complete: undo work done in @prepare
41 * @freeze: callback for freezing during hibernation snapshotting
42 * @thaw: undo work done in @freeze
43 * @restore: callback for restoring after hibernation
44 * @driver: embedded driver structure
45 * @ccw_driver: supported ccw_driver (optional)
46 */
47 struct ccwgroup_driver {
48 int (*setup) (struct ccwgroup_device *);
49 void (*remove) (struct ccwgroup_device *);
50 int (*set_online) (struct ccwgroup_device *);
51 int (*set_offline) (struct ccwgroup_device *);
52 void (*shutdown)(struct ccwgroup_device *);
53 int (*prepare) (struct ccwgroup_device *);
54 void (*complete) (struct ccwgroup_device *);
55 int (*freeze)(struct ccwgroup_device *);
56 int (*thaw) (struct ccwgroup_device *);
57 int (*restore)(struct ccwgroup_device *);
58
59 struct device_driver driver;
60 struct ccw_driver *ccw_driver;
61 };
62
63 extern int ccwgroup_driver_register (struct ccwgroup_driver *cdriver);
64 extern void ccwgroup_driver_unregister (struct ccwgroup_driver *cdriver);
65 int ccwgroup_create_dev(struct device *root, struct ccwgroup_driver *gdrv,
66 int num_devices, const char *buf);
67 struct ccwgroup_device *get_ccwgroupdev_by_busid(struct ccwgroup_driver *gdrv,
68 char *bus_id);
69
70 extern int ccwgroup_set_online(struct ccwgroup_device *gdev);
71 extern int ccwgroup_set_offline(struct ccwgroup_device *gdev);
72
73 extern int ccwgroup_probe_ccwdev(struct ccw_device *cdev);
74 extern void ccwgroup_remove_ccwdev(struct ccw_device *cdev);
75
76 #define to_ccwgroupdev(x) container_of((x), struct ccwgroup_device, dev)
77 #define to_ccwgroupdrv(x) container_of((x), struct ccwgroup_driver, driver)
78
79 #if IS_ENABLED(CONFIG_CCWGROUP)
80 bool dev_is_ccwgroup(struct device *dev);
81 #else /* CONFIG_CCWGROUP */
dev_is_ccwgroup(struct device * dev)82 static inline bool dev_is_ccwgroup(struct device *dev)
83 {
84 return false;
85 }
86 #endif /* CONFIG_CCWGROUP */
87
88 #endif
89
