sysdev.h 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. /**
  2. * System devices follow a slightly different driver model.
  3. * They don't need to do dynammic driver binding, can't be probed,
  4. * and don't reside on any type of peripheral bus.
  5. * So, we represent and treat them a little differently.
  6. *
  7. * We still have a notion of a driver for a system device, because we still
  8. * want to perform basic operations on these devices.
  9. *
  10. * We also support auxillary drivers binding to devices of a certain class.
  11. *
  12. * This allows configurable drivers to register themselves for devices of
  13. * a certain type. And, it allows class definitions to reside in generic
  14. * code while arch-specific code can register specific drivers.
  15. *
  16. * Auxillary drivers registered with a NULL cls are registered as drivers
  17. * for all system devices, and get notification calls for each device.
  18. */
  19. #ifndef _SYSDEV_H_
  20. #define _SYSDEV_H_
  21. #include <linux/kobject.h>
  22. #include <linux/pm.h>
  23. struct sys_device;
  24. struct sysdev_class {
  25. struct list_head drivers;
  26. /* Default operations for these types of devices */
  27. int (*shutdown)(struct sys_device *);
  28. int (*suspend)(struct sys_device *, pm_message_t state);
  29. int (*resume)(struct sys_device *);
  30. struct kset kset;
  31. };
  32. struct sysdev_class_attribute {
  33. struct attribute attr;
  34. ssize_t (*show)(struct sysdev_class *, char *);
  35. ssize_t (*store)(struct sysdev_class *, const char *, size_t);
  36. };
  37. #define SYSDEV_CLASS_ATTR(_name,_mode,_show,_store) \
  38. struct sysdev_class_attribute attr_##_name = { \
  39. .attr = {.name = __stringify(_name), .mode = _mode }, \
  40. .show = _show, \
  41. .store = _store, \
  42. };
  43. extern int sysdev_class_register(struct sysdev_class *);
  44. extern void sysdev_class_unregister(struct sysdev_class *);
  45. extern int sysdev_class_create_file(struct sysdev_class *,
  46. struct sysdev_class_attribute *);
  47. extern void sysdev_class_remove_file(struct sysdev_class *,
  48. struct sysdev_class_attribute *);
  49. /**
  50. * Auxillary system device drivers.
  51. */
  52. struct sysdev_driver {
  53. struct list_head entry;
  54. int (*add)(struct sys_device *);
  55. int (*remove)(struct sys_device *);
  56. int (*shutdown)(struct sys_device *);
  57. int (*suspend)(struct sys_device *, pm_message_t state);
  58. int (*resume)(struct sys_device *);
  59. };
  60. extern int sysdev_driver_register(struct sysdev_class *, struct sysdev_driver *);
  61. extern void sysdev_driver_unregister(struct sysdev_class *, struct sysdev_driver *);
  62. /**
  63. * sys_devices can be simplified a lot from regular devices, because they're
  64. * simply not as versatile.
  65. */
  66. struct sys_device {
  67. u32 id;
  68. struct sysdev_class * cls;
  69. struct kobject kobj;
  70. };
  71. extern int sysdev_register(struct sys_device *);
  72. extern void sysdev_unregister(struct sys_device *);
  73. struct sysdev_attribute {
  74. struct attribute attr;
  75. ssize_t (*show)(struct sys_device *, char *);
  76. ssize_t (*store)(struct sys_device *, const char *, size_t);
  77. };
  78. #define _SYSDEV_ATTR(_name,_mode,_show,_store) \
  79. { \
  80. .attr = { .name = __stringify(_name), .mode = _mode, \
  81. .owner = THIS_MODULE }, \
  82. .show = _show, \
  83. .store = _store, \
  84. }
  85. #define SYSDEV_ATTR(_name,_mode,_show,_store) \
  86. struct sysdev_attribute attr_##_name = _SYSDEV_ATTR(_name,_mode,_show,_store);
  87. extern int sysdev_create_file(struct sys_device *, struct sysdev_attribute *);
  88. extern void sysdev_remove_file(struct sys_device *, struct sysdev_attribute *);
  89. #endif /* _SYSDEV_H_ */