xref: /freebsd/sys/compat/linuxkpi/common/include/linux/kobject.h (revision c9e1c304c1f5553fb45f2851840cb6ee6e39243f)
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 struct kobj_type kfree_type;
50 
51 struct kobject {
52 	struct kobject		*parent;
53 	char			*name;
54 	struct kref		kref;
55 	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, 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 static inline void kobject_put(struct kobject *kobj);
87 void kobject_release(struct kref *kref);
88 
89 static inline void
90 kobject_put(struct kobject *kobj)
91 {
92 
93 	if (kobj)
94 		kref_put(&kobj->kref, kobject_release);
95 }
96 
97 static inline struct kobject *
98 kobject_get(struct kobject *kobj)
99 {
100 
101 	if (kobj)
102 		kref_get(&kobj->kref);
103 	return kobj;
104 }
105 
106 int	kobject_set_name_vargs(struct kobject *kobj, const char *fmt, va_list);
107 int	kobject_add(struct kobject *kobj, struct kobject *parent,
108 	    const char *fmt, ...);
109 
110 static inline struct kobject *
111 kobject_create(void)
112 {
113 	struct kobject *kobj;
114 
115 	kobj = kzalloc(sizeof(*kobj), GFP_KERNEL);
116 	if (kobj == NULL)
117 		return (NULL);
118 	kobject_init(kobj, &kfree_type);
119 
120 	return (kobj);
121 }
122 
123 static inline struct kobject *
124 kobject_create_and_add(const char *name, struct kobject *parent)
125 {
126 	struct kobject *kobj;
127 
128 	kobj = kobject_create();
129 	if (kobj == NULL)
130 		return (NULL);
131 	if (kobject_add(kobj, parent, "%s", name) == 0)
132 		return (kobj);
133 	kobject_put(kobj);
134 
135 	return (NULL);
136 }
137 
138 
139 static inline char *
140 kobject_name(const struct kobject *kobj)
141 {
142 
143 	return kobj->name;
144 }
145 
146 int	kobject_set_name(struct kobject *kobj, const char *fmt, ...);
147 int	kobject_init_and_add(struct kobject *kobj, struct kobj_type *ktype,
148 	    struct kobject *parent, const char *fmt, ...);
149 
150 #endif /* _LINUX_KOBJECT_H_ */
151