xref: /freebsd/sys/compat/linuxkpi/common/include/linux/kobject.h (revision 4f0a4502a1f33fef287ac558c98e5ef99a32216f)
1 /*-
2  * Copyright (c) 2010 Isilon Systems, Inc.
3  * Copyright (c) 2010 iX Systems, Inc.
4  * Copyright (c) 2010 Panasas, Inc.
5  * Copyright (c) 2013, 2014 Mellanox Technologies, Ltd.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice unmodified, this list of conditions, and the following
13  *    disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  *
29  * $FreeBSD$
30  */
31 #ifndef	_LINUX_KOBJECT_H_
32 #define	_LINUX_KOBJECT_H_
33 
34 #include <machine/stdarg.h>
35 
36 #include <linux/kernel.h>
37 #include <linux/kref.h>
38 #include <linux/slab.h>
39 
40 struct kobject;
41 struct sysctl_oid;
42 
43 struct kobj_type {
44 	void (*release)(struct kobject *kobj);
45 	const struct sysfs_ops *sysfs_ops;
46 	struct attribute **default_attrs;
47 };
48 
49 extern const struct kobj_type linux_kfree_type;
50 
51 struct kobject {
52 	struct kobject		*parent;
53 	char			*name;
54 	struct kref		kref;
55 	const struct kobj_type	*ktype;
56 	struct list_head	entry;
57 	struct sysctl_oid	*oidp;
58 };
59 
60 extern struct kobject *mm_kobj;
61 
62 struct attribute {
63 	const char 	*name;
64 	struct module	*owner;
65 	mode_t		mode;
66 };
67 
68 struct kobj_attribute {
69         struct attribute attr;
70         ssize_t (*show)(struct kobject *kobj, struct kobj_attribute *attr,
71                         char *buf);
72         ssize_t (*store)(struct kobject *kobj, struct kobj_attribute *attr,
73                          const char *buf, size_t count);
74 };
75 
76 static inline void
77 kobject_init(struct kobject *kobj, const struct kobj_type *ktype)
78 {
79 
80 	kref_init(&kobj->kref);
81 	INIT_LIST_HEAD(&kobj->entry);
82 	kobj->ktype = ktype;
83 	kobj->oidp = NULL;
84 }
85 
86 void linux_kobject_release(struct kref *kref);
87 
88 static inline void
89 kobject_put(struct kobject *kobj)
90 {
91 
92 	if (kobj)
93 		kref_put(&kobj->kref, linux_kobject_release);
94 }
95 
96 static inline struct kobject *
97 kobject_get(struct kobject *kobj)
98 {
99 
100 	if (kobj)
101 		kref_get(&kobj->kref);
102 	return kobj;
103 }
104 
105 int	kobject_set_name_vargs(struct kobject *kobj, const char *fmt, va_list);
106 int	kobject_add(struct kobject *kobj, struct kobject *parent,
107 	    const char *fmt, ...);
108 
109 static inline struct kobject *
110 kobject_create(void)
111 {
112 	struct kobject *kobj;
113 
114 	kobj = kzalloc(sizeof(*kobj), GFP_KERNEL);
115 	if (kobj == NULL)
116 		return (NULL);
117 	kobject_init(kobj, &linux_kfree_type);
118 
119 	return (kobj);
120 }
121 
122 static inline struct kobject *
123 kobject_create_and_add(const char *name, struct kobject *parent)
124 {
125 	struct kobject *kobj;
126 
127 	kobj = kobject_create();
128 	if (kobj == NULL)
129 		return (NULL);
130 	if (kobject_add(kobj, parent, "%s", name) == 0)
131 		return (kobj);
132 	kobject_put(kobj);
133 
134 	return (NULL);
135 }
136 
137 static inline char *
138 kobject_name(const struct kobject *kobj)
139 {
140 
141 	return kobj->name;
142 }
143 
144 int	kobject_set_name(struct kobject *kobj, const char *fmt, ...);
145 int	kobject_init_and_add(struct kobject *kobj, const struct kobj_type *ktype,
146 	    struct kobject *parent, const char *fmt, ...);
147 
148 #endif /* _LINUX_KOBJECT_H_ */
149