1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * generic net pointers 4 */ 5 6 #ifndef __NET_GENERIC_H__ 7 #define __NET_GENERIC_H__ 8 9 #include <linux/bug.h> 10 #include <linux/rcupdate.h> 11 #include <net/net_namespace.h> 12 13 /* 14 * Generic net pointers are to be used by modules to put some private 15 * stuff on the struct net without explicit struct net modification 16 * 17 * The rules are simple: 18 * 1. set pernet_operations->id. After register_pernet_device you 19 * will have the id of your private pointer. 20 * 2. set pernet_operations->size to have the code allocate and free 21 * a private structure pointed to from struct net. 22 * 3. do not change this pointer while the net is alive; 23 * 4. do not try to have any private reference on the net_generic object. 24 * 25 * After accomplishing all of the above, the private pointer can be 26 * accessed with the net_generic() call. 27 */ 28 29 struct net_generic { 30 union { 31 struct { 32 unsigned int len; 33 struct rcu_head rcu; 34 } s; 35 36 DECLARE_FLEX_ARRAY(void *, ptr); 37 }; 38 }; 39 40 static inline void *net_generic(const struct net *net, unsigned int id) 41 { 42 struct net_generic *ng; 43 void *ptr; 44 45 rcu_read_lock(); 46 ng = rcu_dereference(net->gen); 47 ptr = ng->ptr[id]; 48 rcu_read_unlock(); 49 50 return ptr; 51 } 52 #endif 53