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