generic.h 1.2 KB

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