xref: /linux-6.15/include/linux/kobject_ns.h (revision d9d16e16)
1 // SPDX-License-Identifier: GPL-2.0
2 /* Kernel object name space definitions
3  *
4  * Copyright (c) 2002-2003 Patrick Mochel
5  * Copyright (c) 2002-2003 Open Source Development Labs
6  * Copyright (c) 2006-2008 Greg Kroah-Hartman <[email protected]>
7  * Copyright (c) 2006-2008 Novell Inc.
8  *
9  * Split from kobject.h by David Howells ([email protected])
10  *
11  * This file is released under the GPLv2.
12  *
13  * Please read Documentation/kobject.txt before using the kobject
14  * interface, ESPECIALLY the parts about reference counts and object
15  * destructors.
16  */
17 
18 #ifndef _LINUX_KOBJECT_NS_H
19 #define _LINUX_KOBJECT_NS_H
20 
21 struct sock;
22 struct kobject;
23 
24 /*
25  * Namespace types which are used to tag kobjects and sysfs entries.
26  * Network namespace will likely be the first.
27  */
28 enum kobj_ns_type {
29 	KOBJ_NS_TYPE_NONE = 0,
30 	KOBJ_NS_TYPE_NET,
31 	KOBJ_NS_TYPES
32 };
33 
34 /*
35  * Callbacks so sysfs can determine namespaces
36  *   @grab_current_ns: return a new reference to calling task's namespace
37  *   @netlink_ns: return namespace to which a sock belongs (right?)
38  *   @initial_ns: return the initial namespace (i.e. init_net_ns)
39  *   @drop_ns: drops a reference to namespace
40  */
41 struct kobj_ns_type_operations {
42 	enum kobj_ns_type type;
43 	bool (*current_may_mount)(void);
44 	void *(*grab_current_ns)(void);
45 	const void *(*netlink_ns)(struct sock *sk);
46 	const void *(*initial_ns)(void);
47 	void (*drop_ns)(void *);
48 };
49 
50 int kobj_ns_type_register(const struct kobj_ns_type_operations *ops);
51 int kobj_ns_type_registered(enum kobj_ns_type type);
52 const struct kobj_ns_type_operations *kobj_child_ns_ops(struct kobject *parent);
53 const struct kobj_ns_type_operations *kobj_ns_ops(struct kobject *kobj);
54 
55 bool kobj_ns_current_may_mount(enum kobj_ns_type type);
56 void *kobj_ns_grab_current(enum kobj_ns_type type);
57 const void *kobj_ns_netlink(enum kobj_ns_type type, struct sock *sk);
58 const void *kobj_ns_initial(enum kobj_ns_type type);
59 void kobj_ns_drop(enum kobj_ns_type type, void *ns);
60 
61 #endif /* _LINUX_KOBJECT_NS_H */
62