1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * transport_class.h - a generic container for all transport classes 4 * 5 * Copyright (c) 2005 - James Bottomley <James.Bottomley@steeleye.com> 6 */ 7 8 #ifndef _TRANSPORT_CLASS_H_ 9 #define _TRANSPORT_CLASS_H_ 10 11 #include <linux/device.h> 12 #include <linux/bug.h> 13 #include <linux/attribute_container.h> 14 15 struct transport_container; 16 17 struct transport_class { 18 struct class class; 19 int (*setup)(struct transport_container *, struct device *, 20 struct device *); 21 int (*configure)(struct transport_container *, struct device *, 22 struct device *); 23 int (*remove)(struct transport_container *, struct device *, 24 struct device *); 25 }; 26 27 #define DECLARE_TRANSPORT_CLASS(cls, nm, su, rm, cfg) \ 28 struct transport_class cls = { \ 29 .class = { \ 30 .name = nm, \ 31 }, \ 32 .setup = su, \ 33 .remove = rm, \ 34 .configure = cfg, \ 35 } 36 37 38 struct anon_transport_class { 39 struct transport_class tclass; 40 struct attribute_container container; 41 }; 42 43 #define DECLARE_ANON_TRANSPORT_CLASS(cls, mtch, cfg) \ 44 struct anon_transport_class cls = { \ 45 .tclass = { \ 46 .configure = cfg, \ 47 }, \ 48 . container = { \ 49 .match = mtch, \ 50 }, \ 51 } 52 53 #define class_to_transport_class(x) \ 54 container_of(x, struct transport_class, class) 55 56 struct transport_container { 57 struct attribute_container ac; 58 const struct attribute_group *statistics; 59 const struct attribute_group *encryption; 60 }; 61 62 #define attribute_container_to_transport_container(x) \ 63 container_of(x, struct transport_container, ac) 64 65 void transport_remove_device(struct device *); 66 int transport_add_device(struct device *); 67 void transport_setup_device(struct device *); 68 void transport_configure_device(struct device *); 69 void transport_destroy_device(struct device *); 70 71 static inline int 72 transport_register_device(struct device *dev) 73 { 74 int ret; 75 76 transport_setup_device(dev); 77 ret = transport_add_device(dev); 78 if (ret) 79 transport_destroy_device(dev); 80 81 return ret; 82 } 83 84 static inline void 85 transport_unregister_device(struct device *dev) 86 { 87 transport_remove_device(dev); 88 transport_destroy_device(dev); 89 } 90 91 static inline void transport_container_register(struct transport_container *tc) 92 { 93 attribute_container_register(&tc->ac); 94 } 95 96 static inline void transport_container_unregister(struct transport_container *tc) 97 { 98 if (unlikely(attribute_container_unregister(&tc->ac))) 99 BUG(); 100 } 101 102 int transport_class_register(struct transport_class *); 103 void anon_transport_class_register(struct anon_transport_class *); 104 void transport_class_unregister(struct transport_class *); 105 void anon_transport_class_unregister(struct anon_transport_class *); 106 107 108 #endif 109