LXR linux/arch/s390/include/asm/ccwgroup.h

   1/* SPDX-License-Identifier: GPL-2.0 */
   2#ifndef S390_CCWGROUP_H
   3#define S390_CCWGROUP_H
   4
   5struct ccw_device;
   6struct 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 */
  17struct 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 */
  47struct 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
  63extern int  ccwgroup_driver_register   (struct ccwgroup_driver *cdriver);
  64extern void ccwgroup_driver_unregister (struct ccwgroup_driver *cdriver);
  65int ccwgroup_create_dev(struct device *root, struct ccwgroup_driver *gdrv,
  66                        int num_devices, const char *buf);
  67struct ccwgroup_device *get_ccwgroupdev_by_busid(struct ccwgroup_driver *gdrv,
  68                                                 char *bus_id);
  69
  70extern int ccwgroup_set_online(struct ccwgroup_device *gdev);
  71extern int ccwgroup_set_offline(struct ccwgroup_device *gdev);
  72
  73extern int ccwgroup_probe_ccwdev(struct ccw_device *cdev);
  74extern 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)
  80bool dev_is_ccwgroup(struct device *dev);
  81#else /* CONFIG_CCWGROUP */
  82static inline bool dev_is_ccwgroup(struct device *dev)
  83{
  84        return false;
  85}
  86#endif /* CONFIG_CCWGROUP */
  87
  88#endif
  89